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,100 @@
|
|
|
1
|
+
# Nuxt — high-severity implementation guidelines
|
|
2
|
+
|
|
3
|
+
Subordinate to the design stack (ui-design first). Implementation correctness only; never visual direction.
|
|
4
|
+
|
|
5
|
+
## Nuxt
|
|
6
|
+
|
|
7
|
+
### Routing
|
|
8
|
+
|
|
9
|
+
- **Define page metadata with definePageMeta** — Do: definePageMeta for layout middleware title · Don't: Manual route meta configuration
|
|
10
|
+
|
|
11
|
+
### Rendering
|
|
12
|
+
|
|
13
|
+
- **Use SSR by default** — Do: Keep ssr: true (default) · Don't: Disable SSR unnecessarily
|
|
14
|
+
|
|
15
|
+
### DataFetching
|
|
16
|
+
|
|
17
|
+
- **Use useFetch for simple data fetching** — Do: useFetch for API calls · Don't: $fetch in onMounted
|
|
18
|
+
- **Use $fetch for non-reactive requests** — Do: $fetch in event handlers or server routes · Don't: useFetch in click handlers
|
|
19
|
+
- **Handle loading and error states** — Do: Check status pending error refs · Don't: Ignoring loading states
|
|
20
|
+
|
|
21
|
+
### Lifecycle
|
|
22
|
+
|
|
23
|
+
- **Avoid side effects in script setup root** — Do: Side effects in onMounted · Don't: setInterval in root script setup
|
|
24
|
+
- **Use onMounted for DOM access** — Do: onMounted for DOM manipulation · Don't: Direct DOM access in setup
|
|
25
|
+
|
|
26
|
+
### Server
|
|
27
|
+
|
|
28
|
+
- **Use server/api for API routes** — Do: server/api/users.ts for /api/users · Don't: Manual Express setup
|
|
29
|
+
- **Use defineEventHandler for handlers** — Do: defineEventHandler for all handlers · Don't: export default function
|
|
30
|
+
- **Validate server input** — Do: Zod or similar for validation · Don't: Trust client input
|
|
31
|
+
|
|
32
|
+
### State
|
|
33
|
+
|
|
34
|
+
- **Use useState for shared reactive state** — Do: useState for cross-component state · Don't: ref for shared state
|
|
35
|
+
|
|
36
|
+
### SEO
|
|
37
|
+
|
|
38
|
+
- **Use useSeoMeta for SEO tags** — Do: useSeoMeta for meta tags · Don't: useHead for simple meta
|
|
39
|
+
|
|
40
|
+
### Middleware
|
|
41
|
+
|
|
42
|
+
- **Use defineNuxtRouteMiddleware** — Do: defineNuxtRouteMiddleware wrapper · Don't: export default function
|
|
43
|
+
- **Use navigateTo for redirects** — Do: return navigateTo('/login') · Don't: router.push in middleware
|
|
44
|
+
|
|
45
|
+
### ErrorHandling
|
|
46
|
+
|
|
47
|
+
- **Use createError for errors** — Do: createError with statusCode · Don't: throw new Error
|
|
48
|
+
- **Use short statusMessage** — Do: Short generic messages · Don't: Detailed error info in statusMessage
|
|
49
|
+
|
|
50
|
+
### Link
|
|
51
|
+
|
|
52
|
+
- **Use NuxtLink for internal navigation** — Do: <NuxtLink to> for internal links · Don't: <a href> for internal links
|
|
53
|
+
|
|
54
|
+
### Plugins
|
|
55
|
+
|
|
56
|
+
- **Use defineNuxtPlugin** — Do: defineNuxtPlugin wrapper · Don't: export default function
|
|
57
|
+
|
|
58
|
+
### Environment
|
|
59
|
+
|
|
60
|
+
- **Use runtimeConfig for env vars** — Do: runtimeConfig in nuxt.config · Don't: process.env directly
|
|
61
|
+
- **Use NUXT_ prefix for env override** — Do: NUXT_API_SECRET NUXT_PUBLIC_API_BASE · Don't: Custom env var names
|
|
62
|
+
- **Access public config with useRuntimeConfig** — Do: useRuntimeConfig().public · Don't: Direct process.env access
|
|
63
|
+
- **Keep secrets in private config** — Do: runtimeConfig.apiSecret (server only) · Don't: Secrets in public config
|
|
64
|
+
|
|
65
|
+
## Nuxt UI
|
|
66
|
+
|
|
67
|
+
### Installation
|
|
68
|
+
|
|
69
|
+
- **Add Nuxt UI module** — Do: pnpm add @nuxt/ui and add to modules · Don't: Manual component imports
|
|
70
|
+
- **Import Tailwind and Nuxt UI CSS** — Do: @import tailwindcss and @import @nuxt/ui · Don't: Skip CSS imports
|
|
71
|
+
- **Wrap app with UApp component** — Do: <UApp> wrapper in app.vue · Don't: Skip UApp wrapper
|
|
72
|
+
- **Do not manually add auto-registered modules** — Do: Configure via root-level keys in nuxt.config · Don't: Adding them to modules array causes duplicate registration
|
|
73
|
+
|
|
74
|
+
### Icons
|
|
75
|
+
|
|
76
|
+
- **Use i-{collection}-{name} format for icons** — Do: i-lucide-home i-heroicons-user format · Don't: lucide:home format (v3 syntax)
|
|
77
|
+
|
|
78
|
+
### Theming
|
|
79
|
+
|
|
80
|
+
- **Configure colors in app.config.ts** — Do: ui.colors.primary in app.config.ts · Don't: Hardcoded colors in components
|
|
81
|
+
|
|
82
|
+
### Forms
|
|
83
|
+
|
|
84
|
+
- **Use UForm with schema validation** — Do: :schema prop with validation schema · Don't: Manual form validation
|
|
85
|
+
|
|
86
|
+
### Overlays
|
|
87
|
+
|
|
88
|
+
- **Use useOverlay composable for programmatic overlays** — Do: overlay.create(Component).open({ props }) pattern · Don't: v3 overlay.open(Component) pattern (removed in v4)
|
|
89
|
+
|
|
90
|
+
### Tables
|
|
91
|
+
|
|
92
|
+
- **Use UTable with data and columns props** — Do: :data and :columns props · Don't: Manual table markup
|
|
93
|
+
|
|
94
|
+
### Feedback
|
|
95
|
+
|
|
96
|
+
- **Use useToast for notifications** — Do: useToast().add({ title description }) · Don't: Alert components for toasts
|
|
97
|
+
|
|
98
|
+
### Accessibility
|
|
99
|
+
|
|
100
|
+
- **Use UFormField for form accessibility** — Do: UFormField wraps inputs · Don't: Manual id and for attributes
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# React Native — high-severity implementation guidelines
|
|
2
|
+
|
|
3
|
+
Subordinate to the design stack (ui-design first). Implementation correctness only; never visual direction.
|
|
4
|
+
|
|
5
|
+
## Styling
|
|
6
|
+
|
|
7
|
+
- **Use StyleSheet.create** — Do: StyleSheet for all styles · Don't: Inline style objects
|
|
8
|
+
|
|
9
|
+
## Navigation
|
|
10
|
+
|
|
11
|
+
- **Handle back button** — Do: useFocusEffect with BackHandler · Don't: Ignore back button
|
|
12
|
+
|
|
13
|
+
## Lists
|
|
14
|
+
|
|
15
|
+
- **Use FlatList for long lists** — Do: FlatList for 50+ items · Don't: ScrollView with map
|
|
16
|
+
- **Provide keyExtractor** — Do: keyExtractor with stable ID · Don't: Index as key
|
|
17
|
+
- **Optimize renderItem** — Do: React.memo for list items · Don't: Inline render function
|
|
18
|
+
|
|
19
|
+
## Images
|
|
20
|
+
|
|
21
|
+
- **Specify image dimensions** — Do: width and height for remote images · Don't: No dimensions for network images
|
|
22
|
+
|
|
23
|
+
## Forms
|
|
24
|
+
|
|
25
|
+
- **Handle keyboard** — Do: KeyboardAvoidingView · Don't: Content hidden by keyboard
|
|
26
|
+
|
|
27
|
+
## Animation
|
|
28
|
+
|
|
29
|
+
- **Run on UI thread** — Do: Run animations on UI thread · Don't: JS thread animations
|
|
30
|
+
|
|
31
|
+
## Async
|
|
32
|
+
|
|
33
|
+
- **Handle errors gracefully** — Do: Error UI for failed requests · Don't: Crash on error
|
|
34
|
+
- **Cancel async operations** — Do: AbortController or cleanup · Don't: Memory leaks from async
|
|
35
|
+
|
|
36
|
+
## Accessibility
|
|
37
|
+
|
|
38
|
+
- **Add accessibility labels** — Do: accessibilityLabel for all interactive · Don't: Missing labels
|
|
39
|
+
- **Support screen readers** — Do: Test with screen readers · Don't: Skip accessibility testing
|
|
40
|
+
|
|
41
|
+
## Testing
|
|
42
|
+
|
|
43
|
+
- **Test on real devices** — Do: Test on iOS and Android devices · Don't: Simulator only
|
|
44
|
+
|
|
45
|
+
## Native
|
|
46
|
+
|
|
47
|
+
- **Use native modules carefully** — Do: Batch native calls · Don't: Frequent bridge crossing
|
|
48
|
+
- **Handle permissions** — Do: Check and request permissions · Don't: Assume permissions granted
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# React — high-severity implementation guidelines
|
|
2
|
+
|
|
3
|
+
Subordinate to the design stack (ui-design first). Implementation correctness only; never visual direction.
|
|
4
|
+
|
|
5
|
+
## State
|
|
6
|
+
|
|
7
|
+
- **Avoid unnecessary state** — Do: Compute derived values in render · Don't: Store derivable values in state
|
|
8
|
+
|
|
9
|
+
## Effects
|
|
10
|
+
|
|
11
|
+
- **Clean up effects** — Do: Return cleanup function in useEffect · Don't: No cleanup for subscriptions
|
|
12
|
+
- **Specify dependencies correctly** — Do: All referenced values in dependency array · Don't: Empty deps with external references
|
|
13
|
+
- **Avoid unnecessary effects** — Do: Transform data during render handle events directly · Don't: useEffect for derived state or event handling
|
|
14
|
+
|
|
15
|
+
## Rendering
|
|
16
|
+
|
|
17
|
+
- **Use keys properly** — Do: Use stable IDs as keys · Don't: Array index as key for dynamic lists
|
|
18
|
+
|
|
19
|
+
## Events
|
|
20
|
+
|
|
21
|
+
- **Pass event handlers not call results** — Do: onClick={handleClick} · Don't: onClick={handleClick()} causing immediate call
|
|
22
|
+
|
|
23
|
+
## Hooks
|
|
24
|
+
|
|
25
|
+
- **Follow rules of hooks** — Do: Hooks at component top level · Don't: Hooks in conditions loops or callbacks
|
|
26
|
+
- **Name custom hooks with use prefix** — Do: useFetch useForm useAuth · Don't: fetchData or getData for hook
|
|
27
|
+
|
|
28
|
+
## Context
|
|
29
|
+
|
|
30
|
+
- **Memoize context values** — Do: useMemo for context value object · Don't: New object reference every render
|
|
31
|
+
|
|
32
|
+
## Performance
|
|
33
|
+
|
|
34
|
+
- **Virtualize long lists** — Do: react-window or react-virtual · Don't: Render thousands of DOM nodes
|
|
35
|
+
|
|
36
|
+
## ErrorHandling
|
|
37
|
+
|
|
38
|
+
- **Use error boundaries** — Do: ErrorBoundary wrapping sections · Don't: Let errors crash entire app
|
|
39
|
+
- **Handle async errors** — Do: try/catch in async handlers · Don't: Unhandled promise rejections
|
|
40
|
+
|
|
41
|
+
## Accessibility
|
|
42
|
+
|
|
43
|
+
- **Use semantic HTML** — Do: button for clicks nav for navigation · Don't: div with onClick for buttons
|
|
44
|
+
- **Manage focus properly** — Do: Focus trap in modals return focus on close · Don't: No focus management
|
|
45
|
+
- **Label form controls** — Do: htmlFor matching input id · Don't: Placeholder as only label
|
|
46
|
+
|
|
47
|
+
## TypeScript
|
|
48
|
+
|
|
49
|
+
- **Type component props** — Do: interface Props with all prop types · Don't: any or missing types
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# shadcn/ui — high-severity implementation guidelines
|
|
2
|
+
|
|
3
|
+
Subordinate to the design stack (ui-design first). Implementation correctness only; never visual direction.
|
|
4
|
+
|
|
5
|
+
## Setup
|
|
6
|
+
|
|
7
|
+
- **Use CLI for installation** — Do: npx shadcn@latest add component-name · Don't: Manual copy-paste from docs
|
|
8
|
+
- **Initialize project properly** — Do: npx shadcn@latest init before adding components · Don't: Skip init and add components directly
|
|
9
|
+
|
|
10
|
+
## Theming
|
|
11
|
+
|
|
12
|
+
- **Use CSS variables for colors** — Do: CSS variables in :root and .dark · Don't: Hardcoded color values in components
|
|
13
|
+
- **Support dark mode** — Do: Define both :root and .dark color schemes · Don't: Only light mode colors
|
|
14
|
+
|
|
15
|
+
## Dialog
|
|
16
|
+
|
|
17
|
+
- **Use Dialog for modal content** — Do: Dialog for confirmations forms details · Don't: Alert for modal content
|
|
18
|
+
- **Include proper dialog structure** — Do: Complete semantic structure · Don't: Missing title or description
|
|
19
|
+
|
|
20
|
+
## Form
|
|
21
|
+
|
|
22
|
+
- **Use Form with react-hook-form** — Do: useForm + Form + FormField pattern · Don't: Custom form handling without Form
|
|
23
|
+
- **Use FormField for inputs** — Do: FormField + FormItem + FormLabel + FormControl · Don't: Input without FormField wrapper
|
|
24
|
+
|
|
25
|
+
## Select
|
|
26
|
+
|
|
27
|
+
- **Structure Select properly** — Do: Complete Select structure · Don't: Missing SelectValue or SelectContent
|
|
28
|
+
|
|
29
|
+
## Table
|
|
30
|
+
|
|
31
|
+
- **Include proper table structure** — Do: Semantic table structure · Don't: Missing thead or tbody
|
|
32
|
+
|
|
33
|
+
## Toast
|
|
34
|
+
|
|
35
|
+
- **Add Toaster to layout** — Do: <Toaster /> in app layout · Don't: Toaster in individual pages
|
|
36
|
+
|
|
37
|
+
## Tooltip
|
|
38
|
+
|
|
39
|
+
- **Add TooltipProvider** — Do: TooltipProvider at app level · Don't: TooltipProvider per tooltip
|
|
40
|
+
|
|
41
|
+
## AlertDialog
|
|
42
|
+
|
|
43
|
+
- **Use AlertDialog for confirms** — Do: AlertDialog for delete confirmations · Don't: Dialog for confirmations
|
|
44
|
+
|
|
45
|
+
## Sidebar
|
|
46
|
+
|
|
47
|
+
- **Wrap in SidebarProvider** — Do: SidebarProvider at layout level · Don't: Sidebar without provider
|
|
48
|
+
|
|
49
|
+
## A11y
|
|
50
|
+
|
|
51
|
+
- **Use semantic components** — Do: Rely on component accessibility · Don't: Override ARIA attributes
|
|
52
|
+
- **Maintain focus management** — Do: Let components manage focus · Don't: Custom focus handling
|
|
53
|
+
- **Provide labels** — Do: FormLabel for form inputs · Don't: Placeholder as only label
|
|
54
|
+
|
|
55
|
+
## Patterns
|
|
56
|
+
|
|
57
|
+
- **Combine with React Hook Form** — Do: RHF Controller with shadcn inputs · Don't: Custom form state management
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Vue — high-severity implementation guidelines
|
|
2
|
+
|
|
3
|
+
Subordinate to the design stack (ui-design first). Implementation correctness only; never visual direction.
|
|
4
|
+
|
|
5
|
+
## Reactivity
|
|
6
|
+
|
|
7
|
+
- **Access ref values with .value** — Do: Use .value in script · Don't: Forget .value in script
|
|
8
|
+
|
|
9
|
+
## Watchers
|
|
10
|
+
|
|
11
|
+
- **Clean up side effects** — Do: Return cleanup in watchEffect · Don't: Leave subscriptions open
|
|
12
|
+
|
|
13
|
+
## Props
|
|
14
|
+
|
|
15
|
+
- **Avoid mutating props** — Do: Emit events to parent for changes · Don't: Direct prop mutation
|
|
16
|
+
|
|
17
|
+
## Lifecycle
|
|
18
|
+
|
|
19
|
+
- **Use onMounted for DOM access** — Do: onMounted for DOM operations · Don't: Access DOM in setup directly
|
|
20
|
+
- **Clean up in onUnmounted** — Do: onUnmounted for cleanup · Don't: Leave listeners attached
|
|
21
|
+
|
|
22
|
+
## Templates
|
|
23
|
+
|
|
24
|
+
- **Avoid v-if with v-for** — Do: Wrap in template or computed filter · Don't: v-if on same element as v-for
|
|
25
|
+
- **Use key with v-for** — Do: Unique key for each item · Don't: Index as key for dynamic lists
|
|
26
|
+
|
|
27
|
+
## State
|
|
28
|
+
|
|
29
|
+
- **Use storeToRefs for destructuring** — Do: storeToRefs(store) · Don't: Direct destructuring
|
|
30
|
+
|
|
31
|
+
## Accessibility
|
|
32
|
+
|
|
33
|
+
- **Use semantic elements** — Do: button nav main for purpose · Don't: div for everything
|
|
34
|
+
|
|
35
|
+
## SSR
|
|
36
|
+
|
|
37
|
+
- **Handle hydration mismatches** — Do: ClientOnly for browser-only content · Don't: Different content server/client
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "exonous",
|
|
3
|
+
"owner": {
|
|
4
|
+
"name": "exonous"
|
|
5
|
+
},
|
|
6
|
+
"metadata": {
|
|
7
|
+
"description": "Exonous plugins for Claude Code"
|
|
8
|
+
},
|
|
9
|
+
"plugins": [
|
|
10
|
+
{
|
|
11
|
+
"name": "techne",
|
|
12
|
+
"source": "./",
|
|
13
|
+
"description": "techne — stack skills, commands, quality hooks and language rules, managed by exonous",
|
|
14
|
+
"version": "1.15.3",
|
|
15
|
+
"author": {
|
|
16
|
+
"name": "exonous"
|
|
17
|
+
},
|
|
18
|
+
"keywords": [
|
|
19
|
+
"claude-code",
|
|
20
|
+
"skills",
|
|
21
|
+
"hooks",
|
|
22
|
+
"rules",
|
|
23
|
+
"tdd",
|
|
24
|
+
"quality",
|
|
25
|
+
"workflow"
|
|
26
|
+
],
|
|
27
|
+
"category": "workflow",
|
|
28
|
+
"strict": false
|
|
29
|
+
}
|
|
30
|
+
]
|
|
31
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "techne",
|
|
3
|
+
"version": "1.15.3",
|
|
4
|
+
"description": "techne — stack skills, commands, quality hooks and language rules, managed by exonous",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "exonous"
|
|
7
|
+
},
|
|
8
|
+
"keywords": [
|
|
9
|
+
"claude-code",
|
|
10
|
+
"skills",
|
|
11
|
+
"hooks",
|
|
12
|
+
"rules",
|
|
13
|
+
"tdd",
|
|
14
|
+
"quality",
|
|
15
|
+
"workflow"
|
|
16
|
+
],
|
|
17
|
+
"mcpServers": {},
|
|
18
|
+
"skills": [
|
|
19
|
+
"./skills/"
|
|
20
|
+
],
|
|
21
|
+
"commands": [
|
|
22
|
+
"./commands/"
|
|
23
|
+
]
|
|
24
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Get a failing build or type check green again with the smallest safe edits, one error at a time.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# /build-fix
|
|
6
|
+
|
|
7
|
+
Restore a passing build. Smallest diff wins; no refactoring on the way.
|
|
8
|
+
|
|
9
|
+
## 1. Find the build
|
|
10
|
+
|
|
11
|
+
| Marker | Run |
|
|
12
|
+
|---|---|
|
|
13
|
+
| `package.json` `build` script | the project's package manager: `pnpm build` / `npm run build` / `bun run build` |
|
|
14
|
+
| `tsconfig.json` only | `npx tsc --noEmit` |
|
|
15
|
+
| `Cargo.toml` | `cargo build` |
|
|
16
|
+
| `go.mod` | `go build ./...` |
|
|
17
|
+
| `pom.xml` | `mvn -q compile` |
|
|
18
|
+
| `build.gradle(.kts)` | `./gradlew compileJava` or `compileKotlin` |
|
|
19
|
+
| `pyproject.toml` | `mypy .` if configured, else `python -m compileall -q .` |
|
|
20
|
+
|
|
21
|
+
Several markers → build the one CI runs (check the workflow files).
|
|
22
|
+
|
|
23
|
+
## 2. Triage
|
|
24
|
+
|
|
25
|
+
Capture the full error output, group it by file, and order it so root causes come first: missing modules and broken imports, then type declarations, then call sites. Keep a running count so progress is visible.
|
|
26
|
+
|
|
27
|
+
## 3. Fix loop
|
|
28
|
+
|
|
29
|
+
Per error: read about 10 lines of context around it → name the cause → make the minimal edit → rebuild → confirm the count dropped and nothing new appeared. Then take the next one.
|
|
30
|
+
|
|
31
|
+
| Cause | Move |
|
|
32
|
+
|---|---|
|
|
33
|
+
| Unresolved import/module | Confirm the package is installed and the path/alias is right; propose the install command rather than running it |
|
|
34
|
+
| Type mismatch | Read both declarations; narrow at the boundary instead of widening to `any`/`unknown` casts |
|
|
35
|
+
| Import cycle | Trace the cycle; move the shared piece into its own module |
|
|
36
|
+
| Version skew | Compare manifest constraints with the lockfile |
|
|
37
|
+
| Tool misconfiguration | Diff the config against the tool's documented defaults; never weaken lint/type settings to pass |
|
|
38
|
+
|
|
39
|
+
## 4. Stop and ask when
|
|
40
|
+
|
|
41
|
+
- a fix creates more errors than it removes;
|
|
42
|
+
- the same error survives three attempts;
|
|
43
|
+
- the real fix is architectural;
|
|
44
|
+
- dependencies must be installed or upgraded.
|
|
45
|
+
|
|
46
|
+
## 5. Report
|
|
47
|
+
|
|
48
|
+
Fixed (file list), still failing, newly introduced (target: none), and the suggested next step for anything unresolved.
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Find and remove dead code safely, verifying with the test suite after every single removal.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# /refactor-clean
|
|
6
|
+
|
|
7
|
+
Delete what nothing uses, one verified step at a time. Cleaning and refactoring are separate passes.
|
|
8
|
+
|
|
9
|
+
## 1. Find candidates
|
|
10
|
+
|
|
11
|
+
| Stack | Tool |
|
|
12
|
+
|---|---|
|
|
13
|
+
| JS/TS | `npx knip` (files, exports, deps); `npx depcheck` for deps only |
|
|
14
|
+
| Python | `vulture <src>` |
|
|
15
|
+
| Go | `deadcode ./...` |
|
|
16
|
+
| Rust | `cargo +nightly udeps` (deps); compiler `dead_code` warnings |
|
|
17
|
+
|
|
18
|
+
No tool available → search for exported symbols with zero importers (the `atlas` MCP `search_graph` / `trace_path` answers this faster than grep).
|
|
19
|
+
|
|
20
|
+
## 2. Classify
|
|
21
|
+
|
|
22
|
+
| Risk | Typical items | Handling |
|
|
23
|
+
|---|---|---|
|
|
24
|
+
| Low | private helpers, unused test fixtures, internal functions | remove |
|
|
25
|
+
| Medium | components, routes, middleware, CLI commands | first rule out dynamic loading and external callers |
|
|
26
|
+
| High | entry points, config, public types, package exports | investigate; usually ask before touching |
|
|
27
|
+
|
|
28
|
+
For medium-risk items check: dynamic `import()` / `require()` / `__import__`, names referenced as strings (routers, DI containers, config files, templates), the package's public API surface, and known downstream consumers.
|
|
29
|
+
|
|
30
|
+
## 3. Removal loop
|
|
31
|
+
|
|
32
|
+
1. Suite green before you start (baseline).
|
|
33
|
+
2. Remove one item.
|
|
34
|
+
3. Rerun tests (and build/type check).
|
|
35
|
+
4. Red → undo that removal with an edit and mark the item skipped. Never discard unrelated working-tree changes.
|
|
36
|
+
5. Green → next item.
|
|
37
|
+
|
|
38
|
+
## 4. Consolidate (optional, after cleaning)
|
|
39
|
+
|
|
40
|
+
Merge near-identical functions, collapse duplicate type definitions, inline wrappers that add nothing, drop pass-through re-exports — each as its own verified step.
|
|
41
|
+
|
|
42
|
+
## 5. Report
|
|
43
|
+
|
|
44
|
+
Counts of removed functions, files and dependencies; skipped items with the failing test; approximate lines removed; final suite status.
|
|
45
|
+
|
|
46
|
+
Rules: never remove without a green baseline; one removal per verification; when unsure, keep it.
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Measure test coverage, rank the weakest files, and add the missing tests until the target (default 80%) is met.
|
|
3
|
+
argument-hint: "[target %] [path]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# /test-coverage
|
|
7
|
+
|
|
8
|
+
Raise coverage where it buys confidence — behavior and failure paths, not line-count padding. Default target 80% unless the project or argument sets another.
|
|
9
|
+
|
|
10
|
+
## 1. Measure
|
|
11
|
+
|
|
12
|
+
| Marker | Run |
|
|
13
|
+
|---|---|
|
|
14
|
+
| Vitest config | `npx vitest run --coverage` |
|
|
15
|
+
| Jest config / `jest` in `package.json` | `npx jest --coverage --coverageReporters=json-summary` |
|
|
16
|
+
| pytest | `pytest --cov=<pkg> --cov-report=json` |
|
|
17
|
+
| `go.mod` | `go test -coverprofile=coverage.out ./... && go tool cover -func=coverage.out` |
|
|
18
|
+
| `Cargo.toml` | `cargo llvm-cov --json` |
|
|
19
|
+
| Maven + JaCoCo | `mvn test jacoco:report` |
|
|
20
|
+
|
|
21
|
+
## 2. Rank gaps
|
|
22
|
+
|
|
23
|
+
List files under target, worst first. For each, note the untested functions, the unexercised branches (else arms, switch cases, catch blocks, early returns), and dead code that only inflates the denominator — flag that for removal instead of testing it.
|
|
24
|
+
|
|
25
|
+
## 3. Write tests, in this order
|
|
26
|
+
|
|
27
|
+
1. Main success path with realistic input.
|
|
28
|
+
2. Failure handling: invalid input, missing records, dependency errors and timeouts.
|
|
29
|
+
3. Boundaries: empty collections, null/undefined/None, 0, -1, max values, unicode.
|
|
30
|
+
4. Remaining branches.
|
|
31
|
+
|
|
32
|
+
Conventions: follow the project's existing test layout, naming, assertion and mocking style; mock only true externals (network, DB, clock, filesystem); keep tests independent; name each test after the behavior it proves (`rejects_duplicate_email_with_409`).
|
|
33
|
+
|
|
34
|
+
Priority targets: high-branching functions, error handlers, widely shared utilities, request→response paths of API handlers.
|
|
35
|
+
|
|
36
|
+
## 4. Verify
|
|
37
|
+
|
|
38
|
+
Full suite green, coverage re-measured. Still short → repeat step 3 on what remains.
|
|
39
|
+
|
|
40
|
+
## 5. Report
|
|
41
|
+
|
|
42
|
+
A before/after table per touched file plus the overall figure, and any code flagged as dead.
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
{
|
|
2
|
+
"hooks": {
|
|
3
|
+
"PreToolUse": [
|
|
4
|
+
{
|
|
5
|
+
"matcher": "Write|Edit|MultiEdit",
|
|
6
|
+
"hooks": [
|
|
7
|
+
{
|
|
8
|
+
"type": "command",
|
|
9
|
+
"command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run.js\" pre:config-guard",
|
|
10
|
+
"timeout": 5
|
|
11
|
+
}
|
|
12
|
+
]
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"matcher": "Bash",
|
|
16
|
+
"hooks": [
|
|
17
|
+
{
|
|
18
|
+
"type": "command",
|
|
19
|
+
"command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run.js\" pre:bash:no-verify",
|
|
20
|
+
"timeout": 5
|
|
21
|
+
}
|
|
22
|
+
]
|
|
23
|
+
}
|
|
24
|
+
],
|
|
25
|
+
"PostToolUse": [
|
|
26
|
+
{
|
|
27
|
+
"matcher": "Edit|Write|MultiEdit",
|
|
28
|
+
"hooks": [
|
|
29
|
+
{
|
|
30
|
+
"type": "command",
|
|
31
|
+
"command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run.js\" post:edit-tracker",
|
|
32
|
+
"timeout": 5
|
|
33
|
+
}
|
|
34
|
+
]
|
|
35
|
+
}
|
|
36
|
+
],
|
|
37
|
+
"Stop": [
|
|
38
|
+
{
|
|
39
|
+
"hooks": [
|
|
40
|
+
{
|
|
41
|
+
"type": "command",
|
|
42
|
+
"command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run.js\" stop:checks",
|
|
43
|
+
"timeout": 300
|
|
44
|
+
}
|
|
45
|
+
]
|
|
46
|
+
}
|
|
47
|
+
]
|
|
48
|
+
}
|
|
49
|
+
}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.component.ts"
|
|
4
|
+
- "**/*.component.html"
|
|
5
|
+
- "**/*.service.ts"
|
|
6
|
+
- "**/*.directive.ts"
|
|
7
|
+
- "**/*.pipe.ts"
|
|
8
|
+
- "**/*.guard.ts"
|
|
9
|
+
- "**/*.resolver.ts"
|
|
10
|
+
- "**/*.module.ts"
|
|
11
|
+
---
|
|
12
|
+
> Builds on the shared rules in `../common/coding-style.md`.
|
|
13
|
+
|
|
14
|
+
# Angular coding style
|
|
15
|
+
|
|
16
|
+
Confirm Angular major version (`ng version`) before signals/forms syntax. Run `ng build` after non-trivial edits.
|
|
17
|
+
|
|
18
|
+
## Files
|
|
19
|
+
|
|
20
|
+
CLI naming: `feature.widget.component.ts/html/spec.ts`, services/guards/pipes alongside feature folders. Generate via `ng generate`.
|
|
21
|
+
|
|
22
|
+
## Components
|
|
23
|
+
|
|
24
|
+
Standalone + `ChangeDetectionStrategy.OnPush` for new work. Inputs/outputs via signal `input()` / `output()` when on supported versions.
|
|
25
|
+
|
|
26
|
+
## DI
|
|
27
|
+
|
|
28
|
+
Prefer `inject()` fields; empty constructors. `InjectionToken` for config strings and feature flags.
|
|
29
|
+
|
|
30
|
+
## Signals
|
|
31
|
+
|
|
32
|
+
- `signal` / `computed` for local and derived state
|
|
33
|
+
- `linkedSignal` when derived state must reset with a source but remain writable
|
|
34
|
+
- `resource()` for async loading instead of manual subscribe boilerplate
|
|
35
|
+
- `effect()` only for logging/DOM side effects — never to copy one signal into another
|
|
36
|
+
|
|
37
|
+
## Templates
|
|
38
|
+
|
|
39
|
+
Control flow blocks (`@if`, `@for`) with `track` expressions. Keep templates declarative — move logic to class/computed.
|
|
40
|
+
|
|
41
|
+
## Forms
|
|
42
|
+
|
|
43
|
+
Align with repo: signal forms (newest), reactive `FormGroup` for complex validation, template-driven only for trivial cases.
|
|
44
|
+
|
|
45
|
+
## Styles
|
|
46
|
+
|
|
47
|
+
Default emulated encapsulation; `:host` styling; CSS variables for theme hooks.
|
|
48
|
+
|
|
49
|
+
Deep dives: **techne:angular** skill.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.component.ts"
|
|
4
|
+
- "**/*.component.html"
|
|
5
|
+
- "**/*.service.ts"
|
|
6
|
+
- "**/*.directive.ts"
|
|
7
|
+
- "**/*.pipe.ts"
|
|
8
|
+
- "**/*.spec.ts"
|
|
9
|
+
---
|
|
10
|
+
> Builds on the shared rules in `../common/hooks.md`.
|
|
11
|
+
|
|
12
|
+
# Angular harness hooks
|
|
13
|
+
|
|
14
|
+
PostToolUse on TS/HTML edits:
|
|
15
|
+
|
|
16
|
+
- Prettier on touched files
|
|
17
|
+
- `ng lint` (or eslint angular config)
|
|
18
|
+
- `tsc --noEmit` for quick type feedback
|
|
19
|
+
- `ng build` after codegen-sized changes (templates + types)
|
|
20
|
+
|
|
21
|
+
Stop hook: lint sweep on modified paths.
|
|
22
|
+
|
|
23
|
+
Tune aggressiveness with `EXONOUS_HOOK_PROFILE` and disable specific ids via `EXONOUS_DISABLED_HOOKS`.
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.component.ts"
|
|
4
|
+
- "**/*.component.html"
|
|
5
|
+
- "**/*.service.ts"
|
|
6
|
+
- "**/*.store.ts"
|
|
7
|
+
- "**/*.routes.ts"
|
|
8
|
+
---
|
|
9
|
+
> Builds on the shared rules in `../common/patterns.md`.
|
|
10
|
+
|
|
11
|
+
# Angular patterns
|
|
12
|
+
|
|
13
|
+
## Layering
|
|
14
|
+
|
|
15
|
+
Route/smart components call services; services wrap `HttpClient` and domain rules. Dumb components only bind inputs/outputs.
|
|
16
|
+
|
|
17
|
+
## Async data
|
|
18
|
+
|
|
19
|
+
Prefer `resource()` for signal-first apps. Bridge legacy Observables with `toSignal`. Manual streams must use `takeUntilDestroyed()` — avoid manual `ngOnDestroy` unsubscribe subjects in new code.
|
|
20
|
+
|
|
21
|
+
## Routing
|
|
22
|
+
|
|
23
|
+
Lazy feature routes via `loadChildren`. Use `canMatch` to avoid downloading admin bundles for anonymous users. Resolvers prefetch data to reduce flicker.
|
|
24
|
+
|
|
25
|
+
Functional guards/resolvers with `inject()`:
|
|
26
|
+
|
|
27
|
+
```typescript
|
|
28
|
+
export const authGuard: CanActivateFn = () =>
|
|
29
|
+
inject(AuthService).isAuthenticated() || inject(Router).createUrlTree(['/login']);
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## HTTP
|
|
33
|
+
|
|
34
|
+
Register functional interceptors (`auth`, errors, retry) via `provideHttpClient(withInterceptors([...]))`. Never bypass interceptors with raw `fetch` unless documented.
|
|
35
|
+
|
|
36
|
+
## RxJS habits
|
|
37
|
+
|
|
38
|
+
`switchMap` for cancelable searches; `exhaustMap` for submit buttons; always `catchError` so streams do not die silently.
|
|
39
|
+
|
|
40
|
+
## Rendering modes
|
|
41
|
+
|
|
42
|
+
CSR default; add SSR/prerender via official schematics when SEO/TTFB require it. Guard `window`/`document` on server.
|
|
43
|
+
|
|
44
|
+
## Accessibility
|
|
45
|
+
|
|
46
|
+
Use Angular CDK headless patterns; style via attributes like `[aria-selected="true"]` instead of manual role juggling.
|
|
47
|
+
|
|
48
|
+
Reference **techne:angular** for forms, animations, and harness testing.
|