@arthai/agents 1.0.0
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 +123 -0
- package/VERSION +1 -0
- package/agents/ai-consultant.md +999 -0
- package/agents/architect.md +174 -0
- package/agents/code-reviewer.md +115 -0
- package/agents/competitive-analyst.md +688 -0
- package/agents/content-strategist.md +607 -0
- package/agents/design-studio-create.md +304 -0
- package/agents/design-studio-critique.md +258 -0
- package/agents/design-studio-think.md +79 -0
- package/agents/domain-hunter.md +519 -0
- package/agents/explore-light.md +52 -0
- package/agents/frontend.md +261 -0
- package/agents/gtm-expert.md +811 -0
- package/agents/meeting-prep.md +318 -0
- package/agents/ops.md +149 -0
- package/agents/product-manager.md +563 -0
- package/agents/python-backend.md +286 -0
- package/agents/qa-baseline-updater.md +45 -0
- package/agents/qa-challenger.md +97 -0
- package/agents/qa-domain.md +145 -0
- package/agents/qa-e2e.md +184 -0
- package/agents/qa-test-promoter.md +97 -0
- package/agents/qa.md +226 -0
- package/agents/setup.md +134 -0
- package/agents/sre.md +165 -0
- package/agents/stakeholder-reporter.md +94 -0
- package/agents/user-researcher.md +602 -0
- package/bin/cli.js +322 -0
- package/bundles/canvas.json +16 -0
- package/bundles/compass.json +16 -0
- package/bundles/counsel.json +31 -0
- package/bundles/cruise.json +11 -0
- package/bundles/forge.json +26 -0
- package/bundles/prime.json +10 -0
- package/bundles/prism.json +23 -0
- package/bundles/scalpel.json +17 -0
- package/bundles/sentinel.json +19 -0
- package/bundles/shield.json +14 -0
- package/bundles/spark.json +19 -0
- package/compiler.sh +305 -0
- package/dist/plugins/canvas/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/canvas/agents/design-studio-create.md +304 -0
- package/dist/plugins/canvas/agents/design-studio-critique.md +258 -0
- package/dist/plugins/canvas/agents/design-studio-think.md +79 -0
- package/dist/plugins/canvas/agents/frontend.md +261 -0
- package/dist/plugins/canvas/skills/planning/SKILL.md +436 -0
- package/dist/plugins/compass/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/compass/agents/content-strategist.md +607 -0
- package/dist/plugins/compass/agents/gtm-expert.md +811 -0
- package/dist/plugins/compass/agents/product-manager.md +563 -0
- package/dist/plugins/compass/agents/user-researcher.md +602 -0
- package/dist/plugins/compass/skills/planning/SKILL.md +436 -0
- package/dist/plugins/counsel/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/counsel/agents/ai-consultant.md +999 -0
- package/dist/plugins/counsel/agents/competitive-analyst.md +688 -0
- package/dist/plugins/counsel/agents/meeting-prep.md +318 -0
- package/dist/plugins/counsel/agents/stakeholder-reporter.md +94 -0
- package/dist/plugins/counsel/hooks/check-deliverable.sh +65 -0
- package/dist/plugins/counsel/hooks/ensure-client-dir.sh +59 -0
- package/dist/plugins/counsel/hooks/hooks.json +28 -0
- package/dist/plugins/counsel/skills/client-discovery/SKILL.md +266 -0
- package/dist/plugins/counsel/skills/consulting/SKILL.md +282 -0
- package/dist/plugins/counsel/skills/deliverable-builder/SKILL.md +928 -0
- package/dist/plugins/counsel/skills/engagement-tracker/SKILL.md +380 -0
- package/dist/plugins/counsel/skills/market-research/SKILL.md +300 -0
- package/dist/plugins/counsel/skills/opportunity-map/SKILL.md +307 -0
- package/dist/plugins/counsel/skills/pitch-generator/SKILL.md +378 -0
- package/dist/plugins/counsel/skills/roi-calculator/SKILL.md +469 -0
- package/dist/plugins/counsel/skills/share/SKILL.md +211 -0
- package/dist/plugins/counsel/skills/solution-architect/SKILL.md +566 -0
- package/dist/plugins/counsel/skills/templates/SKILL.md +194 -0
- package/dist/plugins/counsel/skills/welcome/SKILL.md +136 -0
- package/dist/plugins/counsel/skills/wizard/SKILL.md +411 -0
- package/dist/plugins/cruise/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/cruise/skills/autopilot/SKILL.md +425 -0
- package/dist/plugins/forge/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/forge/agents/architect.md +174 -0
- package/dist/plugins/forge/agents/code-reviewer.md +115 -0
- package/dist/plugins/forge/agents/frontend.md +261 -0
- package/dist/plugins/forge/agents/product-manager.md +563 -0
- package/dist/plugins/forge/agents/python-backend.md +286 -0
- package/dist/plugins/forge/agents/qa.md +226 -0
- package/dist/plugins/forge/hooks/hooks.json +28 -0
- package/dist/plugins/forge/hooks/post-test-summary.sh +115 -0
- package/dist/plugins/forge/hooks/triage-router.sh +740 -0
- package/dist/plugins/forge/skills/implement/SKILL.md +532 -0
- package/dist/plugins/forge/skills/planning/SKILL.md +436 -0
- package/dist/plugins/forge/skills/pr/SKILL.md +275 -0
- package/dist/plugins/forge/skills/precheck/SKILL.md +159 -0
- package/dist/plugins/forge/skills/qa/SKILL.md +127 -0
- package/dist/plugins/forge/skills/review-pr/SKILL.md +367 -0
- package/dist/plugins/prime/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/prime/agents/ai-consultant.md +999 -0
- package/dist/plugins/prime/agents/architect.md +174 -0
- package/dist/plugins/prime/agents/code-reviewer.md +115 -0
- package/dist/plugins/prime/agents/competitive-analyst.md +688 -0
- package/dist/plugins/prime/agents/content-strategist.md +607 -0
- package/dist/plugins/prime/agents/design-studio-create.md +304 -0
- package/dist/plugins/prime/agents/design-studio-critique.md +258 -0
- package/dist/plugins/prime/agents/design-studio-think.md +79 -0
- package/dist/plugins/prime/agents/explore-light.md +52 -0
- package/dist/plugins/prime/agents/frontend.md +261 -0
- package/dist/plugins/prime/agents/gtm-expert.md +811 -0
- package/dist/plugins/prime/agents/meeting-prep.md +318 -0
- package/dist/plugins/prime/agents/ops.md +149 -0
- package/dist/plugins/prime/agents/product-manager.md +563 -0
- package/dist/plugins/prime/agents/python-backend.md +286 -0
- package/dist/plugins/prime/agents/qa-baseline-updater.md +45 -0
- package/dist/plugins/prime/agents/qa-challenger.md +97 -0
- package/dist/plugins/prime/agents/qa-domain.md +145 -0
- package/dist/plugins/prime/agents/qa-e2e.md +184 -0
- package/dist/plugins/prime/agents/qa-test-promoter.md +97 -0
- package/dist/plugins/prime/agents/qa.md +226 -0
- package/dist/plugins/prime/agents/setup.md +134 -0
- package/dist/plugins/prime/agents/sre.md +165 -0
- package/dist/plugins/prime/agents/stakeholder-reporter.md +94 -0
- package/dist/plugins/prime/agents/user-researcher.md +602 -0
- package/dist/plugins/prime/hooks/check-deliverable.sh +65 -0
- package/dist/plugins/prime/hooks/ensure-client-dir.sh +59 -0
- package/dist/plugins/prime/hooks/hooks.json +184 -0
- package/dist/plugins/prime/hooks/post-deploy-health.sh +83 -0
- package/dist/plugins/prime/hooks/post-diff-test-compare.sh +125 -0
- package/dist/plugins/prime/hooks/post-edit-lint.sh +92 -0
- package/dist/plugins/prime/hooks/post-git-state.sh +54 -0
- package/dist/plugins/prime/hooks/post-merge-cleanup.sh +101 -0
- package/dist/plugins/prime/hooks/post-test-summary.sh +115 -0
- package/dist/plugins/prime/hooks/pre-bash-guard.sh +142 -0
- package/dist/plugins/prime/hooks/pre-edit-guard.sh +121 -0
- package/dist/plugins/prime/hooks/pre-task-context.sh +113 -0
- package/dist/plugins/prime/hooks/session-bootstrap.sh +379 -0
- package/dist/plugins/prime/hooks/session-end.sh +107 -0
- package/dist/plugins/prime/hooks/session-summary.sh +97 -0
- package/dist/plugins/prime/hooks/sync-agents.sh +269 -0
- package/dist/plugins/prime/hooks/triage-router.sh +740 -0
- package/dist/plugins/prime/skills/arth/SKILL.md +165 -0
- package/dist/plugins/prime/skills/autopilot/SKILL.md +425 -0
- package/dist/plugins/prime/skills/calibrate/SKILL.md +1807 -0
- package/dist/plugins/prime/skills/ci-fix/SKILL.md +293 -0
- package/dist/plugins/prime/skills/client-discovery/SKILL.md +266 -0
- package/dist/plugins/prime/skills/consulting/SKILL.md +282 -0
- package/dist/plugins/prime/skills/custom-domain/SKILL.md +261 -0
- package/dist/plugins/prime/skills/deliverable-builder/SKILL.md +928 -0
- package/dist/plugins/prime/skills/discord-ops/SKILL.md +125 -0
- package/dist/plugins/prime/skills/engagement-tracker/SKILL.md +380 -0
- package/dist/plugins/prime/skills/explore.md +43 -0
- package/dist/plugins/prime/skills/fix/SKILL.md +1058 -0
- package/dist/plugins/prime/skills/implement/SKILL.md +532 -0
- package/dist/plugins/prime/skills/incident/SKILL.md +910 -0
- package/dist/plugins/prime/skills/issue/SKILL.md +134 -0
- package/dist/plugins/prime/skills/market-research/SKILL.md +300 -0
- package/dist/plugins/prime/skills/onboard/SKILL.md +344 -0
- package/dist/plugins/prime/skills/opportunity-map/SKILL.md +307 -0
- package/dist/plugins/prime/skills/pitch-generator/SKILL.md +378 -0
- package/dist/plugins/prime/skills/planning/SKILL.md +436 -0
- package/dist/plugins/prime/skills/pr/SKILL.md +275 -0
- package/dist/plugins/prime/skills/precheck/SKILL.md +159 -0
- package/dist/plugins/prime/skills/qa/SKILL.md +127 -0
- package/dist/plugins/prime/skills/qa-incident/SKILL.md +54 -0
- package/dist/plugins/prime/skills/qa-learn/SKILL.md +47 -0
- package/dist/plugins/prime/skills/restart/SKILL.md +70 -0
- package/dist/plugins/prime/skills/review-pr/SKILL.md +367 -0
- package/dist/plugins/prime/skills/roi-calculator/SKILL.md +469 -0
- package/dist/plugins/prime/skills/scan/SKILL.md +232 -0
- package/dist/plugins/prime/skills/setup/SKILL.md +691 -0
- package/dist/plugins/prime/skills/share/SKILL.md +211 -0
- package/dist/plugins/prime/skills/solution-architect/SKILL.md +566 -0
- package/dist/plugins/prime/skills/sre/SKILL.md +362 -0
- package/dist/plugins/prime/skills/sync/SKILL.md +188 -0
- package/dist/plugins/prime/skills/templates/SKILL.md +194 -0
- package/dist/plugins/prime/skills/welcome/SKILL.md +136 -0
- package/dist/plugins/prime/skills/wizard/SKILL.md +411 -0
- package/dist/plugins/prism/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/prism/agents/qa-baseline-updater.md +45 -0
- package/dist/plugins/prism/agents/qa-challenger.md +97 -0
- package/dist/plugins/prism/agents/qa-domain.md +145 -0
- package/dist/plugins/prism/agents/qa-e2e.md +184 -0
- package/dist/plugins/prism/agents/qa-test-promoter.md +97 -0
- package/dist/plugins/prism/agents/qa.md +226 -0
- package/dist/plugins/prism/hooks/hooks.json +26 -0
- package/dist/plugins/prism/hooks/post-diff-test-compare.sh +125 -0
- package/dist/plugins/prism/hooks/post-test-summary.sh +115 -0
- package/dist/plugins/prism/skills/qa/SKILL.md +127 -0
- package/dist/plugins/prism/skills/qa-incident/SKILL.md +54 -0
- package/dist/plugins/prism/skills/qa-learn/SKILL.md +47 -0
- package/dist/plugins/scalpel/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/scalpel/agents/code-reviewer.md +115 -0
- package/dist/plugins/scalpel/hooks/hooks.json +26 -0
- package/dist/plugins/scalpel/hooks/pre-edit-guard.sh +121 -0
- package/dist/plugins/scalpel/skills/ci-fix/SKILL.md +293 -0
- package/dist/plugins/scalpel/skills/fix/SKILL.md +1058 -0
- package/dist/plugins/scalpel/skills/issue/SKILL.md +134 -0
- package/dist/plugins/sentinel/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/sentinel/agents/ops.md +149 -0
- package/dist/plugins/sentinel/agents/sre.md +165 -0
- package/dist/plugins/sentinel/hooks/hooks.json +26 -0
- package/dist/plugins/sentinel/hooks/post-deploy-health.sh +83 -0
- package/dist/plugins/sentinel/hooks/post-git-state.sh +54 -0
- package/dist/plugins/sentinel/skills/incident/SKILL.md +910 -0
- package/dist/plugins/sentinel/skills/restart/SKILL.md +70 -0
- package/dist/plugins/sentinel/skills/sre/SKILL.md +362 -0
- package/dist/plugins/shield/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/shield/hooks/hooks.json +60 -0
- package/dist/plugins/shield/hooks/pre-bash-guard.sh +142 -0
- package/dist/plugins/shield/hooks/pre-edit-guard.sh +121 -0
- package/dist/plugins/shield/hooks/session-bootstrap.sh +379 -0
- package/dist/plugins/shield/hooks/triage-router.sh +740 -0
- package/dist/plugins/spark/.claude-plugin/plugin.json +6 -0
- package/dist/plugins/spark/agents/explore-light.md +52 -0
- package/dist/plugins/spark/agents/setup.md +134 -0
- package/dist/plugins/spark/hooks/hooks.json +16 -0
- package/dist/plugins/spark/hooks/session-bootstrap.sh +379 -0
- package/dist/plugins/spark/skills/calibrate/SKILL.md +1807 -0
- package/dist/plugins/spark/skills/onboard/SKILL.md +344 -0
- package/dist/plugins/spark/skills/scan/SKILL.md +232 -0
- package/dist/plugins/spark/skills/setup/SKILL.md +691 -0
- package/hook-defs.json +104 -0
- package/hooks/check-deliverable.sh +65 -0
- package/hooks/ensure-client-dir.sh +59 -0
- package/hooks/hooks.json +16 -0
- package/hooks/post-deploy-health.sh +83 -0
- package/hooks/post-diff-test-compare.sh +125 -0
- package/hooks/post-edit-lint.sh +92 -0
- package/hooks/post-git-state.sh +54 -0
- package/hooks/post-merge-cleanup.sh +101 -0
- package/hooks/post-test-summary.sh +115 -0
- package/hooks/pre-bash-guard.sh +142 -0
- package/hooks/pre-edit-guard.sh +121 -0
- package/hooks/pre-task-context.sh +113 -0
- package/hooks/session-bootstrap.sh +379 -0
- package/hooks/session-end.sh +107 -0
- package/hooks/session-start.sh +46 -0
- package/hooks/session-summary.sh +97 -0
- package/hooks/sync-agents.sh +269 -0
- package/hooks/triage-router.sh +740 -0
- package/install.sh +3185 -0
- package/package.json +40 -0
- package/portable.manifest +112 -0
- package/skills/arth/SKILL.md +165 -0
- package/skills/autopilot/SKILL.md +425 -0
- package/skills/calibrate/SKILL.md +1807 -0
- package/skills/ci-fix/SKILL.md +293 -0
- package/skills/client-discovery/SKILL.md +266 -0
- package/skills/consulting/SKILL.md +282 -0
- package/skills/continue/SKILL.md +174 -0
- package/skills/custom-domain/SKILL.md +261 -0
- package/skills/deliverable-builder/SKILL.md +928 -0
- package/skills/discord-ops/SKILL.md +125 -0
- package/skills/engagement-tracker/SKILL.md +380 -0
- package/skills/explore.md +43 -0
- package/skills/fix/SKILL.md +1058 -0
- package/skills/implement/SKILL.md +532 -0
- package/skills/incident/SKILL.md +910 -0
- package/skills/issue/SKILL.md +134 -0
- package/skills/market-research/SKILL.md +300 -0
- package/skills/onboard/SKILL.md +344 -0
- package/skills/opportunity-map/SKILL.md +307 -0
- package/skills/pitch-generator/SKILL.md +378 -0
- package/skills/planning/SKILL.md +436 -0
- package/skills/pr/SKILL.md +275 -0
- package/skills/precheck/SKILL.md +159 -0
- package/skills/qa/SKILL.md +127 -0
- package/skills/qa-incident/SKILL.md +54 -0
- package/skills/qa-learn/SKILL.md +47 -0
- package/skills/railway/central-station/SKILL.md +226 -0
- package/skills/railway/central-station/references/environment-config.md +183 -0
- package/skills/railway/central-station/references/monorepo.md +216 -0
- package/skills/railway/central-station/references/railpack.md +257 -0
- package/skills/railway/central-station/references/variables.md +170 -0
- package/skills/railway/database/SKILL.md +284 -0
- package/skills/railway/database/references/environment-config.md +183 -0
- package/skills/railway/database/references/monorepo.md +216 -0
- package/skills/railway/database/references/railpack.md +257 -0
- package/skills/railway/database/references/variables.md +170 -0
- package/skills/railway/database/scripts/railway-api.sh +41 -0
- package/skills/railway/deploy/SKILL.md +128 -0
- package/skills/railway/deploy/references/environment-config.md +183 -0
- package/skills/railway/deploy/references/monorepo.md +216 -0
- package/skills/railway/deploy/references/railpack.md +257 -0
- package/skills/railway/deploy/references/variables.md +170 -0
- package/skills/railway/deployment/SKILL.md +222 -0
- package/skills/railway/deployment/references/environment-config.md +183 -0
- package/skills/railway/deployment/references/monorepo.md +216 -0
- package/skills/railway/deployment/references/railpack.md +257 -0
- package/skills/railway/deployment/references/variables.md +170 -0
- package/skills/railway/domain/SKILL.md +137 -0
- package/skills/railway/domain/references/environment-config.md +183 -0
- package/skills/railway/domain/references/monorepo.md +216 -0
- package/skills/railway/domain/references/railpack.md +257 -0
- package/skills/railway/domain/references/variables.md +170 -0
- package/skills/railway/environment/SKILL.md +266 -0
- package/skills/railway/environment/references/environment-config.md +183 -0
- package/skills/railway/environment/references/monorepo.md +216 -0
- package/skills/railway/environment/references/railpack.md +257 -0
- package/skills/railway/environment/references/variables.md +170 -0
- package/skills/railway/metrics/SKILL.md +211 -0
- package/skills/railway/metrics/references/environment-config.md +183 -0
- package/skills/railway/metrics/references/monorepo.md +216 -0
- package/skills/railway/metrics/references/railpack.md +257 -0
- package/skills/railway/metrics/references/variables.md +170 -0
- package/skills/railway/metrics/scripts/railway-api.sh +41 -0
- package/skills/railway/new/SKILL.md +489 -0
- package/skills/railway/new/references/environment-config.md +183 -0
- package/skills/railway/new/references/monorepo.md +216 -0
- package/skills/railway/new/references/railpack.md +257 -0
- package/skills/railway/new/references/variables.md +170 -0
- package/skills/railway/projects/SKILL.md +142 -0
- package/skills/railway/projects/references/environment-config.md +183 -0
- package/skills/railway/projects/references/monorepo.md +216 -0
- package/skills/railway/projects/references/railpack.md +257 -0
- package/skills/railway/projects/references/variables.md +170 -0
- package/skills/railway/projects/scripts/railway-api.sh +41 -0
- package/skills/railway/railway-docs/SKILL.md +47 -0
- package/skills/railway/railway-docs/references/environment-config.md +183 -0
- package/skills/railway/railway-docs/references/monorepo.md +216 -0
- package/skills/railway/railway-docs/references/railpack.md +257 -0
- package/skills/railway/railway-docs/references/variables.md +170 -0
- package/skills/railway/service/SKILL.md +249 -0
- package/skills/railway/service/references/environment-config.md +183 -0
- package/skills/railway/service/references/monorepo.md +216 -0
- package/skills/railway/service/references/railpack.md +257 -0
- package/skills/railway/service/references/variables.md +170 -0
- package/skills/railway/service/scripts/railway-api.sh +41 -0
- package/skills/railway/status/SKILL.md +91 -0
- package/skills/railway/status/references/environment-config.md +183 -0
- package/skills/railway/status/references/monorepo.md +216 -0
- package/skills/railway/status/references/railpack.md +257 -0
- package/skills/railway/status/references/variables.md +170 -0
- package/skills/railway/templates/SKILL.md +275 -0
- package/skills/railway/templates/references/environment-config.md +183 -0
- package/skills/railway/templates/references/monorepo.md +216 -0
- package/skills/railway/templates/references/railpack.md +257 -0
- package/skills/railway/templates/references/variables.md +170 -0
- package/skills/railway/templates/scripts/railway-api.sh +41 -0
- package/skills/restart/SKILL.md +70 -0
- package/skills/review-pr/SKILL.md +367 -0
- package/skills/roi-calculator/SKILL.md +469 -0
- package/skills/scan/SKILL.md +232 -0
- package/skills/setup/SKILL.md +691 -0
- package/skills/share/SKILL.md +211 -0
- package/skills/solution-architect/SKILL.md +566 -0
- package/skills/sre/SKILL.md +362 -0
- package/skills/superpowers/brainstorming/SKILL.md +96 -0
- package/skills/superpowers/dispatching-parallel-agents/SKILL.md +180 -0
- package/skills/superpowers/executing-plans/SKILL.md +84 -0
- package/skills/superpowers/finishing-a-development-branch/SKILL.md +200 -0
- package/skills/superpowers/receiving-code-review/SKILL.md +213 -0
- package/skills/superpowers/requesting-code-review/SKILL.md +105 -0
- package/skills/superpowers/requesting-code-review/code-reviewer.md +146 -0
- package/skills/superpowers/subagent-driven-development/SKILL.md +242 -0
- package/skills/superpowers/subagent-driven-development/code-quality-reviewer-prompt.md +20 -0
- package/skills/superpowers/subagent-driven-development/implementer-prompt.md +78 -0
- package/skills/superpowers/subagent-driven-development/spec-reviewer-prompt.md +61 -0
- package/skills/superpowers/systematic-debugging/CREATION-LOG.md +119 -0
- package/skills/superpowers/systematic-debugging/SKILL.md +296 -0
- package/skills/superpowers/systematic-debugging/condition-based-waiting-example.ts +158 -0
- package/skills/superpowers/systematic-debugging/condition-based-waiting.md +115 -0
- package/skills/superpowers/systematic-debugging/defense-in-depth.md +122 -0
- package/skills/superpowers/systematic-debugging/find-polluter.sh +63 -0
- package/skills/superpowers/systematic-debugging/root-cause-tracing.md +169 -0
- package/skills/superpowers/systematic-debugging/test-academic.md +14 -0
- package/skills/superpowers/systematic-debugging/test-pressure-1.md +58 -0
- package/skills/superpowers/systematic-debugging/test-pressure-2.md +68 -0
- package/skills/superpowers/systematic-debugging/test-pressure-3.md +69 -0
- package/skills/superpowers/test-driven-development/SKILL.md +371 -0
- package/skills/superpowers/test-driven-development/testing-anti-patterns.md +299 -0
- package/skills/superpowers/using-git-worktrees/SKILL.md +218 -0
- package/skills/superpowers/using-superpowers/SKILL.md +95 -0
- package/skills/superpowers/verification-before-completion/SKILL.md +139 -0
- package/skills/superpowers/writing-plans/SKILL.md +116 -0
- package/skills/superpowers/writing-skills/SKILL.md +655 -0
- package/skills/superpowers/writing-skills/anthropic-best-practices.md +1150 -0
- package/skills/superpowers/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
- package/skills/superpowers/writing-skills/graphviz-conventions.dot +172 -0
- package/skills/superpowers/writing-skills/persuasion-principles.md +187 -0
- package/skills/superpowers/writing-skills/render-graphs.js +168 -0
- package/skills/superpowers/writing-skills/testing-skills-with-subagents.md +384 -0
- package/skills/sync/SKILL.md +188 -0
- package/skills/templates/SKILL.md +194 -0
- package/skills/welcome/SKILL.md +136 -0
- package/skills/wizard/SKILL.md +411 -0
- package/templates/CLAUDE.md.managed-block +123 -0
- package/templates/CLAUDE.md.template +111 -0
- package/templates/consulting/engagement-tracker-template.md +181 -0
- package/templates/consulting/executive-summary-template.md +83 -0
- package/templates/consulting/maturity-assessment-template.md +182 -0
- package/templates/consulting/proposal-template.md +209 -0
- package/templates/consulting/roi-model-template.md +139 -0
- package/templates/consulting/solution-architecture-template.md +313 -0
- package/templates/settings.json +130 -0
|
@@ -0,0 +1,411 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: wizard
|
|
3
|
+
description: "Guided step-by-step workflows for non-engineers. Role-based flows that walk you through common tasks. Usage: /wizard <role> <step>"
|
|
4
|
+
user-invocable: true
|
|
5
|
+
arguments: "<role> <step>"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
Guided workflows that walk non-engineers through multi-step processes. Each workflow is designed
|
|
9
|
+
for a specific role and breaks complex tasks into manageable steps, bringing in the right
|
|
10
|
+
specialist at each stage.
|
|
11
|
+
|
|
12
|
+
## Argument Parsing
|
|
13
|
+
|
|
14
|
+
| Input | Action |
|
|
15
|
+
|---|---|
|
|
16
|
+
| `/wizard` | Detect role or ask, then show available workflows |
|
|
17
|
+
| `/wizard pm` | Show PM workflow steps |
|
|
18
|
+
| `/wizard pm 1` | Jump to PM workflow step 1 |
|
|
19
|
+
| `/wizard pm next` | Continue to next incomplete step |
|
|
20
|
+
| `/wizard founder` | Show Founder workflow steps |
|
|
21
|
+
| `/wizard designer` | Show Designer workflow steps |
|
|
22
|
+
| `/wizard marketer` | Show Marketer workflow steps |
|
|
23
|
+
| `/wizard status` | Show progress across all workflows |
|
|
24
|
+
| `/wizard resume` | Resume where you left off |
|
|
25
|
+
| `/wizard reset` | Clear saved progress and start fresh |
|
|
26
|
+
|
|
27
|
+
## Role Detection
|
|
28
|
+
|
|
29
|
+
Check `.claude/.claude-agents.conf` for `USER_ROLE`. If not set, present this menu using AskUserQuestion:
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
What best describes your role?
|
|
33
|
+
1. Product Manager — I plan features and prioritize what to build
|
|
34
|
+
2. Founder — I oversee everything from vision to shipping
|
|
35
|
+
3. Designer — I design experiences and visual interfaces
|
|
36
|
+
4. Marketer — I position products and drive awareness
|
|
37
|
+
|
|
38
|
+
Pick the one closest to your work.
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## State Management
|
|
42
|
+
|
|
43
|
+
Progress is saved in `.claude/.wizard-state.json` so you can resume across sessions.
|
|
44
|
+
|
|
45
|
+
**State schema:**
|
|
46
|
+
```json
|
|
47
|
+
{
|
|
48
|
+
"role": "pm",
|
|
49
|
+
"active_workflow": "plan-and-ship",
|
|
50
|
+
"current_step": 2,
|
|
51
|
+
"steps_completed": [1],
|
|
52
|
+
"step_outputs": {
|
|
53
|
+
"1": {
|
|
54
|
+
"summary": "Feature brief for user notifications",
|
|
55
|
+
"file": ".claude/plans/notifications-brief.md"
|
|
56
|
+
}
|
|
57
|
+
},
|
|
58
|
+
"started_at": "2026-03-23T10:00:00Z",
|
|
59
|
+
"last_active": "2026-03-23T14:30:00Z"
|
|
60
|
+
}
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
**State operations:**
|
|
64
|
+
- Read state at the start of every `/wizard` invocation
|
|
65
|
+
- Write state after every step completion
|
|
66
|
+
- On `/wizard resume`: read state, show summary, continue from `current_step`
|
|
67
|
+
- On `/wizard reset`: delete `.claude/.wizard-state.json`
|
|
68
|
+
- On `/wizard status`: read state, show progress table
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Workflow 1: Product Manager — "Plan and Ship a Feature"
|
|
73
|
+
|
|
74
|
+
Present this overview when the PM role is selected:
|
|
75
|
+
|
|
76
|
+
```
|
|
77
|
+
Plan and Ship a Feature
|
|
78
|
+
═══════════════════════
|
|
79
|
+
|
|
80
|
+
This workflow walks you through taking an idea from concept to launch:
|
|
81
|
+
|
|
82
|
+
Step 1: Describe Your Idea ← Tell us what you want to build
|
|
83
|
+
Step 2: Understand Your Users ← Learn who needs this and why
|
|
84
|
+
Step 3: Write the Plan ← Create a detailed plan for the team
|
|
85
|
+
Step 4: Create a Launch Plan ← Figure out how to tell people about it
|
|
86
|
+
Step 5: Track Progress ← See how things are going
|
|
87
|
+
|
|
88
|
+
You can do these in order, skip ahead, or come back later.
|
|
89
|
+
Which step would you like to start with?
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Step 1: Describe Your Idea
|
|
93
|
+
|
|
94
|
+
**What happens:** You describe the feature or product idea in your own words. A specialist helps turn it into a structured brief.
|
|
95
|
+
|
|
96
|
+
**Execution:**
|
|
97
|
+
1. Ask the user: "What do you want to build? Describe it in a few sentences — who it helps and what problem it solves."
|
|
98
|
+
2. Read CLAUDE.md for project context
|
|
99
|
+
3. Spawn the `product-manager` agent with:
|
|
100
|
+
> Write a product brief for: {user's description}
|
|
101
|
+
> Project context: {CLAUDE.md content}
|
|
102
|
+
> Structure with: Problem statement, Target user, Desired outcome, Success metrics, Scope, Open questions.
|
|
103
|
+
> Write in plain language. Under 500 words.
|
|
104
|
+
4. Save the brief output to `.claude/plans/{topic}-brief.md`
|
|
105
|
+
5. Update state: step 1 complete, save file reference
|
|
106
|
+
|
|
107
|
+
**After completion:**
|
|
108
|
+
```
|
|
109
|
+
Your feature brief is ready!
|
|
110
|
+
|
|
111
|
+
Here's a quick summary: [2-sentence summary of the brief]
|
|
112
|
+
|
|
113
|
+
What would you like to do?
|
|
114
|
+
- "next" to move on to understanding your users
|
|
115
|
+
- "revise" to change something in the brief
|
|
116
|
+
- "share this" to send the brief to your team
|
|
117
|
+
- "save and stop" to come back later
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Step 2: Understand Your Users
|
|
121
|
+
|
|
122
|
+
**What happens:** A research specialist analyzes who needs this feature and what they struggle with, using your brief from Step 1 as context.
|
|
123
|
+
|
|
124
|
+
**Execution:**
|
|
125
|
+
1. Read Step 1 output (brief) for context
|
|
126
|
+
2. Spawn the `user-researcher` agent with:
|
|
127
|
+
> Based on this product brief: {brief content}
|
|
128
|
+
> Generate 2-3 behavior-based user personas who would benefit from this feature.
|
|
129
|
+
> For each persona: behavior pattern, motivation (functional/emotional/social jobs), current pain, trigger, and what success looks like.
|
|
130
|
+
> Also identify the top 3 assumptions we should validate before building.
|
|
131
|
+
3. Save output to state
|
|
132
|
+
|
|
133
|
+
**After completion:**
|
|
134
|
+
```
|
|
135
|
+
User research is ready! Here's what we found:
|
|
136
|
+
|
|
137
|
+
[1-sentence summary of key personas and insights]
|
|
138
|
+
|
|
139
|
+
What would you like to do?
|
|
140
|
+
- "next" to write the full plan
|
|
141
|
+
- "revise" to adjust the research
|
|
142
|
+
- "share this" to send to your team
|
|
143
|
+
- "save and stop" to come back later
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### Step 3: Write the Plan
|
|
147
|
+
|
|
148
|
+
**What happens:** A planning team creates a detailed implementation plan using your brief and user research.
|
|
149
|
+
|
|
150
|
+
**Execution:**
|
|
151
|
+
1. Read Step 1 (brief) and Step 2 (research) outputs
|
|
152
|
+
2. Invoke `/planning {topic}` with context from previous steps injected
|
|
153
|
+
3. The planning skill spawns its own team (PM + Architect) to create the plan
|
|
154
|
+
4. Save plan output to state
|
|
155
|
+
|
|
156
|
+
**After completion:**
|
|
157
|
+
```
|
|
158
|
+
Your implementation plan is ready!
|
|
159
|
+
|
|
160
|
+
The team created: [brief summary — scope, timeline, key decisions]
|
|
161
|
+
|
|
162
|
+
What would you like to do?
|
|
163
|
+
- "next" to plan how to launch this
|
|
164
|
+
- "revise" to change the plan
|
|
165
|
+
- "share this" to send to your team
|
|
166
|
+
- "save and stop" to come back later
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
### Step 4: Create a Launch Plan
|
|
170
|
+
|
|
171
|
+
**What happens:** A go-to-market specialist creates a launch plan for your feature.
|
|
172
|
+
|
|
173
|
+
**Execution:**
|
|
174
|
+
1. Read Step 1 (brief) and Step 2 (research) for context
|
|
175
|
+
2. Spawn the `gtm-expert` agent with:
|
|
176
|
+
> Create a launch plan for: {topic}
|
|
177
|
+
> Product brief: {brief content}
|
|
178
|
+
> Target users: {persona summaries from step 2}
|
|
179
|
+
> Structure with: What's launching, Who it's for, Positioning, Channels, Timeline (4 weeks), Success metrics, Risks.
|
|
180
|
+
> Write in plain language. Under 600 words.
|
|
181
|
+
3. Save output to state
|
|
182
|
+
|
|
183
|
+
### Step 5: Track Progress
|
|
184
|
+
|
|
185
|
+
**What happens:** A status specialist reads the project's actual data and generates a progress report.
|
|
186
|
+
|
|
187
|
+
**Execution:**
|
|
188
|
+
1. Spawn the `stakeholder-reporter` agent with:
|
|
189
|
+
> Generate a project status report focused on: {topic from step 1}
|
|
190
|
+
> Context: we planned this feature in [date]. Here's what the plan included: {brief summary}
|
|
191
|
+
> Read git history, PRs, and issues to report on progress.
|
|
192
|
+
2. Save output to state
|
|
193
|
+
|
|
194
|
+
**After completion:**
|
|
195
|
+
```
|
|
196
|
+
Here's your project status! [summary]
|
|
197
|
+
|
|
198
|
+
You've completed all 5 steps of the Plan and Ship workflow.
|
|
199
|
+
|
|
200
|
+
What would you like to do?
|
|
201
|
+
- "share this" to send the status to your team
|
|
202
|
+
- "start over" to plan a new feature
|
|
203
|
+
- "run step 5 again" to get a fresh status update later
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
---
|
|
207
|
+
|
|
208
|
+
## Workflow 2: Founder — "Build and Ship"
|
|
209
|
+
|
|
210
|
+
```
|
|
211
|
+
Build and Ship
|
|
212
|
+
══════════════
|
|
213
|
+
|
|
214
|
+
This workflow takes you from vision to launched product:
|
|
215
|
+
|
|
216
|
+
Step 1: Describe Your Vision ← What are you building and why?
|
|
217
|
+
Step 2: Research the Market ← Who else is doing this? What's your edge?
|
|
218
|
+
Step 3: Plan the Build ← Turn vision into a concrete plan
|
|
219
|
+
Step 4: Build It ← Get the team building
|
|
220
|
+
Step 5: Ship and Learn ← Launch and see what happens
|
|
221
|
+
|
|
222
|
+
Which step would you like to start with?
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
### Step 1: Describe Your Vision
|
|
226
|
+
- Ask: "What are you building? Who is it for? Why does the world need it?"
|
|
227
|
+
- Spawn `product-manager` with product vision template prompt
|
|
228
|
+
- Save vision document to state
|
|
229
|
+
|
|
230
|
+
### Step 2: Research the Market
|
|
231
|
+
- Read Step 1 (vision) for context
|
|
232
|
+
- Spawn `competitive-analyst` with:
|
|
233
|
+
> Research the competitive landscape for: {vision summary}
|
|
234
|
+
> Identify direct competitors, indirect competitors, and potential entrants.
|
|
235
|
+
> Run a Strategy Canvas and 7 Powers analysis on the top 3 competitors.
|
|
236
|
+
> What is the blue ocean opportunity?
|
|
237
|
+
- Save competitive intelligence to state
|
|
238
|
+
|
|
239
|
+
### Step 3: Plan the Build
|
|
240
|
+
- Read Steps 1-2 for context
|
|
241
|
+
- Invoke `/planning {topic}` with vision + competitive context
|
|
242
|
+
- Save plan to state
|
|
243
|
+
|
|
244
|
+
### Step 4: Build It
|
|
245
|
+
- Read Step 3 (plan) for context
|
|
246
|
+
- Invoke `/implement {topic}` with plan context
|
|
247
|
+
- Save implementation progress to state
|
|
248
|
+
|
|
249
|
+
### Step 5: Ship and Learn
|
|
250
|
+
- Read Steps 1-2 for context
|
|
251
|
+
- Spawn `gtm-expert` for launch plan based on competitive intelligence
|
|
252
|
+
- Spawn `stakeholder-reporter` for current project status
|
|
253
|
+
- Present both outputs together
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
257
|
+
## Workflow 3: Designer — "Design, Validate, Ship"
|
|
258
|
+
|
|
259
|
+
```
|
|
260
|
+
Design, Validate, Ship
|
|
261
|
+
══════════════════════
|
|
262
|
+
|
|
263
|
+
This workflow guides you through a complete design cycle:
|
|
264
|
+
|
|
265
|
+
Step 1: Define the Challenge ← What problem is this design solving?
|
|
266
|
+
Step 2: Get Expert Critique ← Honest feedback from design principles
|
|
267
|
+
Step 3: Iterate ← Refine based on feedback
|
|
268
|
+
Step 4: Plan Implementation ← Turn the design into a build plan
|
|
269
|
+
Step 5: Review Final Result ← Check the build against the original intent
|
|
270
|
+
|
|
271
|
+
Which step would you like to start with?
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
### Step 1: Define the Challenge
|
|
275
|
+
- Ask: "What design problem are you trying to solve? Who is the user and what should they be able to do?"
|
|
276
|
+
- Spawn `design-studio-think` with design thinking prompt
|
|
277
|
+
- Save design brief to state
|
|
278
|
+
|
|
279
|
+
### Step 2: Get Expert Critique
|
|
280
|
+
- Ask for the design to critique (URL, screenshot path, or description)
|
|
281
|
+
- Spawn `design-studio-critique` with design brief context from Step 1
|
|
282
|
+
- Save critique to state
|
|
283
|
+
|
|
284
|
+
### Step 3: Iterate
|
|
285
|
+
- Read Steps 1-2 (brief + critique) for context
|
|
286
|
+
- Spawn `design-studio-create` with:
|
|
287
|
+
> Based on this design challenge: {brief}
|
|
288
|
+
> And this critique feedback: {critique summary}
|
|
289
|
+
> Create an improved design that addresses the top recommendations.
|
|
290
|
+
- Save iteration output to state
|
|
291
|
+
|
|
292
|
+
### Step 4: Plan Implementation
|
|
293
|
+
- Read Steps 1-3 for context
|
|
294
|
+
- Invoke `/planning --design {topic}` with design brief and iteration context
|
|
295
|
+
- Save plan to state
|
|
296
|
+
|
|
297
|
+
### Step 5: Review Final Result
|
|
298
|
+
- Ask: "Has the design been implemented? Point me to what to review."
|
|
299
|
+
- Spawn `design-studio-critique` for final review against original brief from Step 1
|
|
300
|
+
- Compare: does the implementation match the design intent?
|
|
301
|
+
|
|
302
|
+
---
|
|
303
|
+
|
|
304
|
+
## Workflow 4: Marketer — "Research, Position, Launch"
|
|
305
|
+
|
|
306
|
+
```
|
|
307
|
+
Research, Position, Launch
|
|
308
|
+
═════════════════════════
|
|
309
|
+
|
|
310
|
+
This workflow guides you from market research to launch execution:
|
|
311
|
+
|
|
312
|
+
Step 1: Understand the Landscape ← Who are the competitors and what's our edge?
|
|
313
|
+
Step 2: Define Positioning ← How do we describe what we do and for whom?
|
|
314
|
+
Step 3: Create Content ← Blog posts, copy, and marketing materials
|
|
315
|
+
Step 4: Plan the Launch ← Week-by-week launch execution plan
|
|
316
|
+
Step 5: Measure Results ← How did it go? What's next?
|
|
317
|
+
|
|
318
|
+
Which step would you like to start with?
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
### Step 1: Understand the Landscape
|
|
322
|
+
- Ask: "What product or feature are we marketing? Who do you think the competitors are?"
|
|
323
|
+
- Spawn `competitive-analyst` with competitive intelligence gathering protocol
|
|
324
|
+
- Save landscape analysis to state
|
|
325
|
+
|
|
326
|
+
### Step 2: Define Positioning
|
|
327
|
+
- Read Step 1 (landscape) for context
|
|
328
|
+
- Spawn `gtm-expert` with:
|
|
329
|
+
> Based on this competitive landscape: {landscape summary}
|
|
330
|
+
> Complete a Positioning Canvas for: {product}
|
|
331
|
+
> Identify: competitive alternatives, unique attributes, value, target customers, market category.
|
|
332
|
+
> Write the positioning statement.
|
|
333
|
+
- Save positioning to state
|
|
334
|
+
|
|
335
|
+
### Step 3: Create Content
|
|
336
|
+
- Read Steps 1-2 (landscape + positioning) for context
|
|
337
|
+
- Spawn `content-strategist` with:
|
|
338
|
+
> Based on this positioning: {positioning statement}
|
|
339
|
+
> And this competitive landscape: {key findings}
|
|
340
|
+
> Create: 1 blog post draft, 3 social media posts (Twitter/LinkedIn), and 1 product announcement.
|
|
341
|
+
> Ground all content in real product capabilities (read CLAUDE.md and codebase).
|
|
342
|
+
> Use the PAS framework for the blog post and AIDA for social.
|
|
343
|
+
- Save content drafts to state
|
|
344
|
+
|
|
345
|
+
### Step 4: Plan the Launch
|
|
346
|
+
- Read Steps 1-3 for full context
|
|
347
|
+
- Spawn `gtm-expert` for a full launch plan with GACC brief
|
|
348
|
+
- Save launch plan to state
|
|
349
|
+
|
|
350
|
+
### Step 5: Measure Results
|
|
351
|
+
- Spawn `stakeholder-reporter` for project status
|
|
352
|
+
- Present status alongside launch plan metrics from Step 4
|
|
353
|
+
- Suggest: what to double down on, what to adjust
|
|
354
|
+
|
|
355
|
+
---
|
|
356
|
+
|
|
357
|
+
## Step Execution Protocol
|
|
358
|
+
|
|
359
|
+
For every step in every workflow, follow this protocol:
|
|
360
|
+
|
|
361
|
+
1. **Read state** from `.claude/.wizard-state.json`
|
|
362
|
+
2. **Check prerequisites** — if previous steps have outputs, load them as context
|
|
363
|
+
3. **Present what this step does** in plain language before executing
|
|
364
|
+
4. **Confirm** — "Ready to start? Or would you like to skip this step?"
|
|
365
|
+
5. **Execute** — spawn the appropriate agent/skill with full context
|
|
366
|
+
6. **Save output** to state (summary + file reference if applicable)
|
|
367
|
+
7. **Present results** with a brief summary
|
|
368
|
+
8. **Offer next actions:**
|
|
369
|
+
```
|
|
370
|
+
What would you like to do?
|
|
371
|
+
- "next" to continue to [next step name]
|
|
372
|
+
- "revise" to redo this step with changes
|
|
373
|
+
- "share this" to format for your team
|
|
374
|
+
- "save and stop" to come back later
|
|
375
|
+
- "skip to step [N]" to jump ahead
|
|
376
|
+
```
|
|
377
|
+
|
|
378
|
+
## Resume Protocol
|
|
379
|
+
|
|
380
|
+
On `/wizard resume`:
|
|
381
|
+
1. Read `.claude/.wizard-state.json`
|
|
382
|
+
2. If no state exists: "No workflow in progress. Type /wizard to start one."
|
|
383
|
+
3. If state exists, present:
|
|
384
|
+
```
|
|
385
|
+
Welcome back! You're working on: [workflow name]
|
|
386
|
+
Role: [role]
|
|
387
|
+
Started: [date]
|
|
388
|
+
|
|
389
|
+
Progress:
|
|
390
|
+
✓ Step 1: [name] — [summary]
|
|
391
|
+
✓ Step 2: [name] — [summary]
|
|
392
|
+
→ Step 3: [name] — not started yet
|
|
393
|
+
Step 4: [name]
|
|
394
|
+
Step 5: [name]
|
|
395
|
+
|
|
396
|
+
Ready to continue with Step 3: [name]?
|
|
397
|
+
```
|
|
398
|
+
|
|
399
|
+
## Rules
|
|
400
|
+
|
|
401
|
+
- Never show agent names — say "bringing in a specialist" or "running analysis"
|
|
402
|
+
- Never show model names or cost tiers
|
|
403
|
+
- Never show slash command syntax — all interaction is natural language
|
|
404
|
+
- All text must be in everyday language — no jargon, no technical terms
|
|
405
|
+
- Always save state before spawning agents (crash recovery)
|
|
406
|
+
- Always offer "save and stop" at every checkpoint — respect the user's time
|
|
407
|
+
- Pass context from previous steps to every agent invocation — continuity is critical
|
|
408
|
+
- If a step fails, explain what happened in plain English and offer to retry
|
|
409
|
+
- Keep step summaries under 2 sentences — the full output is always available
|
|
410
|
+
- The user can do steps out of order — warn but don't block
|
|
411
|
+
- Each step should complete in under 60 seconds
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
## Engineering Principles (MANDATORY — applies to ALL work)
|
|
2
|
+
|
|
3
|
+
### Research Before Fixing
|
|
4
|
+
- **Never guess.** Before changing code, read the relevant source files, docs, and configs.
|
|
5
|
+
- Understand WHY something is broken before attempting a fix.
|
|
6
|
+
- If your first fix doesn't work, STOP. Don't try another guess. Re-read the code.
|
|
7
|
+
- Use explore-light (Haiku, 1x cost) to scan the codebase before expensive agents investigate.
|
|
8
|
+
|
|
9
|
+
### No Over-Engineering
|
|
10
|
+
- **Do exactly what's needed.** Don't add abstractions, utilities, or frameworks unless the code already uses them.
|
|
11
|
+
- Match existing patterns — run explore-light to find how similar code is structured before writing new code.
|
|
12
|
+
- A bug fix touches the minimum files possible. A feature matches the existing architecture.
|
|
13
|
+
- If you're creating a new class/helper/utility that nothing else in the codebase uses, you're over-engineering.
|
|
14
|
+
|
|
15
|
+
### Test Before Shipping
|
|
16
|
+
- **Run tests locally before pushing.** Never push untested code.
|
|
17
|
+
- If the project has `/precheck`, run it. If it has `/qa`, run it in commit mode.
|
|
18
|
+
- After fixing a bug, verify the fix AND verify nothing else broke (differential testing).
|
|
19
|
+
- If 3+ consecutive fix attempts fail, STOP. Step back and reassess the root cause from scratch.
|
|
20
|
+
|
|
21
|
+
### Deployment Safety
|
|
22
|
+
- **Never modify production systems without explicit confirmation.**
|
|
23
|
+
- Don't change deploy targets, CI pipeline structure, or infrastructure config silently.
|
|
24
|
+
- Don't overwrite existing files during deployment without asking.
|
|
25
|
+
- If a deployment breaks something, investigate before attempting to fix. Don't cascade.
|
|
26
|
+
|
|
27
|
+
## Toolkit Awareness (MANDATORY — READ THIS FIRST)
|
|
28
|
+
|
|
29
|
+
You have a **claude-agents toolkit** installed in this project. It provides specialized
|
|
30
|
+
agents, skills, and hooks that handle domain-specific work better and cheaper.
|
|
31
|
+
|
|
32
|
+
**You are the ORCHESTRATOR.** The triage router fires on every message with a routing
|
|
33
|
+
table and SPEED score. Use it to decide: toolkit or you?
|
|
34
|
+
|
|
35
|
+
### When to use the toolkit (SPEED score 2+):
|
|
36
|
+
- **Multi-step workflows**: `/pr`, `/deploy`, `/planning`, `/implement`, `/qa`, `/ci-fix`
|
|
37
|
+
encode battle-tested sequences you'd otherwise do manually and forget steps
|
|
38
|
+
- **Domain expertise**: SRE, QA, frontend, backend agents have project context baked in
|
|
39
|
+
- **Cost savings**: Haiku/Sonnet agents handle 80% of tasks at 1/60th the cost of Opus
|
|
40
|
+
- **Parallelism**: Team skills spawn multiple agents working simultaneously
|
|
41
|
+
|
|
42
|
+
### When to use YOU directly (SPEED score 0-1):
|
|
43
|
+
- **Quick lookups**: Read/Grep/Glob for finding a file, checking a value, reading code
|
|
44
|
+
- **Small targeted edits**: 1-2 file changes where you already know what to do
|
|
45
|
+
- **Complex reasoning**: Architecture decisions, debugging novel problems, nuanced tradeoffs
|
|
46
|
+
- **Conversation flow**: Follow-up questions, clarifications, explaining code
|
|
47
|
+
- **Creative problem-solving**: When the task doesn't fit any existing pattern
|
|
48
|
+
- **Judgment calls**: Security reviews, design decisions, "should we even do this?"
|
|
49
|
+
|
|
50
|
+
### The balance:
|
|
51
|
+
The toolkit handles **process** (repeatable workflows, domain-specific checks, multi-step
|
|
52
|
+
sequences). You handle **judgment** (reasoning, creativity, novel problems, architecture).
|
|
53
|
+
|
|
54
|
+
A senior engineer doesn't do everything themselves — they delegate routine work and focus
|
|
55
|
+
their expertise where it matters most. That's you. The toolkit is your team.
|
|
56
|
+
|
|
57
|
+
**Don't over-delegate**: If it's faster to just Read a file and answer, do it.
|
|
58
|
+
**Don't under-delegate**: If it's a 5-step workflow the toolkit has a skill for, use it.
|
|
59
|
+
|
|
60
|
+
### Project Knowledge System
|
|
61
|
+
|
|
62
|
+
If this project has been calibrated (`/calibrate`), deep context is available:
|
|
63
|
+
|
|
64
|
+
- **`.claude/project-profile.md`** — Architecture patterns, coding conventions, domain model,
|
|
65
|
+
testing style. Read this before writing any code to match the project's patterns.
|
|
66
|
+
- **`.claude/knowledge/`** — The toolkit's long-term memory for this project:
|
|
67
|
+
- `shared/conventions.md` — Coding rules learned from corrections. **Read before writing code.**
|
|
68
|
+
- `shared/domain.md` — Business rules beyond what's in the code. **Read before domain decisions.**
|
|
69
|
+
- `shared/vocabulary.md` — What the team calls things. **Use these terms.**
|
|
70
|
+
- `shared/patterns.md` — Architecture patterns. **Follow these when adding new code.**
|
|
71
|
+
- `agents/{your-name}.md` — Your past learning. **Read on session start.**
|
|
72
|
+
- **Write back** when you learn something new — corrections, discoveries, decisions.
|
|
73
|
+
- See `knowledge/README.md` for the full protocol.
|
|
74
|
+
- **`.claude/knowledge/external/sources.md`** — Where team knowledge lives outside code
|
|
75
|
+
(Notion, Linear, Figma, etc.). Check before making decisions that might already be documented.
|
|
76
|
+
|
|
77
|
+
## Session Start Behavior (MANDATORY)
|
|
78
|
+
|
|
79
|
+
On your FIRST response in every new session, ALWAYS start with a brief status line
|
|
80
|
+
using context from the SessionStart hook. Include:
|
|
81
|
+
- Current branch + uncommitted file count
|
|
82
|
+
- Docker/infra status (if problems detected)
|
|
83
|
+
- Open PRs or assigned issues (if any)
|
|
84
|
+
- Any red flags (pending migrations, expired tokens)
|
|
85
|
+
|
|
86
|
+
Format: 1-3 compact lines before addressing the user's request. Example:
|
|
87
|
+
```
|
|
88
|
+
📋 project — main | 5 uncommitted | Docker: postgres ✓ redis ✓ | 2 open PRs
|
|
89
|
+
```
|
|
90
|
+
Then proceed with the user's actual request.
|
|
91
|
+
|
|
92
|
+
**CRITICAL — Greetings and vague first messages**: If the user's first message is a
|
|
93
|
+
greeting ("hey", "hi", "hello", "yo", "sup") or vague ("help", "what's up",
|
|
94
|
+
"what should I work on") or ANY message under 5 words with no specific task —
|
|
95
|
+
**ALWAYS use the `/onboard` skill**. Never respond to greetings yourself. The
|
|
96
|
+
bootstrap hook status line is a quick snapshot — `/onboard` gives the real briefing
|
|
97
|
+
with open PRs, issues, priorities, and actionable next steps.
|
|
98
|
+
|
|
99
|
+
## Routing Trace (MANDATORY)
|
|
100
|
+
|
|
101
|
+
On EVERY response, show a compact routing trace so the user understands the decision
|
|
102
|
+
path. Place it at the end of your response in a dimmed block:
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
🔀 Routing: [what triage decided] → [agent/skill/tool used] ([cost tier])
|
|
106
|
+
Why: [1-line reason for this routing choice]
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
Examples:
|
|
110
|
+
```
|
|
111
|
+
🔀 Routing: backend bug fix → python-backend agent (Sonnet, 10x)
|
|
112
|
+
Why: touches backend/app/services/, needs CLAUDE.md context, SPEED=4
|
|
113
|
+
```
|
|
114
|
+
```
|
|
115
|
+
🔀 Routing: file lookup → Grep (built-in, 0x)
|
|
116
|
+
Why: single-file search, no project context needed, SPEED=0
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
Rules:
|
|
120
|
+
- Always show the SPEED score breakdown if score >= 2
|
|
121
|
+
- Show which hook provided the context (triage-router, bootstrap, etc.)
|
|
122
|
+
- If you chose NOT to use the triage router's suggestion, explain why
|
|
123
|
+
- Skip the trace only for simple follow-up messages in an ongoing conversation
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
# CLAUDE.md — {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
<!-- Generated by claude-agents install.sh --init -->
|
|
4
|
+
<!-- TODO: Replace {{placeholders}} with your project details -->
|
|
5
|
+
|
|
6
|
+
## Project Overview
|
|
7
|
+
|
|
8
|
+
{{PROJECT_NAME}} is a {{DESCRIPTION}}.
|
|
9
|
+
|
|
10
|
+
## Tech Stack
|
|
11
|
+
|
|
12
|
+
- **Frontend**: <!-- TODO: e.g., Next.js 14, React 18, TypeScript, Tailwind -->
|
|
13
|
+
- **Backend**: <!-- TODO: e.g., FastAPI, SQLAlchemy, PostgreSQL -->
|
|
14
|
+
- **Auth**: <!-- TODO: e.g., Stytch, Auth0, Clerk -->
|
|
15
|
+
- **Deploy**: <!-- TODO: e.g., Railway, Vercel, AWS -->
|
|
16
|
+
|
|
17
|
+
## Project Structure
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
{{PROJECT_NAME}}/
|
|
21
|
+
├── frontend/ <!-- TODO: Frontend directory -->
|
|
22
|
+
├── backend/ <!-- TODO: Backend directory -->
|
|
23
|
+
└── ...
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Key Architecture
|
|
27
|
+
|
|
28
|
+
<!-- TODO: Describe your auth flow, API patterns, database schema, etc. -->
|
|
29
|
+
|
|
30
|
+
## Local Dev Services
|
|
31
|
+
|
|
32
|
+
<!-- TODO: Auto-populated by /scan or fill manually -->
|
|
33
|
+
|
|
34
|
+
| Service | Port | Directory | Start Command |
|
|
35
|
+
|----------|------|-----------|---------------|
|
|
36
|
+
| Frontend | <!-- TODO --> | frontend/ | <!-- TODO: e.g., npm run dev --> |
|
|
37
|
+
| Backend | <!-- TODO --> | backend/ | <!-- TODO: e.g., uvicorn app.main:app --reload --> |
|
|
38
|
+
|
|
39
|
+
## Test Commands
|
|
40
|
+
|
|
41
|
+
<!-- TODO: Auto-populated by /scan or fill manually -->
|
|
42
|
+
|
|
43
|
+
| What | Command | Directory |
|
|
44
|
+
|------|---------|-----------|
|
|
45
|
+
| Backend tests | <!-- TODO: e.g., pytest --> | backend/ |
|
|
46
|
+
| Backend lint | <!-- TODO: e.g., ruff check . --> | backend/ |
|
|
47
|
+
| Frontend tests | <!-- TODO: e.g., npm test --> | frontend/ |
|
|
48
|
+
| Frontend lint | <!-- TODO: e.g., npm run lint --> | frontend/ |
|
|
49
|
+
| Type check | <!-- TODO: e.g., npx tsc --noEmit --> | frontend/ |
|
|
50
|
+
| E2E tests | <!-- TODO: e.g., npx playwright test --> | frontend/ |
|
|
51
|
+
|
|
52
|
+
## Infrastructure
|
|
53
|
+
|
|
54
|
+
<!-- TODO: Auto-populated by /scan or fill manually -->
|
|
55
|
+
|
|
56
|
+
| Platform | Service | Domain |
|
|
57
|
+
|----------|---------|--------|
|
|
58
|
+
| <!-- TODO: e.g., Railway --> | <!-- TODO --> | <!-- TODO --> |
|
|
59
|
+
|
|
60
|
+
Health endpoints: <!-- TODO: e.g., /health, /api/health -->
|
|
61
|
+
|
|
62
|
+
## Environments
|
|
63
|
+
|
|
64
|
+
<!-- TODO: Auto-populated by /scan environments or /calibrate -->
|
|
65
|
+
|
|
66
|
+
| Name | Type | URL | Health | Deploy | Branch |
|
|
67
|
+
|------|------|-----|--------|--------|--------|
|
|
68
|
+
| local | development | <!-- TODO --> | <!-- TODO: e.g., /health --> | manual | — |
|
|
69
|
+
| <!-- TODO --> | <!-- TODO: staging/production/preview/canary --> | <!-- TODO --> | <!-- TODO --> | <!-- TODO --> | <!-- TODO --> |
|
|
70
|
+
|
|
71
|
+
Access notes: <!-- TODO: e.g., Railway MCP for staging/prod. Env vars: .env.local, .env.staging -->
|
|
72
|
+
|
|
73
|
+
## Domain
|
|
74
|
+
|
|
75
|
+
<!-- TODO: Auto-populated by /scan or fill manually -->
|
|
76
|
+
<!-- Describe what this app does, its core entities, and business rules. -->
|
|
77
|
+
<!-- Used by qa-domain agent for domain-aware testing. -->
|
|
78
|
+
|
|
79
|
+
## Running Locally
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
# TODO: Add your local development commands
|
|
83
|
+
# Frontend
|
|
84
|
+
cd frontend && npm run dev
|
|
85
|
+
|
|
86
|
+
# Backend
|
|
87
|
+
cd backend && source .venv/bin/activate && uvicorn app.main:app --reload
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Critical Rules
|
|
91
|
+
|
|
92
|
+
<!-- TODO: Add project-specific rules, e.g.: -->
|
|
93
|
+
- Never push to main directly — always create a PR
|
|
94
|
+
- Secrets in .env.local only — never committed
|
|
95
|
+
|
|
96
|
+
## Agent Customization
|
|
97
|
+
|
|
98
|
+
The following agents/skills are managed by `claude-agents` (symlinked):
|
|
99
|
+
- Run `~/.claude-agents/install.sh --status` to see what's linked
|
|
100
|
+
- To override any portable file, replace the symlink with a regular file
|
|
101
|
+
- Your override won't be touched by future syncs
|
|
102
|
+
|
|
103
|
+
### Project-Specific Agents
|
|
104
|
+
|
|
105
|
+
Add project-specific agents as regular files in `.claude/agents/`:
|
|
106
|
+
- See `~/.claude-agents/examples/agents/` for templates (frontend, backend, ops, sre, qa)
|
|
107
|
+
|
|
108
|
+
### Project-Specific Skills
|
|
109
|
+
|
|
110
|
+
Add project-specific skills as regular directories in `.claude/skills/`:
|
|
111
|
+
- See `~/.claude-agents/examples/skills/` for templates (ci-fix, qa, restart)
|