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,350 @@
|
|
|
1
|
+
# New visual work
|
|
2
|
+
|
|
3
|
+
This playbook covers **greenfield UI**, **major visual replacement**, and **full-page invention** inside an existing brand. Product facts live in `PRODUCT.md`; durable visual rules in `DESIGN.md`; route-specific strategy in the **surface brief**. No product file → run [init.md](init.md). Absent design file alone is **not** an automatic init redirect.
|
|
4
|
+
|
|
5
|
+
## 1 · Establish ground truth
|
|
6
|
+
|
|
7
|
+
Survey `DESIGN.md`, representative code, tokens, components, and assets.
|
|
8
|
+
|
|
9
|
+
| Situation | Stance |
|
|
10
|
+
|-----------|--------|
|
|
11
|
+
| **Redesign** | Keep truth, content, function, constraints, brand commitments; treat old look as anti-reference |
|
|
12
|
+
| **Established world** | Inherit; document incumbent identity instead of inventing |
|
|
13
|
+
| **Partial brand** | Preserve confirmed assets; expand with the user |
|
|
14
|
+
| **No authority** | Co-create a new world |
|
|
15
|
+
|
|
16
|
+
Local additions inherit their parent surface—never reboot identity for a small feature.
|
|
17
|
+
|
|
18
|
+
## 2 · Questions that move the build
|
|
19
|
+
|
|
20
|
+
Use the structured question tool when available; 2–3 focused questions or a tight confirmation. `DESIGN.md` fixes the world—not this surface’s purpose.
|
|
21
|
+
|
|
22
|
+
| Mode | Ask about |
|
|
23
|
+
|------|-----------|
|
|
24
|
+
| **Persuade** | Who acts, what proof earns belief, real assets |
|
|
25
|
+
| **Operate** | Task, states, frequency, constraints |
|
|
26
|
+
| **Read** | Reader goal, structure, wayfinding |
|
|
27
|
+
| **Experience** | What leads, exploration path, signature transition |
|
|
28
|
+
|
|
29
|
+
Always clarify success, must-not-touch areas, and what would feel wrong when polished. No CSS quizzes or canned aesthetic menus.
|
|
30
|
+
|
|
31
|
+
## 3 · Choose invention depth
|
|
32
|
+
|
|
33
|
+
### Extend an existing surface
|
|
34
|
+
|
|
35
|
+
Inherit world + composition. Resolve only new purpose, hierarchy, states, interaction, and join behavior. No concept tournament; no `DESIGN.md` edit without user approval of a system change.
|
|
36
|
+
|
|
37
|
+
### New whole surface (world already fixed)
|
|
38
|
+
|
|
39
|
+
Derive **5–7** structurally different layouts from content and behavior. For an open full page/flow:
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
<skill-dir>/scripts/ui-design concept-seed --scope surface --mode <mode>
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
The engine deals three structures for equal cards (kicker **THE ROLL**, steer, re-roll). With image gen + comp default (`.impeccable/config.json`), each card declares a comp under `.impeccable/mocks/decision/` per [visualize.md](visualize.md). Anchor identity via reference screenshot + structure-led prompt (`generate-image --ref`). Without images or under code-led default, cards carry `wireframe` schematics from:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
<skill-dir>/scripts/ui-design serve-question --schema
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Locked comp → comp-led with that comp as approved; locked wireframe → code-led via direction contract. Skip the script for narrow extensions.
|
|
52
|
+
|
|
53
|
+
### Create or replace the visual world
|
|
54
|
+
|
|
55
|
+
1. One sentence on mechanism, audience scene, cultural home, and what the first surface must prove—exclude category rut pages from the seven candidates.
|
|
56
|
+
2. List **seven** concrete visual systems/artifacts/places/rituals (≥3 material families; near-duplicates merge).
|
|
57
|
+
3. Fuse each into a full direction + first-surface expression.
|
|
58
|
+
4. **Mandatory roll** (no code before acknowledgment):
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
<skill-dir>/scripts/ui-design concept-seed --scope direction --mode <mode>
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Fuse challengers with product facts; verdict **wins / competitive / declined** on audience identification + product clarity; declined challengers donate one discipline as a named raise on the assigned direction.
|
|
65
|
+
5. Present assigned direction (raises visible), ≤3 full-card challengers, optional **director pick** card when assigned ≠ your top pick (never lead; never two picks), demoted declined row, re-roll registers (**plain / safer / bolder** via `--register` + `--reroll`), quiet **canon** exit, `buildPath` toggle when image gen exists.
|
|
66
|
+
|
|
67
|
+
**Decision page transport:**
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
<skill-dir>/scripts/ui-design serve-question --start --payload <file>
|
|
71
|
+
<skill-dir>/scripts/ui-design serve-question --wait --key <key>
|
|
72
|
+
# reroll loop:
|
|
73
|
+
<skill-dir>/scripts/ui-design concept-seed --scope direction --mode <mode> --from <seed-key> --reroll <n>
|
|
74
|
+
<skill-dir>/scripts/ui-design serve-question --update --key <same-key> --payload <file>
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Exit **4** → structured tool once, else unattended assigned direction (disclosed). Exit **2** from `--start` → structured tool fallback only.
|
|
78
|
+
|
|
79
|
+
**Reroll loop:** `ANSWER {"optionId":"reroll"}` keeps server alive—run `concept-seed` with same `--scope`/`--mode`, `--from <seed-key>`, `--reroll <n>` (increment n), rebuild payload, `serve-question --update --key <same> --payload <file>`, return to `--wait`. Never `--start` a second server.
|
|
80
|
+
|
|
81
|
+
**Canon exit:** category standard played straight—user’s door, never recommended. Taking canon → ask 2–3 reference products for craft bar; record preference in `PRODUCT.md` if standing.
|
|
82
|
+
|
|
83
|
+
**Pinned direction:** user/brief pins beat roll; translate material conflicts, do not re-roll for look mismatch alone.
|
|
84
|
+
|
|
85
|
+
**Image cards:** serve page first in least-sandboxed shell; comps generate in reading order (assigned → pick → hand → canon) with prompt sidecars; portrait frame for mobile/native-first, landscape for desktop; declined challengers skip comps. Parallel comps → **exo-designer** + [degraded/asset-producer.md](degraded/asset-producer.md) (≤4 in flight).
|
|
86
|
+
|
|
87
|
+
**buildPath:** read `.impeccable/config.json` (`.impeccable/config.local.json` overrides per machine). Default comp-led when image gen exists. Payload `buildPath: { "value": <default>, "toggle": true }`; ANSWER returns `buildPath` + `buildPathFlipped`. Mid-round flip to comp → `--wait` returns `BUILD PATH FLIPPED`; generate missing comps into declared paths then wait again. Record persistent default only when flip occurs on project with no stored `buildPath`—ask once after round closes.
|
|
88
|
+
|
|
89
|
+
## 4 · Commit the world
|
|
90
|
+
|
|
91
|
+
Color strategies: **Restrained** · **Committed** (30–60% field color) · **Full palette** · **Drenched**. Pick light/dark from a one-sentence physical scene—not defaults.
|
|
92
|
+
|
|
93
|
+
Typefaces should come from the subject’s world; overused “AI default” faces need explicit justification beyond category association.
|
|
94
|
+
|
|
95
|
+
Self-check: if the aesthetic is guessable from category alone, rework. Brief negatives forbid devices, not energy.
|
|
96
|
+
|
|
97
|
+
**Mode delivery checks:** **Persuade** — offer + action readable in form’s vocabulary within seconds. **Operate** — task/state/affordance never obscured. **Read** — comprehension + wayfinding intact. **Experience** — artifact leads from first viewport.
|
|
98
|
+
|
|
99
|
+
**Viability before roll:** true claims, real palette family, distinctive composition, full-surface scale within perf budget. Synthetic demo content OK when labeled; never invent prices, customers, capabilities, or endpoints.
|
|
100
|
+
|
|
101
|
+
## 5 · Record before code
|
|
102
|
+
|
|
103
|
+
Write **direction contract** under `## Direction contract` in the surface brief—six blocks (~150 words each):
|
|
104
|
+
|
|
105
|
+
| Block | Content |
|
|
106
|
+
|-------|---------|
|
|
107
|
+
| **THESIS** | Idea this surface owns; default arrangement it refuses |
|
|
108
|
+
| **OWN-WORLD** | Palette + component language recognizable without content |
|
|
109
|
+
| **STORY** | What visitor understands, believes, does |
|
|
110
|
+
| **FIRST VIEWPORT** | Composition, scale, primary action placement |
|
|
111
|
+
| **FORM** | Chosen form, list position, seed key from roll |
|
|
112
|
+
| **FINISH** | Verbatim: `unreviewed and undocumented is unfinished; this build ends with the finish review, the verdict, DESIGN.md, and every shipping raster carrying its provenance` |
|
|
113
|
+
|
|
114
|
+
Never embed the contract in shipped HTML/JSX/metadata.
|
|
115
|
+
|
|
116
|
+
New/replacement worlds: write `DESIGN.md` at **finish** via documenter—not pre-build. Extensions skip global `DESIGN.md` rewrites.
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
<skill-dir>/scripts/ui-design surface-brief read <primary-target>
|
|
120
|
+
<skill-dir>/scripts/ui-design surface-brief write <primary-target> <body-file> [related-target...]
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
Verify six blocks + seed key before building. Comp-led → [visualize.md](visualize.md) three-option round unless decision comp already approved. `shape` stops before persistence.
|
|
124
|
+
## 6 · Build with full commitment
|
|
125
|
+
|
|
126
|
+
Ship the assigned direction—not a timid reinterpretation. Rebuild nav, controls, and links in the chosen form’s vocabulary; stock components inside a committed form are lapses.
|
|
127
|
+
|
|
128
|
+
### Comp-led state machine
|
|
129
|
+
|
|
130
|
+
Start once (roll output names exact flags):
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
<skill-dir>/scripts/ui-design build-phase start --direction <seed-key> --kind <assigned|pick|challenger|canon>
|
|
134
|
+
# or when comp already approved:
|
|
135
|
+
<skill-dir>/scripts/ui-design build-phase start --comp <approved-comp>
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
Advance only through open gates:
|
|
139
|
+
|
|
140
|
+
```bash
|
|
141
|
+
<skill-dir>/scripts/ui-design build-phase advance
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
Exit **2** → gate failed (read message, fix, advance again). Do not write later phases while an earlier gate is open.
|
|
145
|
+
|
|
146
|
+
| Phase | Gate work |
|
|
147
|
+
|-------|-----------|
|
|
148
|
+
| **comps** | Three comps under `.impeccable/mocks/` + sidecar `"approved": true` ([visualize.md](visualize.md)); `start --comp` skips |
|
|
149
|
+
| **spec** | Measure comp (below) |
|
|
150
|
+
| **plates** | Raster regions before any page code |
|
|
151
|
+
| **hero** | First viewport at comp dimensions + diff gate |
|
|
152
|
+
| **sections** | Remainder in spec system |
|
|
153
|
+
| **motion** | Signature interaction once |
|
|
154
|
+
| **responsive** | Desktop 1280–1600 + mobile captures |
|
|
155
|
+
|
|
156
|
+
**Comp-led capacity note:** measured build holds layout numbers, plate boxes, and numeric hero diff across many attempts—frontier-tier work. If the active model tends to stall at ~recognizable pages, disclose before the direction round and prefer **code-led**, or expect hero gate failure with readings unmet.
|
|
157
|
+
|
|
158
|
+
**Phase discipline:** exit code **2** from any engine verb means the open gate failed—read stderr, fix, rerun **that** phase work, then `build-phase advance` again. Never author **sections**, **motion**, or **responsive** assets while **spec**, **plates**, or **hero** gates remain open.
|
|
159
|
+
|
|
160
|
+
**spec phase commands:**
|
|
161
|
+
|
|
162
|
+
```bash
|
|
163
|
+
<skill-dir>/scripts/ui-design comp-spec --comp <comp> --grid
|
|
164
|
+
<skill-dir>/scripts/ui-design comp-spec --comp <comp> --regions <regions-file>
|
|
165
|
+
<skill-dir>/scripts/ui-design comp-spec --print
|
|
166
|
+
<skill-dir>/scripts/ui-design font-match --measure <text-region-id>
|
|
167
|
+
<skill-dir>/scripts/ui-design font-match --rank <region-id> --text "..." [--candidates <faces...>]
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
Regions file: kinds `plate` / `image` / `texture` for painted ink; `text` / `control` / `chrome` for code; every region has `note`. Oversized text regions must split. `--snap` behavior and explicit `box` as documented by engine.
|
|
171
|
+
|
|
172
|
+
**Spec gate rules (engine-enforced, paraphrased):**
|
|
173
|
+
|
|
174
|
+
- Every visible ink blob gets a region; unnamed comp material is refused.
|
|
175
|
+
- `text` / `control` / `chrome` larger than ~¼ of comp area must decompose into inner regions (columns are not single elements).
|
|
176
|
+
- Notes describing painted illustration/photo/texture under a code kind → reclassify as raster kind or rewrite note.
|
|
177
|
+
- Lead text region must be **measured** and **ranked** via `font-match`; never hand-write `chosen` faces into spec.
|
|
178
|
+
- Icon-sized SVG only under ~64px and few paths; diagrams, notation, leader art → plates.
|
|
179
|
+
- Spec is exhaustive: no invented borders/chrome absent from comp except font substitution, icon glyph substitution, and comp typos flagged as defects.
|
|
180
|
+
- Plate boxes must contain full artwork (`bleed: true` only when page truly crops there).
|
|
181
|
+
|
|
182
|
+
**Output artifact:** `.impeccable/build/spec.json` — authoritative for hero scaffold, diff, and polish advisories.
|
|
183
|
+
|
|
184
|
+
**plates phase commands:**
|
|
185
|
+
|
|
186
|
+
```bash
|
|
187
|
+
<skill-dir>/scripts/ui-design comp-spec --crop <region-id>
|
|
188
|
+
<skill-dir>/scripts/ui-design comp-spec --plate-prompt <region-id> --background transparent
|
|
189
|
+
<skill-dir>/scripts/ui-design comp-spec --plate-prompt <region-id> --background opaque
|
|
190
|
+
<skill-dir>/scripts/ui-design generate-image --ref <crop.png> --prompt-file <prompt.txt> --out <plate.png> --size <WxH> --quality high --background transparent
|
|
191
|
+
<skill-dir>/scripts/ui-design embed-prompt <plate> --prompt-file <prompt.txt>
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
Parallel plates → **exo-designer** + [degraded/asset-producer.md](degraded/asset-producer.md). Comp crop is reference only—not shipping pixels. `--force` only when user downgrades comp authority (quote reason).
|
|
195
|
+
|
|
196
|
+
**hero phase commands:**
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
<skill-dir>/scripts/ui-design build-phase scaffold
|
|
200
|
+
<skill-dir>/scripts/ui-design build-phase record hero
|
|
201
|
+
<skill-dir>/scripts/ui-design comp-diff --comp <comp> --build <capture> --spec <spec.json> --out-dir .impeccable/review/diff/hero/
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
Scaffold writes `.impeccable/build/scaffold/layout.css` with `--r-<id>-x/y/w/h` (and measured type). Hero gate ~**72%** overall match with no hard vetoes (missing region, contradicted plate/text, SVG illustration posing as plate, clipped plate, invented ink). `comp-diff` writes side-by-side, heatmap, paired crops, `report.json` under `.impeccable/review/diff/hero/`. Advisories quote numeric deltas (cap height, line count, weight, ink color, chrome height). On failure, open listed region crops in order: `missing` → add material; `contradicted` → re-derive structure; `drift` → size/spacing edits. Gate refuses a third attempt that only nudges the same region without structural change.
|
|
205
|
+
|
|
206
|
+
**Plate rules recap:** comp crop never ships; plates ≥1.5× region size; page code waits for plates gate—CSS-drawn material before plates exist is invalid. Icon-sized SVG (<64px, few paths) OK; diagrams/notation must be plates. Callout lines belong to plate; labels stay text. `--force` on gates only with user-quoted comp downgrade in `--reason`.
|
|
207
|
+
|
|
208
|
+
**responsive captures:** `desktop.png` (1440 full page), `mobile.png` (390) under `.impeccable/review/`.
|
|
209
|
+
|
|
210
|
+
### Code-led
|
|
211
|
+
|
|
212
|
+
No comp required; finish reviewer audits **FIRST VIEWPORT** + signature interaction. Decision comp may ride as critique reference only.
|
|
213
|
+
|
|
214
|
+
### Shared build rules
|
|
215
|
+
|
|
216
|
+
First viewport demonstrates mechanism—not generic hero shell. Prove with demonstration; author assets; build named techniques (canvas, WebGL, view transitions) for real; pace scroll density; verify imagery URLs; orchestrate motion once. Preserve a11y, performance, semantics, project conventions.
|
|
217
|
+
|
|
218
|
+
## 7 · Inspect and finish
|
|
219
|
+
|
|
220
|
+
One batched screenshot round (web desktop+mobile; native device classes; add user viewport width when harness reports it). Two rounds max; batch fixes. Comp-led final diff:
|
|
221
|
+
|
|
222
|
+
```bash
|
|
223
|
+
<skill-dir>/scripts/ui-design comp-diff --comp <approved-comp> --build .impeccable/review/desktop.png --spec .impeccable/build/spec.json --out-dir .impeccable/review/diff/final
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
Validate captures (motion settled, full page, correct dimensions). Hookless web: `<skill-dir>/scripts/ui-design detect --json` on changed targets once before handoff. Native: no HTML detector—say so in reviewer packet.
|
|
227
|
+
|
|
228
|
+
Screenshots → `.impeccable/review/` (`desktop.png`, `mobile.png`, `user-<w>.png`, native per class).
|
|
229
|
+
|
|
230
|
+
Spawn **exo-designer** + [degraded/finish-reviewer.md](degraded/finish-reviewer.md) with request, contract, artifact path, screenshots, hook findings, QUALITY BAR paths, comp/spec/diff paths, craft-floor path, platform refs. Fresh subagent, no forked transcript; one long wait; respawn once if empty. No subagents → in-thread degraded brief (disclose).
|
|
231
|
+
|
|
232
|
+
Dispositions: **recapture** · **rebuild** · **ship** · **fix** (verdict pass on listed fixes; two unattended verdict rounds max).
|
|
233
|
+
|
|
234
|
+
Before fix/rebuild return to reviewer:
|
|
235
|
+
|
|
236
|
+
```bash
|
|
237
|
+
<skill-dir>/scripts/ui-design embed-prompt --scan <asset-dir...>
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
Then **exo-designer** + [degraded/documenter.md](degraded/documenter.md): new worlds need token `DESIGN.md` **and** `.impeccable/design.json`. Manual edits from review → [degraded/manual-edit-applier.md](degraded/manual-edit-applier.md) when available.
|
|
241
|
+
|
|
242
|
+
## Engine CLI quick reference
|
|
243
|
+
|
|
244
|
+
All via `<skill-dir>/scripts/ui-design <verb>`. Common flags:
|
|
245
|
+
|
|
246
|
+
| Verb | Flags / notes |
|
|
247
|
+
|------|----------------|
|
|
248
|
+
| `concept-seed` | `--scope surface\|direction`, `--mode`, `--from`, `--reroll`, `--register` |
|
|
249
|
+
| `serve-question` | `--start`, `--wait`, `--key`, `--update`, `--payload`, `--schema` |
|
|
250
|
+
| `build-phase` | `start --direction`, `start --comp`, `advance`, `scaffold`, `record hero` |
|
|
251
|
+
| `comp-spec` | `--comp`, `--grid`, `--regions`, `--print`, `--crop`, `--plate-prompt`, `--background transparent\|opaque` |
|
|
252
|
+
| `comp-diff` | `--comp`, `--build`, `--spec`, `--out-dir` |
|
|
253
|
+
| `font-match` | `--measure`, `--rank`, `--text`, `--candidates` |
|
|
254
|
+
| `generate-image` | `--ref`, `--prompt-file`, `--out`, `--size`, `--quality`, `--background` |
|
|
255
|
+
| `embed-prompt` | `<image>`, `--prompt`, `--prompt-file`, `--read`, `--scan` |
|
|
256
|
+
| `detect` | `--json`, targets |
|
|
257
|
+
| `surface-brief` | `read`, `write` |
|
|
258
|
+
|
|
259
|
+
Scaffold layout vars: `--r-<id>-x`, `--r-<id>-y`, `--r-<id>-w`, `--r-<id>-h` plus measured cap height, font-size, family, weight.
|
|
260
|
+
|
|
261
|
+
---
|
|
262
|
+
|
|
263
|
+
## Decision page payload & flow
|
|
264
|
+
|
|
265
|
+
Build JSON payload files for `<skill-dir>/scripts/ui-design serve-question`:
|
|
266
|
+
|
|
267
|
+
1. **`--schema`** — dump wireframe card schema when image gen unavailable.
|
|
268
|
+
2. **`--start --payload <file>`** — boots local decision server; exit **2** → fall back to structured AskUserQuestion once.
|
|
269
|
+
3. **`--wait --key <key>`** — blocks until ANSWER; preserve **same key** across rerolls.
|
|
270
|
+
4. **`--update --key <key> --payload <file>`** — replace cards after reroll without second `--start`.
|
|
271
|
+
|
|
272
|
+
**ANSWER handling highlights:**
|
|
273
|
+
|
|
274
|
+
| `optionId` | Parent action |
|
|
275
|
+
|------------|----------------|
|
|
276
|
+
| assigned / pick / challenger / canon | Record seed key + kind; run printed `build-phase start` |
|
|
277
|
+
| `reroll` | `concept-seed --from <seed-key> --reroll <n>` then `--update` payload |
|
|
278
|
+
| safer / bolder steers | Use `--register` lines from seed output when present |
|
|
279
|
+
| `buildPath` toggle | Honor flip: generate missing comps if switched to comp-led mid-round |
|
|
280
|
+
|
|
281
|
+
Exit **4** from `--wait` → one structured tool attempt, else proceed on assigned direction with disclosure.
|
|
282
|
+
|
|
283
|
+
**Image card order:** assigned → director pick → hand challengers → canon (canon comp only if user selects canon). Declined challengers skip comp generation. Serve page in least-sandboxed shell before generating images.
|
|
284
|
+
|
|
285
|
+
---
|
|
286
|
+
|
|
287
|
+
## Sections · motion · responsive (gates 4–6)
|
|
288
|
+
|
|
289
|
+
**sections** — Extend surface using spec palette, corner language, and line weights only; regions absent from comp inherit the recorded system—do not freestyle new chrome families.
|
|
290
|
+
|
|
291
|
+
**motion** — One orchestrated signature (scroll reveals, hero mechanism, primary transition)—not scattered hovers. Respect reduced-motion preferences in shipping code.
|
|
292
|
+
|
|
293
|
+
**responsive** — Fluid columns; no fixed grid that breaks ~100px below comp width. Captures:
|
|
294
|
+
|
|
295
|
+
| File | Spec |
|
|
296
|
+
|------|------|
|
|
297
|
+
| `desktop.png` | 1440px wide, full page, under `.impeccable/review/` |
|
|
298
|
+
| `mobile.png` | 390px wide, full page |
|
|
299
|
+
| `user-<w>.png` | When harness reports user viewport |
|
|
300
|
+
|
|
301
|
+
Gate compares desktop first viewport to comp—not only exact comp pixel width. Mobile-first comps were portrait; plates target that frame.
|
|
302
|
+
|
|
303
|
+
---
|
|
304
|
+
|
|
305
|
+
## Finish dispositions (expanded)
|
|
306
|
+
|
|
307
|
+
| Word | Meaning | Next step |
|
|
308
|
+
|------|---------|-----------|
|
|
309
|
+
| **recapture** | Evidence invalid (blank, motion-hidden, wrong crop) | Re-shoot listed views; full review again |
|
|
310
|
+
| **rebuild** | Wholesale fidelity failure | Re-derive named regions/assets; fresh full review (not verdict-only) |
|
|
311
|
+
| **ship** | Verdict clean at stated scope | Documenter handoff |
|
|
312
|
+
| **fix** | Bounded patch list | Batch edits → rebuild once → recapture → **verdict pass** on listed fixes only |
|
|
313
|
+
|
|
314
|
+
Verdict pass caps at **two unattended rounds**; user may fund more when attended. Reviewer findings are the sole fix list—no parallel self-audit. User-supplied screenshot contradicting your capture → fresh reviewer with their evidence.
|
|
315
|
+
|
|
316
|
+
**Raster hygiene on fix/rebuild:** embed prompts via `--scan` on asset dirs; delete abandoned rasters in same batch; never delete files scan flagged as missing metadata without embedding first.
|
|
317
|
+
|
|
318
|
+
---
|
|
319
|
+
|
|
320
|
+
## Engine flags (complete reference)
|
|
321
|
+
|
|
322
|
+
| Verb | Flags |
|
|
323
|
+
|------|-------|
|
|
324
|
+
| `concept-seed` | `--scope surface\|direction`, `--mode <mode>`, `--from <seed-key>`, `--reroll <n>`, `--register <steer>` |
|
|
325
|
+
| `serve-question` | `--start`, `--wait`, `--key`, `--update`, `--payload <file>`, `--schema` |
|
|
326
|
+
| `build-phase` | `start --direction`, `start --comp`, `advance`, `scaffold`, `record hero` |
|
|
327
|
+
| `comp-spec` | `--comp`, `--grid`, `--regions`, `--print`, `--crop`, `--plate-prompt`, `--background transparent\|opaque`, `--force`, `--reason` |
|
|
328
|
+
| `comp-diff` | `--comp`, `--build`, `--spec`, `--out-dir` |
|
|
329
|
+
| `font-match` | `--measure <region>`, `--rank <region>`, `--text "..."`, `--candidates <faces...>` |
|
|
330
|
+
| `generate-image` | `--ref`, `--prompt`, `--prompt-file`, `--out`, `--out-dir`, `--size`, `--quality`, `--background`, `--crop`, `--plate-prompt`, `--direction`, `--kind` |
|
|
331
|
+
| `embed-prompt` | `<image>`, `--prompt`, `--prompt-file`, `--read`, `--scan`, `--ref`, `--size`, `--quality`, `--out` |
|
|
332
|
+
| `detect` | `--json`, markup paths |
|
|
333
|
+
| `surface-brief` | `read`, `write` |
|
|
334
|
+
|
|
335
|
+
**Hero scaffold CSS variables:** `--r-<id>-x`, `--r-<id>-y`, `--r-<id>-w`, `--r-<id>-h`, plus measured typography tokens per text region.
|
|
336
|
+
|
|
337
|
+
---
|
|
338
|
+
|
|
339
|
+
## Reading `comp-diff` output
|
|
340
|
+
|
|
341
|
+
Hero and final diffs emit under `.impeccable/review/diff/<phase>/`:
|
|
342
|
+
|
|
343
|
+
| Artifact | Use |
|
|
344
|
+
|----------|-----|
|
|
345
|
+
| Side-by-side PNG | Human sanity check; not sufficient alone |
|
|
346
|
+
| Heatmap | Shows spatial drift clusters |
|
|
347
|
+
| Per-region crop pairs | Open in listed order on failure |
|
|
348
|
+
| `report.json` | Machine scores: overall %, veto flags, per-region status |
|
|
349
|
+
|
|
350
|
+
Region statuses drive edits: **`missing`** → add element/plate; **`contradicted`** → rebuild structure from spec box; **`drift`** → numeric spacing/type tweaks. Advisories after pass (cap height delta, line count, ink color, chrome height) feed polish before responsive—not excuses to skip hero rework when veto bits are set.
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
> **Gather:** the first “worth it” moment and typical user skill level.
|
|
2
|
+
|
|
3
|
+
Reach first value fast. Onboarding is not a product course—it proves the product is worth the user’s time.
|
|
4
|
+
|
|
5
|
+
## Assess
|
|
6
|
+
|
|
7
|
+
1. **Challenge**
|
|
8
|
+
- user goal;
|
|
9
|
+
- confusion or drop-off points;
|
|
10
|
+
- target “aha” moment.
|
|
11
|
+
|
|
12
|
+
2. **Users**
|
|
13
|
+
- skill level; motivation; time budget; prior tools/competitors.
|
|
14
|
+
|
|
15
|
+
3. **Success**
|
|
16
|
+
- minimum learning for success;
|
|
17
|
+
- key first action;
|
|
18
|
+
- metrics: completion, time-to-value.
|
|
19
|
+
|
|
20
|
+
**CRITICAL:** Shortest path to value—not exhaustive teaching.
|
|
21
|
+
|
|
22
|
+
## Principles
|
|
23
|
+
|
|
24
|
+
### Show, don’t tell
|
|
25
|
+
Working examples in real UI; progressive disclosure; one concept at a time.
|
|
26
|
+
|
|
27
|
+
### Optional when possible
|
|
28
|
+
Skip for experts; never block the product; clear “explore on my own.”
|
|
29
|
+
|
|
30
|
+
### Time to value
|
|
31
|
+
Front-load the 20% that delivers 80%; defer advanced features to context.
|
|
32
|
+
|
|
33
|
+
### Context over ceremony
|
|
34
|
+
Teach when needed; empty states as teachable moments; point-of-use hints.
|
|
35
|
+
|
|
36
|
+
### Respect intelligence
|
|
37
|
+
Concise; assume standard pattern literacy.
|
|
38
|
+
|
|
39
|
+
## Patterns
|
|
40
|
+
|
|
41
|
+
### First run
|
|
42
|
+
- Welcome: value prop, honest time estimate, skip.
|
|
43
|
+
- Setup: minimal fields, explain asks, defaults, social login when fit.
|
|
44
|
+
- Concepts: 1–3 core ideas, interactive, progress (e.g. step 1 of 3).
|
|
45
|
+
- First win: real accomplishment, templates, light celebration, next steps.
|
|
46
|
+
|
|
47
|
+
### Discovery
|
|
48
|
+
- **Empty states:** what appears here, why it matters, CTA, template option.
|
|
49
|
+
- **Tooltips:** first encounter, point at control, dismiss + “don’t show again,” optional learn-more.
|
|
50
|
+
- **Announcements:** new features, try now, dismissable.
|
|
51
|
+
- **Progressive:** teach on encounter; badge unused features; unlock complexity gradually.
|
|
52
|
+
|
|
53
|
+
### Tours (complex UIs, big changes, domain-heavy tools)
|
|
54
|
+
- Spotlight; 3–7 steps; free navigation; skip; replay from help.
|
|
55
|
+
- Interactive real controls; workflow-focused copy; sample data.
|
|
56
|
+
|
|
57
|
+
### Tutorials (hands-on practice, high stakes)
|
|
58
|
+
- Sandbox data; clear objective; steps; validation; graduation.
|
|
59
|
+
|
|
60
|
+
### Help
|
|
61
|
+
Contextual `?`, shortcuts, searchable docs, videos for hard flows.
|
|
62
|
+
|
|
63
|
+
## Empty states need
|
|
64
|
+
|
|
65
|
+
What will appear; why it matters; how to start (CTA/template); visual interest; optional short tutorial link.
|
|
66
|
+
|
|
67
|
+
Types: first use, user cleared, no results, no permission, load failure.
|
|
68
|
+
|
|
69
|
+
## Implementation notes
|
|
70
|
+
|
|
71
|
+
Libraries: Tippy/Popper, Intro/Shepherd/Joyride; focus-trap modals; localStorage for seen state; analytics on completion/drop-off.
|
|
72
|
+
|
|
73
|
+
```javascript
|
|
74
|
+
localStorage.setItem('onboarding-completed', 'true');
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Track dismissals—never repeat ignored onboarding.
|
|
78
|
+
|
|
79
|
+
**NEVER:** long blocking tours; patronizing copy; repeat tooltips; full UI block during tour; disconnected tutorial mode; upfront overload; hidden skip; re-show initial onboarding to returners.
|
|
80
|
+
|
|
81
|
+
## Verify
|
|
82
|
+
|
|
83
|
+
Completion time, comprehension, next action taken, skip rate, completion rate, time-to-value.
|
|
84
|
+
|
|
85
|
+
Then `/ui-design polish`.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Operate depth (+ Read crossovers)
|
|
2
|
+
|
|
3
|
+
Task-first surfaces: apps, admin, settings, dense tables, authenticated tools. Pair with SKILL.md **Operate** mode and the craft floor. **Read** mode docs lean on measure, nav, and type rhythm here—density matters less than clarity.
|
|
4
|
+
|
|
5
|
+
## Trust test
|
|
6
|
+
|
|
7
|
+
Users fluent in the category should never pause at alien controls. Decorative chrome, mixed control families, or motion without state meaning breaks trust faster than flat layout.
|
|
8
|
+
|
|
9
|
+
## Type in product chrome
|
|
10
|
+
|
|
11
|
+
Single sans stack is normal. Step sizes ~1.125–1.2 rem—not marketing fluid clamps. Prose blocks ~65–75ch; data grids may widen.
|
|
12
|
+
|
|
13
|
+
## Color in product chrome
|
|
14
|
+
|
|
15
|
+
Bias **Restrained** palettes; occasional **Committed** fields (report accent, onboarding splash). Map full semantic states. Accent marks primary action + selection—not wallpaper. Secondary neutral for rails/panels.
|
|
16
|
+
|
|
17
|
+
## Layout & motion
|
|
18
|
+
|
|
19
|
+
Breakpoints reshape structure (nav collapse, table modes)—not display fluid type. Transitions ~150–250ms, state-only, no staged page entrances.
|
|
20
|
+
|
|
21
|
+
## Components
|
|
22
|
+
|
|
23
|
+
Ship complete state matrices; skeleton placeholders; teaching empty states; portals/`dialog`/popover for overlays escaping scroll clipping.
|
|
24
|
+
|
|
25
|
+
## Don't / Do
|
|
26
|
+
|
|
27
|
+
Avoid display type on controls, novelty scrollbars, modal-first flows, mismatched buttons, idle saturated chrome.
|
|
28
|
+
|
|
29
|
+
Do use familiar nav idioms, justified density, cross-screen consistency—delight only at earned moments.
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
Performance is a feature. Find **this** interface’s bottleneck, fix it, measure—don’t tune what isn’t slow.
|
|
2
|
+
|
|
3
|
+
## Assess
|
|
4
|
+
|
|
5
|
+
1. **Measure now**
|
|
6
|
+
- Core Web Vitals: LCP, INP, CLS
|
|
7
|
+
- Load: TTI, FCP
|
|
8
|
+
- Bundle: JS, CSS, images
|
|
9
|
+
- Runtime: FPS, memory, CPU
|
|
10
|
+
- Network: request count, payloads, waterfall
|
|
11
|
+
|
|
12
|
+
2. **Bottlenecks**
|
|
13
|
+
- What’s slow (load, interaction, animation)?
|
|
14
|
+
- Cause (images, JS, layout thrash)?
|
|
15
|
+
- Severity and who’s affected?
|
|
16
|
+
|
|
17
|
+
**CRITICAL:** Before/after metrics. Optimize what matters.
|
|
18
|
+
|
|
19
|
+
## Strategy
|
|
20
|
+
|
|
21
|
+
### Loading
|
|
22
|
+
|
|
23
|
+
**Images:** WebP/AVIF; right dimensions; lazy below fold; `srcset`/`picture`; ~80–85% quality; CDN.
|
|
24
|
+
|
|
25
|
+
```html
|
|
26
|
+
<img src="hero.webp" srcset="hero-400.webp 400w, hero-800.webp 800w, hero-1200.webp 1200w"
|
|
27
|
+
sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px" loading="lazy" alt="Hero" />
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
**JS:** code split; tree-shake; drop unused deps; dynamic import heavy pieces.
|
|
31
|
+
|
|
32
|
+
```javascript
|
|
33
|
+
const HeavyChart = lazy(() => import('./HeavyChart'));
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**CSS:** purge unused; critical inline; contain independent regions.
|
|
37
|
+
|
|
38
|
+
**Fonts:** `font-display: swap|optional`; subset; preload critical; system fonts when OK; limit weights.
|
|
39
|
+
|
|
40
|
+
```css
|
|
41
|
+
@font-face {
|
|
42
|
+
font-family: 'CustomFont';
|
|
43
|
+
src: url('/fonts/custom.woff2') format('woff2');
|
|
44
|
+
font-display: swap;
|
|
45
|
+
unicode-range: U+0020-007F;
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
**Loading order:** critical first; async/defer rest; preload; prefetch next routes; service worker; HTTP/2+.
|
|
50
|
+
|
|
51
|
+
### Rendering
|
|
52
|
+
|
|
53
|
+
Batch DOM reads then writes—avoid layout thrash.
|
|
54
|
+
|
|
55
|
+
Use `contain`; flatter/shallower DOM; `content-visibility: auto`; virtual lists for huge sets.
|
|
56
|
+
|
|
57
|
+
Prefer `transform`/`opacity` for motion; avoid animating layout drivers; sparse `will-change`; isolate expensive paint.
|
|
58
|
+
|
|
59
|
+
### Animation
|
|
60
|
+
|
|
61
|
+
60fps (~16ms/frame); `requestAnimationFrame`; debounce/throttle scroll; CSS when possible.
|
|
62
|
+
|
|
63
|
+
Intersection Observer for lazy animate/load.
|
|
64
|
+
|
|
65
|
+
### Frameworks
|
|
66
|
+
|
|
67
|
+
React: `memo`, `useMemo`/`useCallback`, virtualize, split routes, avoid inline fns in hot render—profile.
|
|
68
|
+
|
|
69
|
+
Generally: fewer re-renders; debounce expensive work; memoize; lazy routes/components.
|
|
70
|
+
|
|
71
|
+
### Network
|
|
72
|
+
|
|
73
|
+
Fewer requests; sprite SVG icons; inline tiny critical assets; drop dead third parties.
|
|
74
|
+
|
|
75
|
+
APIs: pagination; GraphQL selective fields; gzip/brotli; cache headers; CDN.
|
|
76
|
+
|
|
77
|
+
Slow nets: adaptive loading (`navigator.connection`); optimistic UI; prioritization.
|
|
78
|
+
|
|
79
|
+
## Core Web Vitals
|
|
80
|
+
|
|
81
|
+
- **LCP < 2.5s:** hero images, critical CSS, preload, CDN, SSR
|
|
82
|
+
- **INP < 200ms:** break long tasks; defer JS; workers; less main-thread JS
|
|
83
|
+
- **CLS < 0.1:** image/video dimensions; no inject-above-content; `aspect-ratio`; reserve ad/embed space
|
|
84
|
+
|
|
85
|
+
```css
|
|
86
|
+
.image-container { aspect-ratio: 16 / 9; }
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Monitoring
|
|
90
|
+
|
|
91
|
+
Lighthouse, WebPageTest, CrUX, bundle analyzers, RUM (Sentry, Datadog, etc.). Track LCP, INP, CLS, TTI, FCP, TBT, bundle size, request count.
|
|
92
|
+
|
|
93
|
+
Test real devices and slow networks—not desktop Chrome alone.
|
|
94
|
+
|
|
95
|
+
**NEVER:** optimize blind; sacrifice a11y; break features; blanket `will-change`; lazy-load above fold; micro-opts before big wins; ignore mobile.
|
|
96
|
+
|
|
97
|
+
## Verify
|
|
98
|
+
|
|
99
|
+
Before/after Lighthouse; RUM trends; low-end Android; 3G throttle; no regressions; feels faster.
|
|
100
|
+
|
|
101
|
+
Then `/ui-design polish`.
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
Start your response with:
|
|
2
|
+
|
|
3
|
+
```
|
|
4
|
+
──────────── ⚡ OVERDRIVE ─────────────
|
|
5
|
+
》》》 Entering overdrive mode...
|
|
6
|
+
```
|
|
7
|
+
|
|
8
|
+
Push past ordinary UI limits—use browser capability so any region feels extraordinary: huge tables, morphing dialogs, streaming validation, cinematic transitions.
|
|
9
|
+
|
|
10
|
+
**Context rule:** “Extraordinary” depends on surface. Particles on a portfolio differ from settings—but instant optimistic saves on settings can still wow. Read personality and goals before picking technique.
|
|
11
|
+
|
|
12
|
+
### Propose before building
|
|
13
|
+
|
|
14
|
+
Highest misfire risk—do not code first.
|
|
15
|
+
|
|
16
|
+
1. Sketch **2–3 directions** (technique, ambition, aesthetic) with look/feel and trade-offs.
|
|
17
|
+
2. **AskUserQuestion** with options self-contained (support, perf, complexity)—structured question hides inline text until answered.
|
|
18
|
+
3. Build only the chosen direction.
|
|
19
|
+
|
|
20
|
+
### Iterate in the browser
|
|
21
|
+
|
|
22
|
+
Ambitious effects need visual iteration. Preview, verify, refine—multiple rounds. Close the gap between “works” and “extraordinary” with eyes, not assumptions.
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## What “extraordinary” means here
|
|
27
|
+
|
|
28
|
+
Ask: **what would surprise-and-delight a user of THIS interface?**
|
|
29
|
+
|
|
30
|
+
### Visual/marketing surfaces
|
|
31
|
+
Sensory impact: scroll-linked reveal, shader field, cinematic transition, cursor-reactive generative art.
|
|
32
|
+
|
|
33
|
+
### Functional UI
|
|
34
|
+
Felt quality: View Transition from trigger to dialog; massive virtualized tables; streaming validation; springy drag-and-drop.
|
|
35
|
+
|
|
36
|
+
### Performance-critical UI
|
|
37
|
+
Invisible polish: huge filters without flicker; forms that never block the main thread; near-real-time editors—zero hesitation.
|
|
38
|
+
|
|
39
|
+
### Data-heavy UI
|
|
40
|
+
Fluid data: GPU Canvas/WebGL; morphing chart states; force layouts that settle naturally.
|
|
41
|
+
|
|
42
|
+
**Thread:** implementation exceeds typical web expectations; technique serves experience.
|
|
43
|
+
|
|
44
|
+
## Toolkit (by goal)
|
|
45
|
+
|
|
46
|
+
### Cinematic transitions
|
|
47
|
+
View Transitions API; `@starting-style`; spring physics (Motion, GSAP, custom).
|
|
48
|
+
|
|
49
|
+
### Scroll-linked motion
|
|
50
|
+
`animation-timeline: scroll()` with static fallback.
|
|
51
|
+
|
|
52
|
+
### Beyond CSS
|
|
53
|
+
WebGL/WebGPU; Canvas/OffscreenCanvas; SVG filter chains.
|
|
54
|
+
|
|
55
|
+
### Data at scale
|
|
56
|
+
Virtual scroll; GPU charts; animated data morphs (D3, View Transitions).
|
|
57
|
+
|
|
58
|
+
### Complex property animation
|
|
59
|
+
`@property`; Web Animations API.
|
|
60
|
+
|
|
61
|
+
### Performance ceiling
|
|
62
|
+
Workers; OffscreenCanvas; WASM for heavy compute.
|
|
63
|
+
|
|
64
|
+
### Device interaction
|
|
65
|
+
Web Audio (gesture-gated); orientation/light/geo with permission.
|
|
66
|
+
|
|
67
|
+
**Scope:** Enhances how features **feel**—not new product capabilities (collab, offline, backend).
|
|
68
|
+
|
|
69
|
+
## Discipline
|
|
70
|
+
|
|
71
|
+
Progressive enhancement mandatory—good without the enhancement.
|
|
72
|
+
|
|
73
|
+
Target 60fps; lazy-init heavy GPU/WASM; pause off-screen work; test mid-range hardware.
|
|
74
|
+
|
|
75
|
+
Polish the last 20%: easing, stagger offsets, secondary motion.
|
|
76
|
+
|
|
77
|
+
**NEVER:** jank on mid-range devices; bleeding APIs without fallback; sound without opt-in; ambition masking weak fundamentals; competing wow moments.
|
|
78
|
+
|
|
79
|
+
## Verify
|
|
80
|
+
|
|
81
|
+
Fresh viewer reaction; removal test; phone/tablet/Chromebook smooth; brand/context fit.
|
|
82
|
+
|
|
83
|
+
Extraordinary = doing what users didn’t think a site could—not merely newest API.
|