exonous 0.0.0-stage → 2.10.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +100 -2
- package/assets/THIRD-PARTY-NOTICES.md +29 -0
- package/assets/adapters/opencode/exonous.js +54 -0
- package/assets/agents/exo-backend.md +22 -0
- package/assets/agents/exo-cto.md +22 -0
- package/assets/agents/exo-data-ai.md +22 -0
- package/assets/agents/exo-designer.md +22 -0
- package/assets/agents/exo-devops.md +22 -0
- package/assets/agents/exo-frontend.md +22 -0
- package/assets/agents/exo-infra.md +22 -0
- package/assets/agents/exo-mobile.md +22 -0
- package/assets/agents/exo-pm.md +22 -0
- package/assets/agents/exo-qa.md +22 -0
- package/assets/agents/exo-researcher.md +22 -0
- package/assets/agents/exo-security.md +22 -0
- package/assets/agents/roster.json +209 -0
- package/assets/agents/taxis.js +189 -0
- package/assets/editors/cursor/frontend-skills.mdc +27 -0
- package/assets/editors/hooks/cursor/hooks.json +11 -0
- package/assets/machine/PR-TEMPLATE.md +21 -0
- package/assets/machine/hooks/anamnesis.cjs +61 -0
- package/assets/machine/hooks/ethos.cjs +48 -0
- package/assets/machine/hooks/kairos.cjs +46 -0
- package/assets/machine/hooks/lib/cli-options.cjs +133 -0
- package/assets/machine/hooks/lib/memory.cjs +488 -0
- package/assets/machine/hooks/lib/metron.cjs +52 -0
- package/assets/machine/hooks/lib/paths.cjs +99 -0
- package/assets/machine/hooks/lib/payload.cjs +81 -0
- package/assets/machine/hooks/lib/pr-template-validate.cjs +103 -0
- package/assets/machine/hooks/lib/release.cjs +58 -0
- package/assets/machine/hooks/lib/repo.cjs +138 -0
- package/assets/machine/hooks/lib/sanitize.cjs +37 -0
- package/assets/machine/hooks/lib/selfupdate.cjs +354 -0
- package/assets/machine/hooks/lib/shell.cjs +722 -0
- package/assets/machine/hooks/lib/template.cjs +70 -0
- package/assets/machine/hooks/lib/token.cjs +110 -0
- package/assets/machine/hooks/lib/validate-pr-body.cjs +21 -0
- package/assets/machine/hooks/pyle.cjs +302 -0
- package/assets/rules/nomos.md +59 -0
- package/assets/rules/praxis.md +38 -0
- package/assets/skills/code-review/SKILL.md +124 -0
- package/assets/skills/commit-changes/SKILL.md +49 -0
- package/assets/skills/deliver/SKILL.md +114 -0
- package/assets/skills/deliver/references/parallel.md +37 -0
- package/assets/skills/doc/SKILL.md +140 -0
- package/assets/skills/doc/doc.mjs +277 -0
- package/assets/skills/issue-board/SKILL.md +84 -0
- package/assets/skills/issue-board/board.mjs +389 -0
- package/assets/skills/issue-board/config.example.json +9 -0
- package/assets/skills/issue-board/render.py +189 -0
- package/assets/skills/make-pr/SKILL.md +24 -0
- package/assets/skills/native-ui/SKILL.md +67 -0
- package/assets/skills/native-ui/reference/apple.md +180 -0
- package/assets/skills/native-ui/reference/mobile-feel.md +221 -0
- package/assets/skills/native-ui/reference/swift.md +289 -0
- package/assets/skills/project-memory/SKILL.md +59 -0
- package/assets/skills/project-memory/config.example.json +4 -0
- package/assets/skills/project-memory/project-memory.mjs +478 -0
- package/assets/skills/security-review/SKILL.md +102 -0
- package/assets/skills/session-handoff/SKILL.md +23 -0
- package/assets/skills/session-handoff/config.example.json +3 -0
- package/assets/skills/ui-design/SKILL.md +75 -0
- package/assets/skills/ui-design/reference/adapt.md +151 -0
- package/assets/skills/ui-design/reference/adapt.native.md +35 -0
- package/assets/skills/ui-design/reference/android.md +50 -0
- package/assets/skills/ui-design/reference/animate.md +87 -0
- package/assets/skills/ui-design/reference/audit.md +76 -0
- package/assets/skills/ui-design/reference/audit.native.md +126 -0
- package/assets/skills/ui-design/reference/bolder.md +33 -0
- package/assets/skills/ui-design/reference/clarify.md +84 -0
- package/assets/skills/ui-design/reference/colorize.md +86 -0
- package/assets/skills/ui-design/reference/craft-floor.md +25 -0
- package/assets/skills/ui-design/reference/critique.md +345 -0
- package/assets/skills/ui-design/reference/degraded/asset-producer.md +35 -0
- package/assets/skills/ui-design/reference/degraded/documenter.md +23 -0
- package/assets/skills/ui-design/reference/degraded/finish-reviewer.md +43 -0
- package/assets/skills/ui-design/reference/degraded/manual-edit-applier.md +56 -0
- package/assets/skills/ui-design/reference/delight.md +63 -0
- package/assets/skills/ui-design/reference/distill.md +98 -0
- package/assets/skills/ui-design/reference/doctor.md +49 -0
- package/assets/skills/ui-design/reference/document.md +273 -0
- package/assets/skills/ui-design/reference/extract.md +52 -0
- package/assets/skills/ui-design/reference/harden.md +122 -0
- package/assets/skills/ui-design/reference/hooks.md +114 -0
- package/assets/skills/ui-design/reference/init.md +47 -0
- package/assets/skills/ui-design/reference/ios.md +55 -0
- package/assets/skills/ui-design/reference/layout.md +81 -0
- package/assets/skills/ui-design/reference/live-setup.md +75 -0
- package/assets/skills/ui-design/reference/live.md +326 -0
- package/assets/skills/ui-design/reference/new-work.md +350 -0
- package/assets/skills/ui-design/reference/onboard.md +85 -0
- package/assets/skills/ui-design/reference/operate.md +29 -0
- package/assets/skills/ui-design/reference/optimize.md +101 -0
- package/assets/skills/ui-design/reference/overdrive.md +83 -0
- package/assets/skills/ui-design/reference/polish.md +77 -0
- package/assets/skills/ui-design/reference/quieter.md +95 -0
- package/assets/skills/ui-design/reference/routing.md +37 -0
- package/assets/skills/ui-design/reference/shape.md +43 -0
- package/assets/skills/ui-design/reference/styles/brutalist.md +45 -0
- package/assets/skills/ui-design/reference/styles/design-md.md +70 -0
- package/assets/skills/ui-design/reference/styles/direction.md +95 -0
- package/assets/skills/ui-design/reference/styles/full-output.md +42 -0
- package/assets/skills/ui-design/reference/styles/minimalist.md +64 -0
- package/assets/skills/ui-design/reference/styles/premium.md +65 -0
- package/assets/skills/ui-design/reference/styles/redesign.md +59 -0
- package/assets/skills/ui-design/reference/typeset.md +73 -0
- package/assets/skills/ui-design/reference/visualize.md +156 -0
- package/assets/skills/ui-design/scripts/ENGINE-LICENSE +191 -0
- package/assets/skills/ui-design/scripts/VERSION +1 -0
- package/assets/skills/ui-design/scripts/bin/darwin-arm64/impeccable +0 -0
- package/assets/skills/ui-design/scripts/command-metadata.json +94 -0
- package/assets/skills/ui-design/scripts/data/font-index-failures.json +121 -0
- package/assets/skills/ui-design/scripts/data/font-index.json +1 -0
- package/assets/skills/ui-design/scripts/impeccable +206 -0
- package/assets/skills/ui-design/scripts/impeccable.cmd +214 -0
- package/assets/skills/ui-design/scripts/live-browser-dom.js +167 -0
- package/assets/skills/ui-design/scripts/live-browser-ignores.js +242 -0
- package/assets/skills/ui-design/scripts/live-browser-session.js +144 -0
- package/assets/skills/ui-design/scripts/live-browser.js +12990 -0
- package/assets/skills/ui-design/scripts/modern-screenshot.umd.js +14 -0
- package/assets/skills/ui-design/scripts/ui-design +6 -0
- package/assets/skills/ui-design/scripts/ui-design.cmd +3 -0
- package/assets/skills/ui-design/scripts/ui-design.mjs +124 -0
- package/assets/skills/ui-mockup/SKILL.md +68 -0
- package/assets/skills/ui-mockup/reference/brandkit.md +101 -0
- package/assets/skills/ui-mockup/reference/image-to-code.md +83 -0
- package/assets/skills/ui-mockup/reference/mobile-comps.md +94 -0
- package/assets/skills/ui-mockup/reference/web-comps.md +83 -0
- package/assets/skills/ui-motion/SKILL.md +112 -0
- package/assets/skills/ui-motion/reference/expo.md +224 -0
- package/assets/skills/ui-motion/reference/opportunities.md +81 -0
- package/assets/skills/ui-motion/reference/prototype.md +238 -0
- package/assets/skills/ui-motion/reference/review.md +163 -0
- package/assets/skills/ui-motion/reference/toasts.md +144 -0
- package/assets/skills/ui-motion/reference/ui-libraries.md +71 -0
- package/assets/skills/ui-motion/reference/vocabulary.md +130 -0
- package/assets/skills/ui-motion/reference/web.md +294 -0
- package/assets/skills/ui-patterns/SKILL.md +105 -0
- package/assets/skills/ui-patterns/references/stacks/html-tailwind.md +40 -0
- package/assets/skills/ui-patterns/references/stacks/nextjs.md +52 -0
- package/assets/skills/ui-patterns/references/stacks/nuxt.md +100 -0
- package/assets/skills/ui-patterns/references/stacks/react-native.md +48 -0
- package/assets/skills/ui-patterns/references/stacks/react.md +49 -0
- package/assets/skills/ui-patterns/references/stacks/shadcn.md +57 -0
- package/assets/skills/ui-patterns/references/stacks/vue.md +37 -0
- package/assets/techne/.claude-plugin/marketplace.json +31 -0
- package/assets/techne/.claude-plugin/plugin.json +24 -0
- package/assets/techne/.mcp.json +8 -0
- package/assets/techne/commands/build-fix.md +48 -0
- package/assets/techne/commands/refactor-clean.md +46 -0
- package/assets/techne/commands/test-coverage.md +42 -0
- package/assets/techne/hooks/hooks.json +49 -0
- package/assets/techne/rules/angular/coding-style.md +49 -0
- package/assets/techne/rules/angular/hooks.md +23 -0
- package/assets/techne/rules/angular/patterns.md +48 -0
- package/assets/techne/rules/angular/security.md +26 -0
- package/assets/techne/rules/angular/testing.md +46 -0
- package/assets/techne/rules/arkts/coding-style.md +63 -0
- package/assets/techne/rules/arkts/hooks.md +38 -0
- package/assets/techne/rules/arkts/patterns.md +42 -0
- package/assets/techne/rules/arkts/security.md +35 -0
- package/assets/techne/rules/arkts/testing.md +39 -0
- package/assets/techne/rules/common/agents.md +6 -0
- package/assets/techne/rules/common/code-review.md +15 -0
- package/assets/techne/rules/common/coding-style.md +13 -0
- package/assets/techne/rules/common/development-workflow.md +5 -0
- package/assets/techne/rules/common/git-workflow.md +30 -0
- package/assets/techne/rules/common/hooks.md +7 -0
- package/assets/techne/rules/common/patterns.md +3 -0
- package/assets/techne/rules/common/performance.md +3 -0
- package/assets/techne/rules/common/security.md +5 -0
- package/assets/techne/rules/common/testing.md +3 -0
- package/assets/techne/rules/cpp/coding-style.md +31 -0
- package/assets/techne/rules/cpp/hooks.md +26 -0
- package/assets/techne/rules/cpp/patterns.md +31 -0
- package/assets/techne/rules/cpp/security.md +37 -0
- package/assets/techne/rules/cpp/testing.md +31 -0
- package/assets/techne/rules/csharp/coding-style.md +30 -0
- package/assets/techne/rules/csharp/hooks.md +24 -0
- package/assets/techne/rules/csharp/patterns.md +28 -0
- package/assets/techne/rules/csharp/security.md +32 -0
- package/assets/techne/rules/csharp/testing.md +27 -0
- package/assets/techne/rules/dart/coding-style.md +47 -0
- package/assets/techne/rules/dart/hooks.md +26 -0
- package/assets/techne/rules/dart/patterns.md +38 -0
- package/assets/techne/rules/dart/security.md +44 -0
- package/assets/techne/rules/dart/testing.md +39 -0
- package/assets/techne/rules/fsharp/coding-style.md +34 -0
- package/assets/techne/rules/fsharp/hooks.md +25 -0
- package/assets/techne/rules/fsharp/patterns.md +43 -0
- package/assets/techne/rules/fsharp/security.md +32 -0
- package/assets/techne/rules/fsharp/testing.md +27 -0
- package/assets/techne/rules/golang/coding-style.md +30 -0
- package/assets/techne/rules/golang/hooks.md +17 -0
- package/assets/techne/rules/golang/patterns.md +43 -0
- package/assets/techne/rules/golang/security.md +33 -0
- package/assets/techne/rules/golang/testing.md +20 -0
- package/assets/techne/rules/java/coding-style.md +51 -0
- package/assets/techne/rules/java/hooks.md +18 -0
- package/assets/techne/rules/java/patterns.md +55 -0
- package/assets/techne/rules/java/security.md +33 -0
- package/assets/techne/rules/java/testing.md +33 -0
- package/assets/techne/rules/kotlin/coding-style.md +50 -0
- package/assets/techne/rules/kotlin/hooks.md +17 -0
- package/assets/techne/rules/kotlin/patterns.md +44 -0
- package/assets/techne/rules/kotlin/security.md +34 -0
- package/assets/techne/rules/kotlin/testing.md +38 -0
- package/assets/techne/rules/nuxt/coding-style.md +20 -0
- package/assets/techne/rules/nuxt/hooks.md +16 -0
- package/assets/techne/rules/nuxt/patterns.md +46 -0
- package/assets/techne/rules/nuxt/security.md +19 -0
- package/assets/techne/rules/nuxt/testing.md +15 -0
- package/assets/techne/rules/perl/coding-style.md +33 -0
- package/assets/techne/rules/perl/hooks.md +22 -0
- package/assets/techne/rules/perl/patterns.md +43 -0
- package/assets/techne/rules/perl/security.md +39 -0
- package/assets/techne/rules/perl/testing.md +42 -0
- package/assets/techne/rules/php/coding-style.md +30 -0
- package/assets/techne/rules/php/hooks.md +24 -0
- package/assets/techne/rules/php/patterns.md +26 -0
- package/assets/techne/rules/php/security.md +27 -0
- package/assets/techne/rules/php/testing.md +28 -0
- package/assets/techne/rules/python/coding-style.md +38 -0
- package/assets/techne/rules/python/fastapi.md +57 -0
- package/assets/techne/rules/python/hooks.md +19 -0
- package/assets/techne/rules/python/patterns.md +37 -0
- package/assets/techne/rules/python/security.md +26 -0
- package/assets/techne/rules/python/testing.md +32 -0
- package/assets/techne/rules/react/coding-style.md +24 -0
- package/assets/techne/rules/react/hooks.md +62 -0
- package/assets/techne/rules/react/patterns.md +48 -0
- package/assets/techne/rules/react/security.md +45 -0
- package/assets/techne/rules/react/testing.md +42 -0
- package/assets/techne/rules/react-native/accessibility.md +14 -0
- package/assets/techne/rules/react-native/coding-style.md +16 -0
- package/assets/techne/rules/react-native/hooks.md +16 -0
- package/assets/techne/rules/react-native/patterns.md +18 -0
- package/assets/techne/rules/react-native/performance.md +14 -0
- package/assets/techne/rules/react-native/production-readiness.md +16 -0
- package/assets/techne/rules/react-native/security.md +16 -0
- package/assets/techne/rules/react-native/testing.md +14 -0
- package/assets/techne/rules/ruby/coding-style.md +40 -0
- package/assets/techne/rules/ruby/hooks.md +33 -0
- package/assets/techne/rules/ruby/patterns.md +33 -0
- package/assets/techne/rules/ruby/security.md +39 -0
- package/assets/techne/rules/ruby/testing.md +35 -0
- package/assets/techne/rules/rust/coding-style.md +41 -0
- package/assets/techne/rules/rust/hooks.md +16 -0
- package/assets/techne/rules/rust/patterns.md +42 -0
- package/assets/techne/rules/rust/security.md +33 -0
- package/assets/techne/rules/rust/testing.md +30 -0
- package/assets/techne/rules/swift/coding-style.md +30 -0
- package/assets/techne/rules/swift/hooks.md +20 -0
- package/assets/techne/rules/swift/patterns.md +30 -0
- package/assets/techne/rules/swift/security.md +22 -0
- package/assets/techne/rules/swift/testing.md +28 -0
- package/assets/techne/rules/typescript/coding-style.md +38 -0
- package/assets/techne/rules/typescript/hooks.md +14 -0
- package/assets/techne/rules/typescript/patterns.md +12 -0
- package/assets/techne/rules/typescript/security.md +14 -0
- package/assets/techne/rules/typescript/testing.md +12 -0
- package/assets/techne/rules/vue/coding-style.md +19 -0
- package/assets/techne/rules/vue/hooks.md +13 -0
- package/assets/techne/rules/vue/patterns.md +29 -0
- package/assets/techne/rules/vue/security.md +11 -0
- package/assets/techne/rules/vue/testing.md +11 -0
- package/assets/techne/rules/web/coding-style.md +25 -0
- package/assets/techne/rules/web/design-quality.md +21 -0
- package/assets/techne/rules/web/hooks.md +39 -0
- package/assets/techne/rules/web/patterns.md +23 -0
- package/assets/techne/rules/web/performance.md +25 -0
- package/assets/techne/rules/web/security.md +23 -0
- package/assets/techne/rules/web/testing.md +21 -0
- package/assets/techne/scripts/hooks/config-guard.js +50 -0
- package/assets/techne/scripts/hooks/edit-tracker.js +26 -0
- package/assets/techne/scripts/hooks/lib/shell.js +204 -0
- package/assets/techne/scripts/hooks/no-verify-guard.js +205 -0
- package/assets/techne/scripts/hooks/run.js +92 -0
- package/assets/techne/scripts/hooks/stop-checks.js +136 -0
- package/assets/techne/skills/angular/SKILL.md +34 -0
- package/assets/techne/skills/angular/reference/components-and-templates.md +63 -0
- package/assets/techne/skills/angular/reference/dependency-injection.md +44 -0
- package/assets/techne/skills/angular/reference/forms.md +97 -0
- package/assets/techne/skills/angular/reference/routing.md +50 -0
- package/assets/techne/skills/angular/reference/signals-and-state.md +59 -0
- package/assets/techne/skills/angular/reference/styling-motion-a11y.md +54 -0
- package/assets/techne/skills/angular/reference/testing.md +52 -0
- package/assets/techne/skills/angular/reference/tooling.md +31 -0
- package/assets/techne/skills/cpp/SKILL.md +27 -0
- package/assets/techne/skills/cpp/reference/coding-standards.md +160 -0
- package/assets/techne/skills/databases/SKILL.md +35 -0
- package/assets/techne/skills/databases/reference/clickhouse.md +102 -0
- package/assets/techne/skills/databases/reference/migrations.md +94 -0
- package/assets/techne/skills/databases/reference/mysql.md +101 -0
- package/assets/techne/skills/databases/reference/postgres.md +72 -0
- package/assets/techne/skills/databases/reference/prisma.md +105 -0
- package/assets/techne/skills/databases/reference/redis.md +108 -0
- package/assets/techne/skills/delivery/SKILL.md +35 -0
- package/assets/techne/skills/delivery/reference/deployment-patterns.md +58 -0
- package/assets/techne/skills/delivery/reference/docker-patterns.md +77 -0
- package/assets/techne/skills/delivery/reference/git-workflow.md +64 -0
- package/assets/techne/skills/delivery/reference/github-ops.md +67 -0
- package/assets/techne/skills/delivery/reference/jira-integration.md +53 -0
- package/assets/techne/skills/delivery/reference/kubernetes-patterns.md +67 -0
- package/assets/techne/skills/dotnet/SKILL.md +27 -0
- package/assets/techne/skills/dotnet/reference/dotnet-core.md +131 -0
- package/assets/techne/skills/flutter/SKILL.md +29 -0
- package/assets/techne/skills/flutter/reference/code-review.md +76 -0
- package/assets/techne/skills/flutter/reference/patterns.md +201 -0
- package/assets/techne/skills/go/SKILL.md +28 -0
- package/assets/techne/skills/go/reference/patterns.md +87 -0
- package/assets/techne/skills/go/reference/testing.md +142 -0
- package/assets/techne/skills/java/SKILL.md +29 -0
- package/assets/techne/skills/java/reference/java-standards.md +117 -0
- package/assets/techne/skills/java/reference/springboot.md +108 -0
- package/assets/techne/skills/kotlin/SKILL.md +35 -0
- package/assets/techne/skills/kotlin/reference/android-clean-architecture.md +115 -0
- package/assets/techne/skills/kotlin/reference/compose-multiplatform-patterns.md +113 -0
- package/assets/techne/skills/kotlin/reference/kotlin-coroutines-flows.md +93 -0
- package/assets/techne/skills/kotlin/reference/kotlin-patterns.md +74 -0
- package/assets/techne/skills/kotlin/reference/kotlin-testing.md +115 -0
- package/assets/techne/skills/ml/SKILL.md +34 -0
- package/assets/techne/skills/ml/reference/ai-regression-testing.md +99 -0
- package/assets/techne/skills/ml/reference/cost-aware-llm-pipeline.md +133 -0
- package/assets/techne/skills/ml/reference/eval-harness.md +94 -0
- package/assets/techne/skills/ml/reference/mle-workflow.md +177 -0
- package/assets/techne/skills/ml/reference/prompt-optimizer.md +107 -0
- package/assets/techne/skills/ml/reference/pytorch-patterns.md +164 -0
- package/assets/techne/skills/php/SKILL.md +27 -0
- package/assets/techne/skills/php/reference/laravel.md +142 -0
- package/assets/techne/skills/python/SKILL.md +33 -0
- package/assets/techne/skills/python/reference/django.md +104 -0
- package/assets/techne/skills/python/reference/fastapi.md +118 -0
- package/assets/techne/skills/python/reference/python-core.md +88 -0
- package/assets/techne/skills/python/reference/python-testing.md +105 -0
- package/assets/techne/skills/quality/SKILL.md +34 -0
- package/assets/techne/skills/quality/reference/benchmark.md +55 -0
- package/assets/techne/skills/quality/reference/browser-qa.md +60 -0
- package/assets/techne/skills/quality/reference/coding-standards.md +88 -0
- package/assets/techne/skills/quality/reference/e2e-testing.md +99 -0
- package/assets/techne/skills/quality/reference/tdd-workflow.md +89 -0
- package/assets/techne/skills/quality/reference/verification-loop.md +80 -0
- package/assets/techne/skills/react/SKILL.md +30 -0
- package/assets/techne/skills/react/reference/nextjs-turbopack.md +42 -0
- package/assets/techne/skills/react/reference/react-patterns.md +139 -0
- package/assets/techne/skills/react/reference/react-performance.md +101 -0
- package/assets/techne/skills/react/reference/react-testing.md +139 -0
- package/assets/techne/skills/react-native/SKILL.md +28 -0
- package/assets/techne/skills/react-native/reference/expo-patterns.md +196 -0
- package/assets/techne/skills/research/SKILL.md +35 -0
- package/assets/techne/skills/research/reference/architecture-decision-records.md +65 -0
- package/assets/techne/skills/research/reference/codebase-onboarding.md +44 -0
- package/assets/techne/skills/research/reference/deep-research.md +50 -0
- package/assets/techne/skills/research/reference/iterative-retrieval.md +62 -0
- package/assets/techne/skills/research/reference/product-lens.md +38 -0
- package/assets/techne/skills/research/reference/search-first.md +50 -0
- package/assets/techne/skills/rust/SKILL.md +28 -0
- package/assets/techne/skills/rust/reference/patterns.md +108 -0
- package/assets/techne/skills/rust/reference/testing.md +142 -0
- package/assets/techne/skills/services/SKILL.md +32 -0
- package/assets/techne/skills/services/reference/api-contracts.md +139 -0
- package/assets/techne/skills/services/reference/backend-layers.md +95 -0
- package/assets/techne/skills/services/reference/errors-and-resilience.md +146 -0
- package/assets/techne/skills/services/reference/hexagonal-boundaries.md +93 -0
- package/assets/techne/skills/services/reference/mcp-servers.md +50 -0
- package/assets/techne/skills/services/reference/nestjs.md +96 -0
- package/assets/techne/skills/swift/SKILL.md +29 -0
- package/assets/techne/skills/swift/reference/concurrency.md +83 -0
- package/assets/techne/skills/swift/reference/swiftui.md +139 -0
- package/assets/techne/skills/vue/SKILL.md +29 -0
- package/assets/techne/skills/vue/reference/nuxt4-patterns.md +90 -0
- package/assets/techne/skills/vue/reference/ui-to-vue.md +90 -0
- package/assets/techne/skills/vue/reference/vue-patterns.md +151 -0
- package/assets/techne/skills/web/SKILL.md +30 -0
- package/assets/techne/skills/web/reference/bun-runtime.md +55 -0
- package/assets/techne/skills/web/reference/frontend-patterns.md +54 -0
- package/assets/techne/skills/web/reference/seo.md +77 -0
- package/assets/techne/skills/web/reference/vite-patterns.md +96 -0
- package/bin/native.cjs +30 -0
- package/native/aarch64-apple-darwin/exonous +0 -0
- package/native/aarch64-unknown-linux-gnu/exonous +0 -0
- package/native/x86_64-apple-darwin/exonous +0 -0
- package/native/x86_64-pc-windows-msvc/exonous.exe +0 -0
- package/native/x86_64-unknown-linux-gnu/exonous +0 -0
- package/package.json +1 -6
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
> **Prerequisite:** know the product’s allowed emotional range.
|
|
2
|
+
|
|
3
|
+
Earned personality at meaningful beats—not generic whimsy. Character shows up in useful interactions, humane copy, and considered details.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Visitor mode
|
|
8
|
+
|
|
9
|
+
- **Persuade + Experience:** voice, layout, motion, discovery may carry character if the artifact stays central.
|
|
10
|
+
- **Operate + Read:** invest charm in first use, completion, recovery, mastery; elsewhere optimize reliability.
|
|
11
|
+
|
|
12
|
+
## Spot the beat
|
|
13
|
+
|
|
14
|
+
Review target, DESIGN.md, voice, repeat frequency, emotional stakes:
|
|
15
|
+
|
|
16
|
+
- effort deserving acknowledgment;
|
|
17
|
+
- waits that can inform;
|
|
18
|
+
- empty/first-use moments that orient;
|
|
19
|
+
- errors needing empathy;
|
|
20
|
+
- interactions whose feedback could feel on-brand;
|
|
21
|
+
- capabilities worth discovering.
|
|
22
|
+
|
|
23
|
+
Skip celebrations for routine clicks. Ask when emotional range or stakes are unknown.
|
|
24
|
+
|
|
25
|
+
## One-line thesis
|
|
26
|
+
|
|
27
|
+
State what the user should feel and why it fits this product. Pick the smallest delivery:
|
|
28
|
+
|
|
29
|
+
- distinctive feedback on meaningful action;
|
|
30
|
+
- clarifying copy with voice;
|
|
31
|
+
- motion/material with recognizable behavior;
|
|
32
|
+
- illustration, sound, haptic, or environmental detail rooted in the world;
|
|
33
|
+
- discovery that exposes real utility.
|
|
34
|
+
|
|
35
|
+
Derive from mechanism and world—not a template library.
|
|
36
|
+
|
|
37
|
+
## Moment-by-moment
|
|
38
|
+
|
|
39
|
+
- **Success:** scale to effort; big wins may expand; routine saves stay quiet and sure.
|
|
40
|
+
- **Waiting:** honest progress or context—never fake latency for show.
|
|
41
|
+
- **Empty/first use:** clarify next step before ornament.
|
|
42
|
+
- **Errors:** problem + path forward first; warmth OK; no jokes on money, privacy, loss, or blocked work.
|
|
43
|
+
- **Repeat use:** still satisfying at high frequency; variation only if predictable.
|
|
44
|
+
- **Discovery:** curiosity rewarded; required paths stay obvious.
|
|
45
|
+
|
|
46
|
+
Use product vocabulary—generic whimsy loses to clear neutral copy.
|
|
47
|
+
|
|
48
|
+
## Guardrails
|
|
49
|
+
|
|
50
|
+
Must not: block primary tasks; break platform or a11y norms; invent facts; play audio without consent; force unskippable loops; add heavy deps for a small beat.
|
|
51
|
+
|
|
52
|
+
Authored motion → [animate.md](animate.md). Respect SR, keyboard, touch, i18n, culture. Stop decorative loops offscreen. Match intensity to frequency and stakes.
|
|
53
|
+
|
|
54
|
+
## Verify
|
|
55
|
+
|
|
56
|
+
- Another product couldn’t reuse unchanged.
|
|
57
|
+
- Helps comprehension, confidence, motivation, or recovery.
|
|
58
|
+
- Still fast and obvious without flourish.
|
|
59
|
+
- Repetition stays pleasant.
|
|
60
|
+
- Muted, keyboard, touch, i18n paths OK.
|
|
61
|
+
- Feels like the chosen world.
|
|
62
|
+
|
|
63
|
+
Then `/ui-design polish`.
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
Remove what does not earn its place: redundant UI, repeated information, decorative noise, cosmetic complexity.
|
|
2
|
+
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
## Assess
|
|
6
|
+
|
|
7
|
+
What makes it feel cluttered?
|
|
8
|
+
|
|
9
|
+
1. **Sources**
|
|
10
|
+
- competing controls, duplicate info, visual clutter;
|
|
11
|
+
- gratuitous color/font/size variation;
|
|
12
|
+
- everything visible—no progressive disclosure;
|
|
13
|
+
- borders, shadows, backgrounds without job;
|
|
14
|
+
- unclear priority;
|
|
15
|
+
- option overload, too many paths.
|
|
16
|
+
|
|
17
|
+
2. **Essence**
|
|
18
|
+
- single primary user goal;
|
|
19
|
+
- necessary vs nice-to-have;
|
|
20
|
+
- hide, remove, or merge candidates;
|
|
21
|
+
- the 20% that delivers 80%.
|
|
22
|
+
|
|
23
|
+
If unclear, STOP and AskUserQuestion.
|
|
24
|
+
|
|
25
|
+
**CRITICAL:** Simplicity removes obstacles to goals—not features by default. Every element must justify itself.
|
|
26
|
+
|
|
27
|
+
## Plan
|
|
28
|
+
|
|
29
|
+
- ONE outcome this surface must achieve;
|
|
30
|
+
- minimal elements to get there;
|
|
31
|
+
- what hides until needed;
|
|
32
|
+
- what merges or combines.
|
|
33
|
+
|
|
34
|
+
Simplification means saying no to good ideas for great execution.
|
|
35
|
+
|
|
36
|
+
## Simplify
|
|
37
|
+
|
|
38
|
+
### Information architecture
|
|
39
|
+
|
|
40
|
+
- Cut secondary actions, optional noise, repetition.
|
|
41
|
+
- Progressive disclosure: accordions, modals, steps.
|
|
42
|
+
- Merge similar actions; group related content.
|
|
43
|
+
- ONE primary action; few secondaries; rest tertiary or hidden.
|
|
44
|
+
- Say it once—no duplicate copy elsewhere.
|
|
45
|
+
|
|
46
|
+
### Visual
|
|
47
|
+
|
|
48
|
+
- 1–2 colors + neutrals, not a rainbow.
|
|
49
|
+
- One family; 3–4 sizes; 2–3 weights max.
|
|
50
|
+
- Drop decorative borders/shadows/backgrounds.
|
|
51
|
+
- Flatten nesting; no cards inside cards.
|
|
52
|
+
- Prefer spacing over card chrome.
|
|
53
|
+
- One spacing scale—no arbitrary gaps.
|
|
54
|
+
|
|
55
|
+
### Layout
|
|
56
|
+
|
|
57
|
+
- Simple vertical flow over complex grids when possible.
|
|
58
|
+
- Inline or hide sidebar content.
|
|
59
|
+
- Use width generously.
|
|
60
|
+
- Consistent alignment (left or center).
|
|
61
|
+
- Whitespace over packing.
|
|
62
|
+
|
|
63
|
+
### Interaction
|
|
64
|
+
|
|
65
|
+
- Fewer choices; clearer default path.
|
|
66
|
+
- Smart defaults; ask only when needed.
|
|
67
|
+
- Inline edit vs modal where viable.
|
|
68
|
+
- Remove a step if possible.
|
|
69
|
+
- ONE obvious next action.
|
|
70
|
+
|
|
71
|
+
### Content
|
|
72
|
+
|
|
73
|
+
- Halve copy twice where possible.
|
|
74
|
+
- Active voice.
|
|
75
|
+
- Plain language.
|
|
76
|
+
- Scannable structure.
|
|
77
|
+
- Essential facts only—no fluff, hedging, redundant headers.
|
|
78
|
+
|
|
79
|
+
### Code
|
|
80
|
+
|
|
81
|
+
- Dead CSS, unused components, orphans.
|
|
82
|
+
- Shallower component trees.
|
|
83
|
+
- Consolidated styles; consistent utilities.
|
|
84
|
+
- Fewer variants—3 often beat 12.
|
|
85
|
+
|
|
86
|
+
**NEVER:** strip needed functionality; hurt a11y; mystery minimalism; hide decision-critical info; erase all hierarchy; oversimplify genuinely complex domains.
|
|
87
|
+
|
|
88
|
+
## Verify
|
|
89
|
+
|
|
90
|
+
- Faster tasks?
|
|
91
|
+
- Lower cognitive load?
|
|
92
|
+
- Necessary features still reachable?
|
|
93
|
+
- Clear priority?
|
|
94
|
+
- Performance improved?
|
|
95
|
+
|
|
96
|
+
Document removed features: why, alternate access, feedback to watch.
|
|
97
|
+
|
|
98
|
+
Then `/ui-design polish`.
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Doctor
|
|
2
|
+
|
|
3
|
+
Report and repair drift between project **ui-design artifacts** and what the installed engine reads: `PRODUCT.md`, `DESIGN.md`, `.impeccable/design.json`, `.impeccable/config.json`, surface briefs, design hook.
|
|
4
|
+
|
|
5
|
+
Maintenance only—no redesign, no files outside the report, no other commands as side effects.
|
|
6
|
+
|
|
7
|
+
## Drift kinds
|
|
8
|
+
|
|
9
|
+
- **Tool version** — `UPDATE_AVAILABLE` from context; package maintainers own updates—not doctor.
|
|
10
|
+
- **Schema drift** — retired fields/locations; doctor `--fix` handles most.
|
|
11
|
+
- **Truth drift** — code moved on; `document` / `init` own updates; doctor surfaces gaps.
|
|
12
|
+
|
|
13
|
+
## Step 1: Run
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
<skill-dir>/scripts/ui-design doctor --json
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
`--target <path>` in monorepos when user named a workspace/route.
|
|
20
|
+
|
|
21
|
+
Output: `findings[]` (`id`, `artifact`, `path`, `severity`, `summary`, `fix`); optional `workspaces`. `ruleRegistryAvailable: false` → say ignored-rule validation was skipped.
|
|
22
|
+
|
|
23
|
+
Empty findings → one-line OK and stop.
|
|
24
|
+
|
|
25
|
+
## Step 2: Severities
|
|
26
|
+
|
|
27
|
+
- **`auto`** — run `doctor --fix` once without asking; report moves in one line
|
|
28
|
+
- **`mention`** — tell user; no decision now
|
|
29
|
+
- **`route`** — name command + gap; run only if user asks this turn
|
|
30
|
+
|
|
31
|
+
## Step 3: Deprecated fields
|
|
32
|
+
|
|
33
|
+
Deprecated sections (e.g. retired `## Register`) are **absent for decisions**—offer deletion.
|
|
34
|
+
|
|
35
|
+
## Step 4: Truth drift restraint
|
|
36
|
+
|
|
37
|
+
`design-md-drift` = commit count since DESIGN.md edit—not proof of wrong doc. Report number; if user wants truth, compare tokens/components manually.
|
|
38
|
+
|
|
39
|
+
`workspace-context-inherited` — behavior by design; multi-app fit is a user question.
|
|
40
|
+
|
|
41
|
+
## Monorepo notes
|
|
42
|
+
|
|
43
|
+
- **workspace-platform-native-evidence** — native files + inherited web `PRODUCT.md` → child `PRODUCT.md` with correct platform
|
|
44
|
+
- **config-project-roots-match-nothing** — report globs; ask intended roots
|
|
45
|
+
- **config-invalid-build-path** / **config-build-path-unset** — `buildPath` `comp`|`code` in engine state config; unset offer only when image generation exists
|
|
46
|
+
|
|
47
|
+
## Boot check opt-out
|
|
48
|
+
|
|
49
|
+
`"stalenessCheck": false` in `.impeccable/config.json` or `IMPECCABLE_NO_STALENESS_CHECK=1` for one session. Doctor still works when boot check off.
|
|
@@ -0,0 +1,273 @@
|
|
|
1
|
+
# Document
|
|
2
|
+
|
|
3
|
+
Produce root **`DESIGN.md`**: machine-readable tokens plus human guidance so new UI stays on-brand.
|
|
4
|
+
|
|
5
|
+
**Format:** optional YAML frontmatter (normative tokens) + up to eight markdown sections in fixed order. Prose explains usage; **frontmatter wins** on conflicts.
|
|
6
|
+
|
|
7
|
+
## Frontmatter schema
|
|
8
|
+
|
|
9
|
+
```yaml
|
|
10
|
+
---
|
|
11
|
+
name: <project title>
|
|
12
|
+
description: <one-line tagline>
|
|
13
|
+
colors:
|
|
14
|
+
primary: "#b8422e"
|
|
15
|
+
neutral-bg: "#faf7f2"
|
|
16
|
+
typography:
|
|
17
|
+
display:
|
|
18
|
+
fontFamily: "Cormorant Garamond, Georgia, serif"
|
|
19
|
+
fontSize: "clamp(2.5rem, 7vw, 4.5rem)"
|
|
20
|
+
fontWeight: 300
|
|
21
|
+
lineHeight: 1
|
|
22
|
+
rounded:
|
|
23
|
+
sm: "4px"
|
|
24
|
+
spacing:
|
|
25
|
+
md: "16px"
|
|
26
|
+
components:
|
|
27
|
+
button-primary:
|
|
28
|
+
backgroundColor: "{colors.primary}"
|
|
29
|
+
textColor: "{colors.neutral-bg}"
|
|
30
|
+
rounded: "{rounded.sm}"
|
|
31
|
+
padding: "16px 48px"
|
|
32
|
+
---
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
**Rules:**
|
|
36
|
+
|
|
37
|
+
- Token refs: `{colors.primary}`, `{rounded.md}` — components may reference primitives; primitives never reference each other.
|
|
38
|
+
- Colors: any valid CSS string; preserve incumbent `oklch()` / `hsl()` when normative.
|
|
39
|
+
- Component entries: max eight props — `backgroundColor`, `textColor`, `typography`, `rounded`, `padding`, `size`, `height`, `width`. Shadows, motion, focus rings → sidecar.
|
|
40
|
+
- Scale names follow the project (`oxblood-deep`, not forced Material names).
|
|
41
|
+
- Variants as sibling keys: `button-primary-hover`, etc.
|
|
42
|
+
|
|
43
|
+
## Body sections (exact headings, this order)
|
|
44
|
+
|
|
45
|
+
1. `## Overview` — north star metaphor, philosophy, key characteristics
|
|
46
|
+
2. `## Colors` — roles (primary/secondary/tertiary/neutral), named rules
|
|
47
|
+
3. `## Typography` — stacks, hierarchy, named rules
|
|
48
|
+
4. `## Layout` — grid, containers, rhythm, responsive behavior
|
|
49
|
+
5. `## Elevation & Depth` — shadows or tonal layering
|
|
50
|
+
6. `## Shapes` — radius, borders, silhouettes
|
|
51
|
+
7. `## Components` — per-component behavior and states
|
|
52
|
+
8. `## Do's and Don'ts` — durable guardrails
|
|
53
|
+
|
|
54
|
+
Omit empty sections; never rename headers tooling parses.
|
|
55
|
+
|
|
56
|
+
## When to run
|
|
57
|
+
|
|
58
|
+
- Coherent incumbent system, no `DESIGN.md`
|
|
59
|
+
- First build of a new world needs carbonizing
|
|
60
|
+
- Stale `DESIGN.md` vs code
|
|
61
|
+
- Pre-redesign snapshot
|
|
62
|
+
|
|
63
|
+
Existing file → show user; AskUserQuestion: refresh, overwrite, or merge.
|
|
64
|
+
|
|
65
|
+
## Paths
|
|
66
|
+
|
|
67
|
+
| Mode | When |
|
|
68
|
+
|------|------|
|
|
69
|
+
| **Scan** (default) | Tokens/components/rendered UI exist |
|
|
70
|
+
| **Seed** | Pre-code; needs `PRODUCT.md` + new-work workshop |
|
|
71
|
+
|
|
72
|
+
`/ui-design document --seed` runs workshop—it does **not** replace coherent code; identity replacement goes through new-work.
|
|
73
|
+
|
|
74
|
+
## Scan mode
|
|
75
|
+
|
|
76
|
+
### Step 1 · Discover assets (priority order)
|
|
77
|
+
|
|
78
|
+
1. **CSS variables** — grep `--color-`, `--font-`, `--spacing-`, `--radius-`, `--shadow-`, `--ease-`, `--duration-` in stylesheets; record name, value, defining file.
|
|
79
|
+
2. **Tailwind** — `tailwind.config.*` → `theme.extend` colors, fonts, spacing, radii, shadows.
|
|
80
|
+
3. **CSS-in-JS themes** — `theme.ts`, `tokens.ts`, etc.
|
|
81
|
+
4. **Token JSON** — Style Dictionary / W3C community formats.
|
|
82
|
+
5. **Component library** — button, card, input, nav, dialog variants.
|
|
83
|
+
6. **Global CSS** — base type and color assignments.
|
|
84
|
+
7. **Live sample** (optional) — computed styles on body, headings, links, buttons, cards.
|
|
85
|
+
|
|
86
|
+
### Step 2 · Structured draft
|
|
87
|
+
|
|
88
|
+
- **Colors:** primary/secondary/tertiary/neutral roles; omit empty roles.
|
|
89
|
+
- **Typography:** display/headline/title/body/label mapping + scale ratio.
|
|
90
|
+
- **Elevation:** shadow vocabulary or explicit flat/tonal system.
|
|
91
|
+
- **Components:** shape, color, hover/focus, padding per common primitive.
|
|
92
|
+
- **Layout / shapes:** grid, breakpoints, rhythm, radius language.
|
|
93
|
+
|
|
94
|
+
### Step 2b · Stage frontmatter
|
|
95
|
+
|
|
96
|
+
One slug per color; typography objects with real props only; component variants using `{token}` refs; overflow props → sidecar.
|
|
97
|
+
|
|
98
|
+
### Step 3 · Qualitative rounds
|
|
99
|
+
|
|
100
|
+
Two rounds, ≤3 questions each (wait between): Creative North Star metaphor; overview voice; descriptive color names; elevation philosophy; component feel. Pull from `PRODUCT.md` only binding brand constraints.
|
|
101
|
+
|
|
102
|
+
### Step 4 · Write DESIGN.md
|
|
103
|
+
|
|
104
|
+
Frontmatter + canonical sections. Use **Named Rules**: `**The [Name] Rule.**` one-line doctrine. Lead with descriptive language; put exact values in parentheses.
|
|
105
|
+
|
|
106
|
+
### Step 4b · Sidecar `.impeccable/design.json`
|
|
107
|
+
|
|
108
|
+
Extensions only — not a duplicate of frontmatter primitives.
|
|
109
|
+
|
|
110
|
+
```json
|
|
111
|
+
{
|
|
112
|
+
"schemaVersion": 2,
|
|
113
|
+
"generatedAt": "ISO-8601",
|
|
114
|
+
"title": "Design System: [Project Title]",
|
|
115
|
+
"extensions": {
|
|
116
|
+
"colorMeta": {
|
|
117
|
+
"primary": {
|
|
118
|
+
"role": "primary",
|
|
119
|
+
"displayName": "Editorial Magenta",
|
|
120
|
+
"canonical": "oklch(60% 0.25 350)",
|
|
121
|
+
"tonalRamp": ["...", "..."]
|
|
122
|
+
}
|
|
123
|
+
},
|
|
124
|
+
"typographyMeta": {
|
|
125
|
+
"display": { "displayName": "Display", "purpose": "Hero headlines only." }
|
|
126
|
+
},
|
|
127
|
+
"shadows": [
|
|
128
|
+
{ "name": "ambient-low", "value": "0 4px 24px rgba(0,0,0,0.12)", "purpose": "Hover glow under accents." }
|
|
129
|
+
],
|
|
130
|
+
"motion": [
|
|
131
|
+
{ "name": "ease-standard", "value": "cubic-bezier(0.4, 0, 0.2, 1)", "purpose": "Default transition easing." }
|
|
132
|
+
],
|
|
133
|
+
"breakpoints": [
|
|
134
|
+
{ "name": "sm", "value": "640px" }
|
|
135
|
+
]
|
|
136
|
+
},
|
|
137
|
+
"components": [
|
|
138
|
+
{
|
|
139
|
+
"name": "Primary Button",
|
|
140
|
+
"kind": "button",
|
|
141
|
+
"refersTo": "button-primary",
|
|
142
|
+
"description": "One-line when-to-use.",
|
|
143
|
+
"html": "<button class=\"ds-btn-primary\">SAVE</button>",
|
|
144
|
+
"css": ".ds-btn-primary { ... expanded literal CSS ... }"
|
|
145
|
+
}
|
|
146
|
+
],
|
|
147
|
+
"narrative": {
|
|
148
|
+
"northStar": "...",
|
|
149
|
+
"overview": "...",
|
|
150
|
+
"keyCharacteristics": ["..."],
|
|
151
|
+
"rules": [{ "name": "The One Voice Rule", "body": "...", "section": "colors" }],
|
|
152
|
+
"dos": ["Do ..."],
|
|
153
|
+
"donts": ["Don't ..."]
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
**schemaVersion 2:** primitives live in YAML frontmatter; sidecar holds ramps, shadows, motion, breakpoints, full HTML/CSS snippets, narrative mirror.
|
|
159
|
+
|
|
160
|
+
**Component snippet rules:** expand Tailwind to literal CSS; use `var(--token)` when tokens live on `:root`; inline SVG icons; include `:hover` and `:focus-visible`; prefix classes `ds-`; skip global resets.
|
|
161
|
+
|
|
162
|
+
Include **5–10** representative components; synthesize primitives on day-zero if needed. Tonal ramps ~8 steps OKLCH unless project defines a scale. Map narrative fields from DESIGN.md without rewording (panel copy).
|
|
163
|
+
|
|
164
|
+
Regenerate sidecar whenever DESIGN.md regenerates; refresh sidecar alone when user asks—keep DESIGN.md untouched.
|
|
165
|
+
|
|
166
|
+
### Step 5 · Confirm
|
|
167
|
+
|
|
168
|
+
Show DESIGN.md; note sidecar for live panel; offer section revisions.
|
|
169
|
+
|
|
170
|
+
## Seed mode
|
|
171
|
+
|
|
172
|
+
1. Missing `PRODUCT.md` → [init.md](init.md). Else [new-work.md](new-work.md) through world workshop + **Commit the world** for named first surface—stop at seed + surface brief.
|
|
173
|
+
2. Write seed with marker:
|
|
174
|
+
|
|
175
|
+
```markdown
|
|
176
|
+
<!-- SEED: established before implementation; re-run /ui-design document after code exists. -->
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
Minimal frontmatter (`name`, `description` only). Sections carry thesis; placeholders `[to be resolved during implementation]` for unknown tokens. **Components** omitted. No sidecar until scan.
|
|
180
|
+
|
|
181
|
+
3. Confirm seed status; user re-runs document after implementation.
|
|
182
|
+
|
|
183
|
+
## Section-by-section scan guidance
|
|
184
|
+
|
|
185
|
+
| Section | Capture |
|
|
186
|
+
|---------|---------|
|
|
187
|
+
| **Overview** | North star metaphor, 2–3 paragraphs on personality/density, **Key Characteristics** bullets, confirmed anti-references only |
|
|
188
|
+
| **Colors** | Role groups, descriptive names, where/why each swatch appears, optional **Named Rules** (≤10% accent doctrine, etc.) |
|
|
189
|
+
| **Typography** | Display/body/label stacks, hierarchy ladder with weights/sizes/line-height, measure guidance (e.g. 65–75ch body) |
|
|
190
|
+
| **Layout** | Grid model, max widths, breakpoint behavior, vertical rhythm—observed values in parentheses |
|
|
191
|
+
| **Elevation & Depth** | Shadow tokens or explicit flat/tonal strategy; shadow vocabulary list if applicable |
|
|
192
|
+
| **Shapes** | Radius language, borders, clipping habits, recurring silhouettes |
|
|
193
|
+
| **Components** | Buttons, inputs, nav, chips, cards—character line plus states (hover/focus/error) |
|
|
194
|
+
| **Do's and Don'ts** | Lead with **Do** / **Don't**; ground in incumbent code, not one-off page choices |
|
|
195
|
+
|
|
196
|
+
### Overview — writing template
|
|
197
|
+
|
|
198
|
+
Open with a metaphor that explains *why* the UI feels the way it does (studio bench, editorial desk, instrument panel). Follow with density stance (airy vs packed), motion temperament, and trust posture. **Key Characteristics** = 4–7 bullets a new contributor could verify in code. Anti-references only when the user or `PRODUCT.md` named them—never invent rival brands.
|
|
199
|
+
|
|
200
|
+
### Colors — writing template
|
|
201
|
+
|
|
202
|
+
Group swatches by **role**, not file order: primary action, secondary/support, neutrals (bg/surface/border), semantic (success/warn/danger). Give each swatch a **display name** in prose; park exact values in frontmatter or parentheses. Named Rules encode doctrine (`**The Restraint Rule.**` one sentence). Document dark-mode pairs when observed.
|
|
203
|
+
|
|
204
|
+
### Typography — writing template
|
|
205
|
+
|
|
206
|
+
Map roles: display, headline, title, body, label, mono (if any). For each: family stack, weight habit, size step, line-height, letter-spacing if distinctive. Note measure targets and when to avoid display faces in dense tables.
|
|
207
|
+
|
|
208
|
+
### Layout — writing template
|
|
209
|
+
|
|
210
|
+
Describe grid (columns, gutters, max content width), sticky regions, scroll behavior, and breakpoint flips. Quote observed spacing steps from `--spacing-*` or Tailwind scale. Call out full-bleed vs contained sections.
|
|
211
|
+
|
|
212
|
+
### Elevation & Depth — writing template
|
|
213
|
+
|
|
214
|
+
Either list shadow tokens with intent (hover vs modal) or declare a **flat/tonal** system using surface steps only. Sidecar `extensions.shadows` holds long values; prose explains when to use each tier.
|
|
215
|
+
|
|
216
|
+
### Shapes — writing template
|
|
217
|
+
|
|
218
|
+
Radius ladder (`--radius-*`), border weights, pill vs square buttons, clip habits. Tie shapes to brand metaphor where helpful.
|
|
219
|
+
|
|
220
|
+
### Components — writing template
|
|
221
|
+
|
|
222
|
+
One subsection per primitive: purpose, anatomy, default + hover + focus + disabled + error. Reference frontmatter keys (`button-primary`) instead of duplicating hex. Sidecar may carry expanded HTML/CSS snippets for live panel consumers.
|
|
223
|
+
|
|
224
|
+
### Do's and Don'ts — writing template
|
|
225
|
+
|
|
226
|
+
Minimum six lines, balanced. Each **Do** ties to an observed good pattern; each **Don't** blocks a regression you saw in code or critique—not hypothetical trends.
|
|
227
|
+
|
|
228
|
+
---
|
|
229
|
+
|
|
230
|
+
## Token discovery grep cheatsheet
|
|
231
|
+
|
|
232
|
+
When scanning CSS sources, prioritize prefixes (record file + line):
|
|
233
|
+
|
|
234
|
+
| Prefix | Typical meaning |
|
|
235
|
+
|--------|-----------------|
|
|
236
|
+
| `--color-*` | Semantic and brand fills |
|
|
237
|
+
| `--radius-*` | Corner language |
|
|
238
|
+
| `--spacing-*` | Rhythm scale |
|
|
239
|
+
| `--shadow-*` | Elevation |
|
|
240
|
+
| `--ease-*` | Motion curves |
|
|
241
|
+
| `--duration-*` | Transition timing |
|
|
242
|
+
| `--font-*` | Family/size shortcuts when present |
|
|
243
|
+
|
|
244
|
+
Tailwind: mine `theme.extend` for the same roles. CSS-in-JS: flatten nested theme objects into the frontmatter schema.
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
## Sidecar vs frontmatter split
|
|
249
|
+
|
|
250
|
+
| Lives in YAML frontmatter | Lives in `.impeccable/design.json` |
|
|
251
|
+
|---------------------------|-------------------------------------|
|
|
252
|
+
| Primitive colors, type scales, radii, spacing keys | Tonal ramps, extra shadow/motion/breakpoint entries |
|
|
253
|
+
| Up to 8 props per component variant | Full HTML/CSS exemplars, `refersTo` linkage |
|
|
254
|
+
| `{token}` references among components | `narrative` mirror (northStar, rules, dos/donts) |
|
|
255
|
+
|
|
256
|
+
Regenerate both together on full document runs; `--sidecar-only` refresh (user request) touches JSON without rewriting DESIGN.md body.
|
|
257
|
+
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
## Scan workflow timing
|
|
261
|
+
|
|
262
|
+
1. **Discover** — run grep/Tailwind/token JSON passes; dedupe by token name.
|
|
263
|
+
2. **Draft frontmatter** — primitives first, then component variants referencing them.
|
|
264
|
+
3. **Qualitative rounds** — two passes, ≤3 questions each; wait for answers between passes.
|
|
265
|
+
4. **Write DESIGN.md** — canonical section order; Named Rules where doctrine helps.
|
|
266
|
+
5. **Emit sidecar** — mirror narrative fields verbatim; expand components to literal CSS.
|
|
267
|
+
6. **Confirm** — show user both files; offer section-level revision loop.
|
|
268
|
+
|
|
269
|
+
On **seed** runs, stop after placeholder sections—no sidecar until a post-implementation scan replaces `[to be resolved…]` markers.
|
|
270
|
+
|
|
271
|
+
## Style & pitfalls
|
|
272
|
+
|
|
273
|
+
Frontmatter normative—no duplicate hex in prose. Named Rules 1–3 per section where useful. No raw class dumps. No top-level frontmatter groups for motion/breakpoints/shadows (sidecar only). Do not invent components; do not silently overwrite existing DESIGN.md. Do not rename canonical section headers.
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Extract flow
|
|
2
|
+
|
|
3
|
+
Find reusable patterns, tokens, and components; consolidate into the design system.
|
|
4
|
+
|
|
5
|
+
## Step 1: Locate the system
|
|
6
|
+
|
|
7
|
+
Find the component library or shared UI directory. Learn structure, naming, token layout, import conventions.
|
|
8
|
+
|
|
9
|
+
**No design system yet:** STOP—AskUserQuestion for preferred location/structure before creating one.
|
|
10
|
+
|
|
11
|
+
## Step 2: Spot candidates
|
|
12
|
+
|
|
13
|
+
In the target area:
|
|
14
|
+
|
|
15
|
+
- Components repeated 3+ times with same intent
|
|
16
|
+
- Hard-coded color, space, type, shadow → tokenize
|
|
17
|
+
- Inconsistent duplicates of one concept
|
|
18
|
+
- Repeated layout/interaction patterns
|
|
19
|
+
- Repeated type stacks or motion recipes
|
|
20
|
+
|
|
21
|
+
Extract only **3+ uses, same intent**. Premature abstraction loses.
|
|
22
|
+
|
|
23
|
+
## Step 3: Plan
|
|
24
|
+
|
|
25
|
+
- Components to extract; tokens to create; variants needed
|
|
26
|
+
- Names aligned with existing conventions
|
|
27
|
+
- Migration: how existing call sites switch over
|
|
28
|
+
|
|
29
|
+
Grow incrementally—clear wins now, not hypothetical futures.
|
|
30
|
+
|
|
31
|
+
## Step 4: Extract
|
|
32
|
+
|
|
33
|
+
- **Components:** clear props, variants, a11y (ARIA, keyboard, focus), brief usage notes
|
|
34
|
+
- **Tokens:** primitive vs semantic naming, documented when-to-use
|
|
35
|
+
- **Patterns:** when to apply, examples, variations
|
|
36
|
+
|
|
37
|
+
## Step 5: Migrate
|
|
38
|
+
|
|
39
|
+
Search instances; replace systematically; verify parity; delete dead implementations.
|
|
40
|
+
|
|
41
|
+
## Step 6: Document
|
|
42
|
+
|
|
43
|
+
Update library docs, token tables, Storybook/catalog if present.
|
|
44
|
+
|
|
45
|
+
## Never
|
|
46
|
+
|
|
47
|
+
- Extract one-offs without generalization
|
|
48
|
+
- Over-generic components
|
|
49
|
+
- Ignore existing conventions
|
|
50
|
+
- Skip types/prop docs
|
|
51
|
+
- Tokenize every literal
|
|
52
|
+
- Merge controls that differ in intent
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
Interfaces that only work with perfect demo data are not production-ready. Harden against real inputs, failures, locales, and networks.
|
|
2
|
+
|
|
3
|
+
## Assess needs
|
|
4
|
+
|
|
5
|
+
1. **Extreme inputs**
|
|
6
|
+
- very long/short/empty text;
|
|
7
|
+
- emoji, RTL, accents;
|
|
8
|
+
- huge numbers; 1000+ list items; 50+ options;
|
|
9
|
+
- empty datasets.
|
|
10
|
+
|
|
11
|
+
2. **Errors**
|
|
12
|
+
- offline, slow, timeout;
|
|
13
|
+
- API 400/401/403/404/500;
|
|
14
|
+
- validation, permission, rate limit;
|
|
15
|
+
- concurrent ops.
|
|
16
|
+
|
|
17
|
+
3. **i18n**
|
|
18
|
+
- long translations (~30% over English);
|
|
19
|
+
- RTL; CJK; emoji byte width;
|
|
20
|
+
- date/number/currency formats.
|
|
21
|
+
|
|
22
|
+
**CRITICAL:** Design for messy reality, not the happy path.
|
|
23
|
+
|
|
24
|
+
## Dimensions
|
|
25
|
+
|
|
26
|
+
### Text overflow
|
|
27
|
+
|
|
28
|
+
```css
|
|
29
|
+
.truncate {
|
|
30
|
+
overflow: hidden;
|
|
31
|
+
text-overflow: ellipsis;
|
|
32
|
+
white-space: nowrap;
|
|
33
|
+
}
|
|
34
|
+
.line-clamp {
|
|
35
|
+
display: -webkit-box;
|
|
36
|
+
-webkit-line-clamp: 3;
|
|
37
|
+
-webkit-box-orient: vertical;
|
|
38
|
+
overflow: hidden;
|
|
39
|
+
}
|
|
40
|
+
.wrap {
|
|
41
|
+
word-wrap: break-word;
|
|
42
|
+
overflow-wrap: break-word;
|
|
43
|
+
hyphens: auto;
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Flex/grid: `min-width: 0` (and `min-height: 0` on grid) so items can shrink.
|
|
48
|
+
|
|
49
|
+
Responsive type: `clamp()`; 16px body floor on mobile (14px only for truly secondary; iOS zooms focused inputs under 16px); test 200% zoom; containers grow with text.
|
|
50
|
+
|
|
51
|
+
### i18n
|
|
52
|
+
|
|
53
|
+
- Budget 30–40% extra space; flexible layouts; test German; avoid fixed text widths.
|
|
54
|
+
|
|
55
|
+
```jsx
|
|
56
|
+
// ❌ fixed width assumes short English
|
|
57
|
+
<button className="w-24">Submit</button>
|
|
58
|
+
// ✅ content-sized
|
|
59
|
+
<button className="px-4 py-2">Submit</button>
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
RTL: logical properties (`margin-inline-start`, `padding-inline`, `border-inline-end`) or `[dir="rtl"]` transforms.
|
|
63
|
+
|
|
64
|
+
UTF-8 everywhere; test CJK and emoji.
|
|
65
|
+
|
|
66
|
+
```javascript
|
|
67
|
+
new Intl.DateTimeFormat('de-DE').format(date);
|
|
68
|
+
new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' }).format(n);
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Pluralization via i18n library, not English-only string hacks.
|
|
72
|
+
|
|
73
|
+
### Errors
|
|
74
|
+
|
|
75
|
+
Network: clear message, retry, explain, offline mode if applicable.
|
|
76
|
+
|
|
77
|
+
Forms: inline errors, specific guidance, preserve input.
|
|
78
|
+
|
|
79
|
+
API: status-appropriate UX (400 validation, 401 login, 403 permission, 404 not found, 429 rate limit, 500 generic + support).
|
|
80
|
+
|
|
81
|
+
Graceful degradation: core path without JS where possible; alt text; progressive enhancement.
|
|
82
|
+
|
|
83
|
+
### Edge cases
|
|
84
|
+
|
|
85
|
+
Empty, loading (named operation, estimates), large data (pagination/virtual scroll), double-submit guards, race handling, optimistic rollback, permission states with explanation, browser feature detection + polyfills.
|
|
86
|
+
|
|
87
|
+
### Validation
|
|
88
|
+
|
|
89
|
+
Client hints + **always** server validate/sanitize; rate limits.
|
|
90
|
+
|
|
91
|
+
```html
|
|
92
|
+
<input maxlength="100" pattern="[A-Za-z0-9]+" required aria-describedby="username-hint" />
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### a11y resilience
|
|
96
|
+
|
|
97
|
+
Keyboard-complete flows; focus in modals; skip links; ARIA and live regions; high-contrast testing; non-color cues.
|
|
98
|
+
|
|
99
|
+
### Performance resilience
|
|
100
|
+
|
|
101
|
+
Slow net: progressive images, skeletons, optimistic UI, service workers.
|
|
102
|
+
|
|
103
|
+
Cleanup listeners, subscriptions, timers; abort fetches on unmount.
|
|
104
|
+
|
|
105
|
+
```javascript
|
|
106
|
+
const debouncedSearch = debounce(handleSearch, 300);
|
|
107
|
+
const throttledScroll = throttle(handleScroll, 100);
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
## Testing
|
|
111
|
+
|
|
112
|
+
Manual: extremes, locales, offline, 3G throttle, screen reader, keyboard-only, old browsers.
|
|
113
|
+
|
|
114
|
+
Automated: unit edge cases, integration errors, E2E critical paths, visual regression, axe/WAVE.
|
|
115
|
+
|
|
116
|
+
**NEVER:** assume perfect input; ignore i18n; generic “Error occurred”; forget offline; client-only validation; fixed text widths; English-length assumptions; whole UI blocked on one component error.
|
|
117
|
+
|
|
118
|
+
## Verify
|
|
119
|
+
|
|
120
|
+
100+ char names, emoji fields, RTL, CJK, throttled net, 1000+ rows, rapid double-submit, forced API errors, empty data.
|
|
121
|
+
|
|
122
|
+
Then `/ui-design polish`.
|