@accelerationguy/accel 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/CLAUDE.md +19 -0
- package/LICENSE +33 -0
- package/README.md +275 -0
- package/bin/install.js +661 -0
- package/docs/getting-started.md +164 -0
- package/docs/module-guide.md +139 -0
- package/modules/drive/LICENSE +21 -0
- package/modules/drive/PAUL-VS-GSD.md +171 -0
- package/modules/drive/README.md +555 -0
- package/modules/drive/assets/terminal.svg +67 -0
- package/modules/drive/bin/install.js +210 -0
- package/modules/drive/integration.js +76 -0
- package/modules/drive/package.json +38 -0
- package/modules/drive/src/commands/add-phase.md +36 -0
- package/modules/drive/src/commands/apply.md +83 -0
- package/modules/drive/src/commands/assumptions.md +37 -0
- package/modules/drive/src/commands/audit.md +57 -0
- package/modules/drive/src/commands/complete-milestone.md +36 -0
- package/modules/drive/src/commands/config.md +175 -0
- package/modules/drive/src/commands/consider-issues.md +41 -0
- package/modules/drive/src/commands/discover.md +48 -0
- package/modules/drive/src/commands/discuss-milestone.md +33 -0
- package/modules/drive/src/commands/discuss.md +34 -0
- package/modules/drive/src/commands/flows.md +73 -0
- package/modules/drive/src/commands/handoff.md +201 -0
- package/modules/drive/src/commands/help.md +525 -0
- package/modules/drive/src/commands/init.md +54 -0
- package/modules/drive/src/commands/map-codebase.md +34 -0
- package/modules/drive/src/commands/milestone.md +34 -0
- package/modules/drive/src/commands/pause.md +44 -0
- package/modules/drive/src/commands/plan-fix.md +216 -0
- package/modules/drive/src/commands/plan.md +36 -0
- package/modules/drive/src/commands/progress.md +138 -0
- package/modules/drive/src/commands/register.md +29 -0
- package/modules/drive/src/commands/remove-phase.md +37 -0
- package/modules/drive/src/commands/research-phase.md +209 -0
- package/modules/drive/src/commands/research.md +47 -0
- package/modules/drive/src/commands/resume.md +49 -0
- package/modules/drive/src/commands/status.md +78 -0
- package/modules/drive/src/commands/unify.md +87 -0
- package/modules/drive/src/commands/verify.md +60 -0
- package/modules/drive/src/references/checkpoints.md +234 -0
- package/modules/drive/src/references/context-management.md +219 -0
- package/modules/drive/src/references/git-strategy.md +206 -0
- package/modules/drive/src/references/loop-phases.md +254 -0
- package/modules/drive/src/references/plan-format.md +263 -0
- package/modules/drive/src/references/quality-principles.md +152 -0
- package/modules/drive/src/references/research-quality-control.md +247 -0
- package/modules/drive/src/references/sonarqube-integration.md +244 -0
- package/modules/drive/src/references/specialized-workflow-integration.md +186 -0
- package/modules/drive/src/references/subagent-criteria.md +179 -0
- package/modules/drive/src/references/tdd.md +219 -0
- package/modules/drive/src/references/work-units.md +161 -0
- package/modules/drive/src/rules/commands.md +108 -0
- package/modules/drive/src/rules/references.md +107 -0
- package/modules/drive/src/rules/style.md +123 -0
- package/modules/drive/src/rules/templates.md +51 -0
- package/modules/drive/src/rules/workflows.md +133 -0
- package/modules/drive/src/templates/CONTEXT.md +88 -0
- package/modules/drive/src/templates/DEBUG.md +164 -0
- package/modules/drive/src/templates/DISCOVERY.md +148 -0
- package/modules/drive/src/templates/HANDOFF.md +77 -0
- package/modules/drive/src/templates/ISSUES.md +93 -0
- package/modules/drive/src/templates/MILESTONES.md +167 -0
- package/modules/drive/src/templates/PLAN.md +328 -0
- package/modules/drive/src/templates/PROJECT.md +219 -0
- package/modules/drive/src/templates/RESEARCH.md +130 -0
- package/modules/drive/src/templates/ROADMAP.md +328 -0
- package/modules/drive/src/templates/SPECIAL-FLOWS.md +70 -0
- package/modules/drive/src/templates/STATE.md +210 -0
- package/modules/drive/src/templates/SUMMARY.md +221 -0
- package/modules/drive/src/templates/UAT-ISSUES.md +139 -0
- package/modules/drive/src/templates/codebase/architecture.md +259 -0
- package/modules/drive/src/templates/codebase/concerns.md +329 -0
- package/modules/drive/src/templates/codebase/conventions.md +311 -0
- package/modules/drive/src/templates/codebase/integrations.md +284 -0
- package/modules/drive/src/templates/codebase/stack.md +190 -0
- package/modules/drive/src/templates/codebase/structure.md +287 -0
- package/modules/drive/src/templates/codebase/testing.md +484 -0
- package/modules/drive/src/templates/config.md +181 -0
- package/modules/drive/src/templates/milestone-archive.md +236 -0
- package/modules/drive/src/templates/milestone-context.md +190 -0
- package/modules/drive/src/templates/paul-json.md +147 -0
- package/modules/drive/src/vector-config/PAUL +26 -0
- package/modules/drive/src/vector-config/PAUL.manifest +11 -0
- package/modules/drive/src/workflows/apply-phase.md +393 -0
- package/modules/drive/src/workflows/audit-plan.md +344 -0
- package/modules/drive/src/workflows/complete-milestone.md +479 -0
- package/modules/drive/src/workflows/configure-special-flows.md +283 -0
- package/modules/drive/src/workflows/consider-issues.md +172 -0
- package/modules/drive/src/workflows/create-milestone.md +268 -0
- package/modules/drive/src/workflows/debug.md +292 -0
- package/modules/drive/src/workflows/discovery.md +187 -0
- package/modules/drive/src/workflows/discuss-milestone.md +245 -0
- package/modules/drive/src/workflows/discuss-phase.md +231 -0
- package/modules/drive/src/workflows/init-project.md +698 -0
- package/modules/drive/src/workflows/map-codebase.md +459 -0
- package/modules/drive/src/workflows/pause-work.md +259 -0
- package/modules/drive/src/workflows/phase-assumptions.md +181 -0
- package/modules/drive/src/workflows/plan-phase.md +385 -0
- package/modules/drive/src/workflows/quality-gate.md +263 -0
- package/modules/drive/src/workflows/register-manifest.md +107 -0
- package/modules/drive/src/workflows/research.md +241 -0
- package/modules/drive/src/workflows/resume-project.md +200 -0
- package/modules/drive/src/workflows/roadmap-management.md +334 -0
- package/modules/drive/src/workflows/transition-phase.md +368 -0
- package/modules/drive/src/workflows/unify-phase.md +290 -0
- package/modules/drive/src/workflows/verify-work.md +241 -0
- package/modules/forge/README.md +281 -0
- package/modules/forge/bin/install.js +200 -0
- package/modules/forge/package.json +32 -0
- package/modules/forge/skillsmith/rules/checklists-rules.md +42 -0
- package/modules/forge/skillsmith/rules/context-rules.md +43 -0
- package/modules/forge/skillsmith/rules/entry-point-rules.md +44 -0
- package/modules/forge/skillsmith/rules/frameworks-rules.md +43 -0
- package/modules/forge/skillsmith/rules/tasks-rules.md +52 -0
- package/modules/forge/skillsmith/rules/templates-rules.md +43 -0
- package/modules/forge/skillsmith/skillsmith.md +82 -0
- package/modules/forge/skillsmith/tasks/audit.md +277 -0
- package/modules/forge/skillsmith/tasks/discover.md +145 -0
- package/modules/forge/skillsmith/tasks/distill.md +276 -0
- package/modules/forge/skillsmith/tasks/scaffold.md +349 -0
- package/modules/forge/specs/checklists.md +193 -0
- package/modules/forge/specs/context.md +223 -0
- package/modules/forge/specs/entry-point.md +320 -0
- package/modules/forge/specs/frameworks.md +228 -0
- package/modules/forge/specs/rules.md +245 -0
- package/modules/forge/specs/tasks.md +344 -0
- package/modules/forge/specs/templates.md +335 -0
- package/modules/forge/terminal.svg +70 -0
- package/modules/ignition/README.md +245 -0
- package/modules/ignition/bin/install.js +184 -0
- package/modules/ignition/checklists/planning-quality.md +55 -0
- package/modules/ignition/data/application/config.md +21 -0
- package/modules/ignition/data/application/guide.md +51 -0
- package/modules/ignition/data/application/skill-loadout.md +11 -0
- package/modules/ignition/data/campaign/config.md +18 -0
- package/modules/ignition/data/campaign/guide.md +36 -0
- package/modules/ignition/data/campaign/skill-loadout.md +10 -0
- package/modules/ignition/data/client/config.md +18 -0
- package/modules/ignition/data/client/guide.md +36 -0
- package/modules/ignition/data/client/skill-loadout.md +11 -0
- package/modules/ignition/data/utility/config.md +18 -0
- package/modules/ignition/data/utility/guide.md +31 -0
- package/modules/ignition/data/utility/skill-loadout.md +8 -0
- package/modules/ignition/data/workflow/config.md +19 -0
- package/modules/ignition/data/workflow/guide.md +41 -0
- package/modules/ignition/data/workflow/skill-loadout.md +10 -0
- package/modules/ignition/integration.js +54 -0
- package/modules/ignition/package.json +35 -0
- package/modules/ignition/seed.md +81 -0
- package/modules/ignition/tasks/add-type.md +164 -0
- package/modules/ignition/tasks/graduate.md +182 -0
- package/modules/ignition/tasks/ideate.md +221 -0
- package/modules/ignition/tasks/launch.md +137 -0
- package/modules/ignition/tasks/status.md +71 -0
- package/modules/ignition/templates/planning-application.md +193 -0
- package/modules/ignition/templates/planning-campaign.md +138 -0
- package/modules/ignition/templates/planning-client.md +149 -0
- package/modules/ignition/templates/planning-utility.md +112 -0
- package/modules/ignition/templates/planning-workflow.md +125 -0
- package/modules/ignition/terminal.svg +74 -0
- package/modules/mission-control/CONTEXT-CONTINUITY-SPEC.md +293 -0
- package/modules/mission-control/CONTEXT-ENGINEERING-GUIDE.md +282 -0
- package/modules/mission-control/README.md +91 -0
- package/modules/mission-control/assets/terminal.svg +80 -0
- package/modules/mission-control/examples/entities.example.json +133 -0
- package/modules/mission-control/examples/projects.example.json +318 -0
- package/modules/mission-control/examples/state.example.json +183 -0
- package/modules/mission-control/examples/vector.example.json +245 -0
- package/modules/mission-control/mission-control/checklists/install-verification.md +46 -0
- package/modules/mission-control/mission-control/frameworks/framework-registry.md +83 -0
- package/modules/mission-control/mission-control/mission-control.md +83 -0
- package/modules/mission-control/mission-control/tasks/insights.md +73 -0
- package/modules/mission-control/mission-control/tasks/install.md +194 -0
- package/modules/mission-control/mission-control/tasks/status.md +125 -0
- package/modules/mission-control/schemas/entities.schema.json +89 -0
- package/modules/mission-control/schemas/projects.schema.json +221 -0
- package/modules/mission-control/schemas/state.schema.json +108 -0
- package/modules/mission-control/schemas/vector.schema.json +200 -0
- package/modules/momentum/README.md +678 -0
- package/modules/momentum/bin/install.js +563 -0
- package/modules/momentum/integration.js +131 -0
- package/modules/momentum/package.json +42 -0
- package/modules/momentum/schemas/entities.schema.json +89 -0
- package/modules/momentum/schemas/projects.schema.json +221 -0
- package/modules/momentum/schemas/state.schema.json +108 -0
- package/modules/momentum/src/commands/audit-claude-md.md +31 -0
- package/modules/momentum/src/commands/audit.md +33 -0
- package/modules/momentum/src/commands/groom.md +35 -0
- package/modules/momentum/src/commands/history.md +27 -0
- package/modules/momentum/src/commands/pulse.md +33 -0
- package/modules/momentum/src/commands/scaffold.md +33 -0
- package/modules/momentum/src/commands/status.md +28 -0
- package/modules/momentum/src/commands/surface-convert.md +35 -0
- package/modules/momentum/src/commands/surface-create.md +34 -0
- package/modules/momentum/src/commands/surface-list.md +27 -0
- package/modules/momentum/src/commands/vector-hygiene.md +33 -0
- package/modules/momentum/src/framework/context/momentum-principles.md +71 -0
- package/modules/momentum/src/framework/frameworks/audit-strategies.md +53 -0
- package/modules/momentum/src/framework/frameworks/satellite-registration.md +44 -0
- package/modules/momentum/src/framework/tasks/audit-claude-md.md +68 -0
- package/modules/momentum/src/framework/tasks/audit.md +64 -0
- package/modules/momentum/src/framework/tasks/groom.md +164 -0
- package/modules/momentum/src/framework/tasks/history.md +34 -0
- package/modules/momentum/src/framework/tasks/pulse.md +83 -0
- package/modules/momentum/src/framework/tasks/scaffold.md +202 -0
- package/modules/momentum/src/framework/tasks/status.md +35 -0
- package/modules/momentum/src/framework/tasks/surface-convert.md +143 -0
- package/modules/momentum/src/framework/tasks/surface-create.md +184 -0
- package/modules/momentum/src/framework/tasks/surface-list.md +42 -0
- package/modules/momentum/src/framework/tasks/vector-hygiene.md +160 -0
- package/modules/momentum/src/framework/templates/workspace-json.md +96 -0
- package/modules/momentum/src/hooks/_template.py +129 -0
- package/modules/momentum/src/hooks/active-hook.py +178 -0
- package/modules/momentum/src/hooks/backlog-hook.py +115 -0
- package/modules/momentum/src/hooks/mission-control-insights.py +169 -0
- package/modules/momentum/src/hooks/momentum-pulse-check.py +351 -0
- package/modules/momentum/src/hooks/operator.py +53 -0
- package/modules/momentum/src/hooks/psmm-injector.py +67 -0
- package/modules/momentum/src/hooks/satellite-detection.py +248 -0
- package/modules/momentum/src/packages/momentum-mcp/index.js +119 -0
- package/modules/momentum/src/packages/momentum-mcp/package.json +10 -0
- package/modules/momentum/src/packages/momentum-mcp/tools/entities.js +226 -0
- package/modules/momentum/src/packages/momentum-mcp/tools/operator.js +106 -0
- package/modules/momentum/src/packages/momentum-mcp/tools/projects.js +322 -0
- package/modules/momentum/src/packages/momentum-mcp/tools/psmm.js +206 -0
- package/modules/momentum/src/packages/momentum-mcp/tools/state.js +199 -0
- package/modules/momentum/src/packages/momentum-mcp/tools/surfaces.js +404 -0
- package/modules/momentum/src/skill/momentum.md +111 -0
- package/modules/momentum/src/tasks/groom.md +164 -0
- package/modules/momentum/src/templates/operator.json +66 -0
- package/modules/momentum/src/templates/workspace.json +111 -0
- package/modules/momentum/terminal.svg +77 -0
- package/modules/radar/README.md +1552 -0
- package/modules/radar/commands/audit.md +233 -0
- package/modules/radar/commands/guardrails.md +194 -0
- package/modules/radar/commands/init.md +207 -0
- package/modules/radar/commands/playbook.md +176 -0
- package/modules/radar/commands/remediate.md +156 -0
- package/modules/radar/commands/report.md +172 -0
- package/modules/radar/commands/resume.md +176 -0
- package/modules/radar/commands/status.md +148 -0
- package/modules/radar/commands/transform.md +205 -0
- package/modules/radar/commands/validate.md +177 -0
- package/modules/radar/docs/ARCHITECTURE.md +336 -0
- package/modules/radar/docs/GETTING-STARTED.md +287 -0
- package/modules/radar/docs/standards/agents.md +197 -0
- package/modules/radar/docs/standards/commands.md +250 -0
- package/modules/radar/docs/standards/domains.md +191 -0
- package/modules/radar/docs/standards/personas.md +211 -0
- package/modules/radar/docs/standards/rules.md +218 -0
- package/modules/radar/docs/standards/runtime.md +445 -0
- package/modules/radar/docs/standards/schemas.md +269 -0
- package/modules/radar/docs/standards/tools.md +273 -0
- package/modules/radar/docs/standards/workflows.md +254 -0
- package/modules/radar/docs/terminal.svg +72 -0
- package/modules/radar/docs/validation/convention-compliance-report.md +183 -0
- package/modules/radar/docs/validation/cross-reference-report.md +195 -0
- package/modules/radar/docs/validation/validation-summary.md +118 -0
- package/modules/radar/docs/validation/version-manifest.yaml +363 -0
- package/modules/radar/install.sh +711 -0
- package/modules/radar/integration.js +53 -0
- package/modules/radar/src/core/agents/architect.md +25 -0
- package/modules/radar/src/core/agents/compliance-officer.md +25 -0
- package/modules/radar/src/core/agents/data-engineer.md +25 -0
- package/modules/radar/src/core/agents/devils-advocate.md +22 -0
- package/modules/radar/src/core/agents/performance-engineer.md +25 -0
- package/modules/radar/src/core/agents/principal-engineer.md +23 -0
- package/modules/radar/src/core/agents/reality-gap-analyst.md +22 -0
- package/modules/radar/src/core/agents/security-engineer.md +25 -0
- package/modules/radar/src/core/agents/senior-app-engineer.md +25 -0
- package/modules/radar/src/core/agents/sre.md +25 -0
- package/modules/radar/src/core/agents/staff-engineer.md +23 -0
- package/modules/radar/src/core/agents/test-engineer.md +25 -0
- package/modules/radar/src/core/personas/architect.md +111 -0
- package/modules/radar/src/core/personas/compliance-officer.md +104 -0
- package/modules/radar/src/core/personas/data-engineer.md +113 -0
- package/modules/radar/src/core/personas/devils-advocate.md +105 -0
- package/modules/radar/src/core/personas/performance-engineer.md +119 -0
- package/modules/radar/src/core/personas/principal-engineer.md +119 -0
- package/modules/radar/src/core/personas/reality-gap-analyst.md +111 -0
- package/modules/radar/src/core/personas/security-engineer.md +108 -0
- package/modules/radar/src/core/personas/senior-app-engineer.md +111 -0
- package/modules/radar/src/core/personas/sre.md +117 -0
- package/modules/radar/src/core/personas/staff-engineer.md +109 -0
- package/modules/radar/src/core/personas/test-engineer.md +109 -0
- package/modules/radar/src/core/workflows/disagreement-resolution.md +183 -0
- package/modules/radar/src/core/workflows/phase-0-context.md +148 -0
- package/modules/radar/src/core/workflows/phase-1-reconnaissance.md +169 -0
- package/modules/radar/src/core/workflows/phase-2-domain-audits.md +190 -0
- package/modules/radar/src/core/workflows/phase-3-cross-domain.md +177 -0
- package/modules/radar/src/core/workflows/phase-4-adversarial-review.md +165 -0
- package/modules/radar/src/core/workflows/phase-5-report.md +189 -0
- package/modules/radar/src/core/workflows/phase-checkpoint.md +222 -0
- package/modules/radar/src/core/workflows/session-handoff.md +152 -0
- package/modules/radar/src/domains/00-context.md +201 -0
- package/modules/radar/src/domains/01-architecture.md +248 -0
- package/modules/radar/src/domains/02-data.md +224 -0
- package/modules/radar/src/domains/03-correctness.md +230 -0
- package/modules/radar/src/domains/04-security.md +274 -0
- package/modules/radar/src/domains/05-compliance.md +228 -0
- package/modules/radar/src/domains/06-testing.md +228 -0
- package/modules/radar/src/domains/07-reliability.md +246 -0
- package/modules/radar/src/domains/08-performance.md +247 -0
- package/modules/radar/src/domains/09-maintainability.md +271 -0
- package/modules/radar/src/domains/10-operability.md +250 -0
- package/modules/radar/src/domains/11-change-risk.md +246 -0
- package/modules/radar/src/domains/12-team-risk.md +221 -0
- package/modules/radar/src/domains/13-risk-synthesis.md +202 -0
- package/modules/radar/src/rules/agent-boundaries.md +78 -0
- package/modules/radar/src/rules/disagreement-protocol.md +76 -0
- package/modules/radar/src/rules/epistemic-hygiene.md +78 -0
- package/modules/radar/src/schemas/confidence.md +185 -0
- package/modules/radar/src/schemas/disagreement.md +238 -0
- package/modules/radar/src/schemas/finding.md +287 -0
- package/modules/radar/src/schemas/report-section.md +150 -0
- package/modules/radar/src/schemas/signal.md +108 -0
- package/modules/radar/src/tools/checkov.md +463 -0
- package/modules/radar/src/tools/git-history.md +581 -0
- package/modules/radar/src/tools/gitleaks.md +447 -0
- package/modules/radar/src/tools/grype.md +611 -0
- package/modules/radar/src/tools/semgrep.md +378 -0
- package/modules/radar/src/tools/sonarqube.md +550 -0
- package/modules/radar/src/tools/syft.md +539 -0
- package/modules/radar/src/tools/trivy.md +439 -0
- package/modules/radar/src/transform/agents/change-risk-modeler.md +24 -0
- package/modules/radar/src/transform/agents/execution-validator.md +24 -0
- package/modules/radar/src/transform/agents/guardrail-generator.md +24 -0
- package/modules/radar/src/transform/agents/pedagogy-agent.md +24 -0
- package/modules/radar/src/transform/agents/remediation-architect.md +24 -0
- package/modules/radar/src/transform/personas/change-risk-modeler.md +95 -0
- package/modules/radar/src/transform/personas/execution-validator.md +95 -0
- package/modules/radar/src/transform/personas/guardrail-generator.md +103 -0
- package/modules/radar/src/transform/personas/pedagogy-agent.md +105 -0
- package/modules/radar/src/transform/personas/remediation-architect.md +95 -0
- package/modules/radar/src/transform/rules/change-risk-rules.md +87 -0
- package/modules/radar/src/transform/rules/safety-governance.md +87 -0
- package/modules/radar/src/transform/schemas/change-risk.md +139 -0
- package/modules/radar/src/transform/schemas/intervention-level.md +207 -0
- package/modules/radar/src/transform/schemas/playbook.md +205 -0
- package/modules/radar/src/transform/schemas/verification-plan.md +134 -0
- package/modules/radar/src/transform/workflows/phase-6-remediation.md +148 -0
- package/modules/radar/src/transform/workflows/phase-7-risk-validation.md +161 -0
- package/modules/radar/src/transform/workflows/phase-8-execution-planning.md +159 -0
- package/modules/radar/src/transform/workflows/transform-safety.md +158 -0
- package/modules/vector/.vector-template/sessions/.gitkeep +0 -0
- package/modules/vector/.vector-template/vector.json +72 -0
- package/modules/vector/AUDIT-CLAUDEMD.md +154 -0
- package/modules/vector/INSTALL.md +185 -0
- package/modules/vector/LICENSE +21 -0
- package/modules/vector/README.md +409 -0
- package/modules/vector/VECTOR-BLOCK.md +57 -0
- package/modules/vector/assets/terminal.svg +68 -0
- package/modules/vector/bin/install.js +455 -0
- package/modules/vector/bin/migrate-v1-to-v2.sh +492 -0
- package/modules/vector/commands/help.md +46 -0
- package/modules/vector/hooks/vector-hook.py +775 -0
- package/modules/vector/mcp/index.js +118 -0
- package/modules/vector/mcp/package.json +10 -0
- package/modules/vector/mcp/tools/decisions.js +269 -0
- package/modules/vector/mcp/tools/domains.js +361 -0
- package/modules/vector/mcp/tools/staging.js +252 -0
- package/modules/vector/mcp/tools/vector-json.js +647 -0
- package/modules/vector/package.json +38 -0
- package/modules/vector/schemas/vector.schema.json +237 -0
- package/package.json +39 -0
- package/shared/branding/branding.js +70 -0
- package/shared/config/defaults.json +59 -0
- package/shared/events/README.md +175 -0
- package/shared/events/event-bus.js +134 -0
- package/shared/events/event_bus.py +255 -0
- package/shared/events/integrations.js +161 -0
- package/shared/events/schemas/audit-complete.schema.json +21 -0
- package/shared/events/schemas/phase-progress.schema.json +23 -0
- package/shared/events/schemas/plan-created.schema.json +21 -0
|
@@ -0,0 +1,193 @@
|
|
|
1
|
+
# {Project Name}
|
|
2
|
+
|
|
3
|
+
> {One-line description of what this application does}
|
|
4
|
+
|
|
5
|
+
**Created:** {date}
|
|
6
|
+
**Type:** Application
|
|
7
|
+
**Stack:** {framework + language + db + cache + deployment}
|
|
8
|
+
**Skill Loadout:** ui-ux-pro-max, /drive:audit, sonarqube scan
|
|
9
|
+
**Quality Gates:** test coverage, security scan, accessibility, performance
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Problem Statement
|
|
14
|
+
|
|
15
|
+
{What does this solve? Who's it for (solo, team, public)? Why build vs buy?}
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Tech Stack
|
|
20
|
+
|
|
21
|
+
{Framework, language, database, caching, deployment platform. Include "Why this stack?" rationale.}
|
|
22
|
+
|
|
23
|
+
| Layer | Choice | Rationale |
|
|
24
|
+
|-------|--------|-----------|
|
|
25
|
+
| Frontend | {e.g., Next.js, React, Vue} | {why} |
|
|
26
|
+
| Backend | {e.g., Laravel, Node, Python} | {why} |
|
|
27
|
+
| Database | {e.g., SQLite, Postgres, MySQL} | {why} |
|
|
28
|
+
| Cache | {e.g., Redis, none} | {why} |
|
|
29
|
+
| Deployment | {e.g., Docker, Vercel, VPS} | {why} |
|
|
30
|
+
|
|
31
|
+
### Research Needed
|
|
32
|
+
{If exploring unfamiliar tech: what's known, what needs research, what reference architectures exist.}
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Data Model
|
|
37
|
+
|
|
38
|
+
{Core entities and relationships. Can be rough at ideation stage — refine during Drive planning.}
|
|
39
|
+
|
|
40
|
+
### Entities
|
|
41
|
+
|
|
42
|
+
| Entity | Key Fields | Relationships |
|
|
43
|
+
|--------|-----------|---------------|
|
|
44
|
+
| {e.g., User} | {id, email, role} | {has many Projects} |
|
|
45
|
+
|
|
46
|
+
### Notes
|
|
47
|
+
- {JSON column candidates, polymorphic relationships, soft deletes, etc.}
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## API Surface
|
|
52
|
+
|
|
53
|
+
{Key route groups, auth strategy, versioning approach.}
|
|
54
|
+
|
|
55
|
+
### Auth Strategy
|
|
56
|
+
{Sanctum, JWT, session, API key — and why}
|
|
57
|
+
|
|
58
|
+
### Route Groups
|
|
59
|
+
|
|
60
|
+
| Group | Methods | Auth | Purpose |
|
|
61
|
+
|-------|---------|------|---------|
|
|
62
|
+
| {e.g., /api/users} | {GET, POST} | {required} | {description} |
|
|
63
|
+
|
|
64
|
+
### Internal vs External
|
|
65
|
+
- **Public endpoints:** {list}
|
|
66
|
+
- **Internal/admin endpoints:** {list}
|
|
67
|
+
- **MCP integration points:** {if applicable}
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Deployment Strategy
|
|
72
|
+
|
|
73
|
+
### Local Development
|
|
74
|
+
{Docker Compose services, dev server setup, ignition data}
|
|
75
|
+
|
|
76
|
+
| Service | Image/Runtime | Port | Purpose |
|
|
77
|
+
|---------|--------------|------|---------|
|
|
78
|
+
| {e.g., app} | {node:20} | {3000} | {main application} |
|
|
79
|
+
|
|
80
|
+
### Staging / Production
|
|
81
|
+
{CI/CD approach, environment management, hosting}
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## Security Considerations
|
|
86
|
+
|
|
87
|
+
{Per-app security concerns — not a generic checklist. What's specific to THIS application?}
|
|
88
|
+
|
|
89
|
+
- **Auth/Authz model:** {description}
|
|
90
|
+
- **Input validation:** {key areas}
|
|
91
|
+
- **OWASP concerns:** {relevant items for this app}
|
|
92
|
+
- **Secrets management:** {approach}
|
|
93
|
+
- **Rate limiting:** {if applicable}
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## UI/UX Needs
|
|
98
|
+
|
|
99
|
+
{Frontend requirements, design approach, key views.}
|
|
100
|
+
|
|
101
|
+
### Design System
|
|
102
|
+
{Tailwind, shadcn, custom components — and why}
|
|
103
|
+
|
|
104
|
+
### Key Views / Pages
|
|
105
|
+
|
|
106
|
+
| View | Purpose | Complexity |
|
|
107
|
+
|------|---------|------------|
|
|
108
|
+
| {e.g., Dashboard} | {primary workspace} | {high — real-time data} |
|
|
109
|
+
|
|
110
|
+
### Real-Time Requirements
|
|
111
|
+
{WebSockets, SSE, polling — if applicable}
|
|
112
|
+
|
|
113
|
+
### Responsive Needs
|
|
114
|
+
{Desktop-first, mobile-first, both, or desktop-only}
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## Integration Points
|
|
119
|
+
|
|
120
|
+
{External APIs, MCP servers, webhooks, third-party services.}
|
|
121
|
+
|
|
122
|
+
| Integration | Type | Purpose | Auth |
|
|
123
|
+
|------------|------|---------|------|
|
|
124
|
+
| {e.g., Stripe} | {API} | {payments} | {API key} |
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## Phase Breakdown
|
|
129
|
+
|
|
130
|
+
{Independently shippable milestones. Each phase: what's built, what's testable, what's the user-facing outcome. Maps directly to Drive milestones.}
|
|
131
|
+
|
|
132
|
+
### Phase 1: {Name}
|
|
133
|
+
- **Build:** {what gets built}
|
|
134
|
+
- **Testable:** {what can be verified}
|
|
135
|
+
- **Outcome:** {user-facing result}
|
|
136
|
+
|
|
137
|
+
### Phase 2: {Name}
|
|
138
|
+
- **Build:** {what gets built}
|
|
139
|
+
- **Testable:** {what can be verified}
|
|
140
|
+
- **Outcome:** {user-facing result}
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## Skill Loadout & Quality Gates
|
|
145
|
+
|
|
146
|
+
### Skills Used During Build
|
|
147
|
+
|
|
148
|
+
| Skill | When It Fires | Purpose |
|
|
149
|
+
|-------|--------------|---------|
|
|
150
|
+
| ui-ux-pro-max | Frontend phases | Design system, component quality |
|
|
151
|
+
| /drive:audit | End of each milestone | Architecture review |
|
|
152
|
+
| sonarqube scan | End of each phase | Code quality, vulnerabilities |
|
|
153
|
+
|
|
154
|
+
### Quality Gates
|
|
155
|
+
|
|
156
|
+
| Gate | Threshold | When |
|
|
157
|
+
|------|-----------|------|
|
|
158
|
+
| Test coverage | {e.g., 80%} | {each phase} |
|
|
159
|
+
| Security scan | {pass} | {each phase} |
|
|
160
|
+
| Accessibility | {WCAG AA} | {frontend phases} |
|
|
161
|
+
| Performance | {e.g., LCP < 2s} | {final milestone} |
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## Design Decisions
|
|
166
|
+
|
|
167
|
+
{Numbered list of resolved decisions. Each entry: what was decided and why.}
|
|
168
|
+
|
|
169
|
+
1. **{Decision}**: {choice} — {rationale}
|
|
170
|
+
|
|
171
|
+
---
|
|
172
|
+
|
|
173
|
+
## Open Questions
|
|
174
|
+
|
|
175
|
+
{Unresolved items that need answers before or during build.}
|
|
176
|
+
|
|
177
|
+
1. {Question}
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
## Next Actions
|
|
182
|
+
|
|
183
|
+
- [ ] {First concrete step}
|
|
184
|
+
|
|
185
|
+
---
|
|
186
|
+
|
|
187
|
+
## References
|
|
188
|
+
|
|
189
|
+
- {Links, related files, prior art}
|
|
190
|
+
|
|
191
|
+
---
|
|
192
|
+
|
|
193
|
+
*Last updated: {date}*
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
# {Campaign Name}
|
|
2
|
+
|
|
3
|
+
> {One-line description of the campaign objective}
|
|
4
|
+
|
|
5
|
+
**Created:** {date}
|
|
6
|
+
**Type:** Content/Campaign
|
|
7
|
+
**Goal:** {specific measurable objective}
|
|
8
|
+
**Skill Loadout:** content-manager, revops-expert, content-flywheel-strategist
|
|
9
|
+
**Quality Gates:** deliverables checklist complete, metrics baseline captured
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Strategy & Goal
|
|
14
|
+
|
|
15
|
+
{What's the business objective? Be specific — "grow the channel" is not a goal.}
|
|
16
|
+
|
|
17
|
+
- **Primary objective:** {measurable target}
|
|
18
|
+
- **Revenue target:** {if applicable}
|
|
19
|
+
- **Lead gen target:** {if applicable}
|
|
20
|
+
- **Brand awareness metric:** {if applicable}
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## Audience
|
|
25
|
+
|
|
26
|
+
- **Existing audience:** {Skool members, YouTube subs, email list — sizes}
|
|
27
|
+
- **New acquisition:** {target demographics, where they hang out}
|
|
28
|
+
- **Pain points:** {what keeps them up at night}
|
|
29
|
+
- **Language they use:** {actual phrases, not marketing speak}
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Deliverables List
|
|
34
|
+
|
|
35
|
+
{Enumerate EVERY output. Nothing ambiguous.}
|
|
36
|
+
|
|
37
|
+
| # | Deliverable | Format | Length | Platform | Due |
|
|
38
|
+
|---|------------|--------|--------|----------|-----|
|
|
39
|
+
| 1 | {e.g., Main video} | {YouTube long-form} | {15-20 min} | {YouTube} | {date} |
|
|
40
|
+
| 2 | {e.g., Teaser clip} | {Instagram Reel} | {60s} | {Instagram} | {date} |
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Channels & Platforms
|
|
45
|
+
|
|
46
|
+
| Platform | Content Type | Format Reqs | Posting Schedule |
|
|
47
|
+
|----------|-------------|-------------|-----------------|
|
|
48
|
+
| YouTube | {long-form} | {16:9, chapters, cards} | {date} |
|
|
49
|
+
| Instagram | {reels, stories} | {9:16, captions} | {date} |
|
|
50
|
+
| LinkedIn | {text posts} | {3000 char max} | {date} |
|
|
51
|
+
| Skool | {community posts} | {markdown} | {date} |
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## Timeline
|
|
56
|
+
|
|
57
|
+
| Date | Milestone | Depends On | Owner |
|
|
58
|
+
|------|-----------|------------|-------|
|
|
59
|
+
| {date} | {e.g., Script draft complete} | {—} | {Chris} |
|
|
60
|
+
| {date} | {e.g., Recording done} | {script} | {Chris} |
|
|
61
|
+
| {date} | {e.g., Edit complete} | {recording} | {editor/Chris} |
|
|
62
|
+
| {date} | {e.g., Publish} | {edit} | {Chris} |
|
|
63
|
+
|
|
64
|
+
### Promotion Windows
|
|
65
|
+
{When to push, when to let organic run, when to follow up}
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## Success Metrics
|
|
70
|
+
|
|
71
|
+
{Define BEFORE execution.}
|
|
72
|
+
|
|
73
|
+
| Metric | Baseline | Target | Measurement Tool |
|
|
74
|
+
|--------|----------|--------|-----------------|
|
|
75
|
+
| {e.g., Video views (7d)} | {current avg} | {target} | {YouTube Analytics} |
|
|
76
|
+
| {e.g., New subscribers} | {current count} | {target} | {YouTube Analytics} |
|
|
77
|
+
| {e.g., Skool signups} | {current} | {target} | {Skool admin} |
|
|
78
|
+
|
|
79
|
+
### Post-Campaign Review Date
|
|
80
|
+
{When to assess results: ____}
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## Skill Loadout & Quality Gates
|
|
85
|
+
|
|
86
|
+
### Skills Used
|
|
87
|
+
|
|
88
|
+
| Skill | When It Fires | Purpose |
|
|
89
|
+
|-------|--------------|---------|
|
|
90
|
+
| content-manager | Throughout | Pipeline tracking, status updates |
|
|
91
|
+
| revops-expert | Strategy phase | Framework application (Brunson, Hormozi) |
|
|
92
|
+
| content-flywheel-strategist | Post-creation | Repurposing into derivative content |
|
|
93
|
+
|
|
94
|
+
### Quality Gates
|
|
95
|
+
|
|
96
|
+
| Gate | When | Pass Criteria |
|
|
97
|
+
|------|------|---------------|
|
|
98
|
+
| Deliverables checklist | Pre-launch | All items produced |
|
|
99
|
+
| Metrics baseline | Pre-launch | Baseline numbers captured |
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## Design Decisions
|
|
104
|
+
|
|
105
|
+
1. **{Decision}**: {choice} — {rationale}
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Open Questions
|
|
110
|
+
|
|
111
|
+
1. {Question}
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## Next Actions
|
|
116
|
+
|
|
117
|
+
- [ ] {First concrete step}
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## References
|
|
122
|
+
|
|
123
|
+
- {Links, related files, prior art}
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
### Drive Decision
|
|
128
|
+
|
|
129
|
+
{Does this campaign need Drive?}
|
|
130
|
+
- Single deliverable (one video, one post) → No Drive, just do it
|
|
131
|
+
- Multi-deliverable, single week → ACTIVE.md tracking, no Drive
|
|
132
|
+
- Multi-week campaign with dependencies → Drive with timeline-based phases
|
|
133
|
+
|
|
134
|
+
**Decision:** {Drive / ACTIVE.md tracking / Just do it}
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
*Last updated: {date}*
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
# {Client Name} — {Project Name}
|
|
2
|
+
|
|
3
|
+
> {One-line description of what we're building for this client}
|
|
4
|
+
|
|
5
|
+
**Created:** {date}
|
|
6
|
+
**Type:** Client Website
|
|
7
|
+
**Client:** {name}
|
|
8
|
+
**Skill Loadout:** business-context-extractor, revops-expert, ui-ux-pro-max
|
|
9
|
+
**Quality Gates:** conversion psychology checklist, mobile optimization, client approval
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Business Context
|
|
14
|
+
|
|
15
|
+
{Who's the client? What do they do? Target audience, current online presence.}
|
|
16
|
+
|
|
17
|
+
- **Client:** {name, industry}
|
|
18
|
+
- **What they do:** {core offering}
|
|
19
|
+
- **Target audience:** {who buys from them}
|
|
20
|
+
- **Current presence:** {existing website, social, reviews}
|
|
21
|
+
- **Brand voice:** {formal, casual, authoritative, friendly}
|
|
22
|
+
- **Brand colors:** {if known}
|
|
23
|
+
- **Existing assets:** {logos, photos, testimonials, case studies}
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Competitor Analysis
|
|
28
|
+
|
|
29
|
+
{3-5 competitors. What they do well, what they miss. Positioning opportunity.}
|
|
30
|
+
|
|
31
|
+
| Competitor | URL | Strengths | Weaknesses | Positioning Opportunity |
|
|
32
|
+
|-----------|-----|-----------|------------|------------------------|
|
|
33
|
+
| {name} | {url} | {what they do well} | {gaps} | {how client can differentiate} |
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Conversion Strategy
|
|
38
|
+
|
|
39
|
+
{What action should visitors take?}
|
|
40
|
+
|
|
41
|
+
- **Primary CTA:** {e.g., book a call, buy now, sign up}
|
|
42
|
+
- **Secondary CTAs:** {e.g., download guide, join newsletter}
|
|
43
|
+
|
|
44
|
+
### Funnel
|
|
45
|
+
```
|
|
46
|
+
{e.g., Landing page → Form → Thank you page → Email follow-up}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### Objection Handling
|
|
50
|
+
{Top 3-5 objections and how the site addresses them}
|
|
51
|
+
|
|
52
|
+
| Objection | How We Address It |
|
|
53
|
+
|-----------|------------------|
|
|
54
|
+
| {e.g., "Too expensive"} | {e.g., ROI calculator, payment plans, guarantee} |
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## Content Needs
|
|
59
|
+
|
|
60
|
+
### Existing Content
|
|
61
|
+
- [ ] Testimonials: {available / need to gather}
|
|
62
|
+
- [ ] Case studies: {available / need to create}
|
|
63
|
+
- [ ] Product/service descriptions: {available / need to write}
|
|
64
|
+
- [ ] Media assets (photos, video): {available / need}
|
|
65
|
+
|
|
66
|
+
### Content to Create
|
|
67
|
+
|
|
68
|
+
| Section | Status | Notes |
|
|
69
|
+
|---------|--------|-------|
|
|
70
|
+
| Hero / headline | {exists / needs writing} | {notes} |
|
|
71
|
+
| About | {exists / needs writing} | {notes} |
|
|
72
|
+
| Services | {exists / needs writing} | {notes} |
|
|
73
|
+
| Testimonials | {exists / needs gathering} | {notes} |
|
|
74
|
+
| FAQ | {exists / needs writing} | {notes} |
|
|
75
|
+
|
|
76
|
+
### Tone & Style Guide
|
|
77
|
+
{Content tone, reading level, industry jargon level}
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Tech Approach
|
|
82
|
+
|
|
83
|
+
- **Method:** {site-launcher-wp standard flow / custom build / other}
|
|
84
|
+
- **Framework:** {Next.js template / WordPress conversion / static HTML}
|
|
85
|
+
- **Hosting:** {Vercel, client's existing hosting, other}
|
|
86
|
+
- **Domain/DNS:** {client provides / we manage / TBD}
|
|
87
|
+
- **CMS needs:** {client self-edits / we maintain / headless CMS}
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Timeline & Deliverables
|
|
92
|
+
|
|
93
|
+
| Date | Milestone | Deliverable | Client Action |
|
|
94
|
+
|------|-----------|-------------|---------------|
|
|
95
|
+
| {date} | {Kickoff} | {—} | {Provide assets, access} |
|
|
96
|
+
| {date} | {First draft} | {staging URL} | {Review, feedback} |
|
|
97
|
+
| {date} | {Revisions} | {updated staging} | {Final approval} |
|
|
98
|
+
| {date} | {Launch} | {live site} | {DNS update if needed} |
|
|
99
|
+
|
|
100
|
+
### Client Review Checkpoints
|
|
101
|
+
{When does the client see work? How do they provide feedback? What's the approval process?}
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## Skill Loadout & Quality Gates
|
|
106
|
+
|
|
107
|
+
### Skills Used During Build
|
|
108
|
+
|
|
109
|
+
| Skill | When It Fires | Purpose |
|
|
110
|
+
|-------|--------------|---------|
|
|
111
|
+
| business-context-extractor | Discovery | Crawl existing site for business details |
|
|
112
|
+
| revops-expert | Strategy | Conversion frameworks, offer positioning |
|
|
113
|
+
| ui-ux-pro-max | Build | Design system, responsive layout |
|
|
114
|
+
|
|
115
|
+
### Quality Gates
|
|
116
|
+
|
|
117
|
+
| Gate | When | Pass Criteria |
|
|
118
|
+
|------|------|---------------|
|
|
119
|
+
| Conversion psychology checklist | Pre-launch | All items addressed |
|
|
120
|
+
| Mobile optimization | Pre-launch | Fast, responsive, no layout breaks |
|
|
121
|
+
| Client approval | Each milestone | Written sign-off |
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## Design Decisions
|
|
126
|
+
|
|
127
|
+
1. **{Decision}**: {choice} — {rationale}
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
## Open Questions
|
|
132
|
+
|
|
133
|
+
1. {Question}
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## Next Actions
|
|
138
|
+
|
|
139
|
+
- [ ] {First concrete step}
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## References
|
|
144
|
+
|
|
145
|
+
- {Links, related files, prior art}
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
*Last updated: {date}*
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
# {Tool Name}
|
|
2
|
+
|
|
3
|
+
> {One sentence. If you need two, this might not be a utility.}
|
|
4
|
+
|
|
5
|
+
**Created:** {date}
|
|
6
|
+
**Type:** Utility Tool
|
|
7
|
+
**Location:** tools/{personal|shareable|mcp-servers}/
|
|
8
|
+
**Skill Loadout:** {usually minimal}
|
|
9
|
+
**Quality Gates:** {done criteria pass}
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Problem Statement
|
|
14
|
+
|
|
15
|
+
{What specific problem does this solve? One sentence. If you can't say it in one sentence, it might not be a utility tool.}
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Scope Guard
|
|
20
|
+
|
|
21
|
+
{Actively resist expansion.}
|
|
22
|
+
|
|
23
|
+
- **Can this be one file?** {yes/no — if no, why not?}
|
|
24
|
+
- **Can this be one function?** {yes/no — if no, why not?}
|
|
25
|
+
- **Single script or project structure?** {script / project — justify if project}
|
|
26
|
+
|
|
27
|
+
### What This Does
|
|
28
|
+
- {capability 1}
|
|
29
|
+
- {capability 2}
|
|
30
|
+
|
|
31
|
+
### What This Does NOT Do
|
|
32
|
+
- {explicitly excluded — resist feature creep}
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## User & Distribution
|
|
37
|
+
|
|
38
|
+
- **Audience:** {just me / Skool community / Claude Code users / MCP consumers}
|
|
39
|
+
- **Location:** {tools/personal/ | tools/shareable/ | tools/mcp-servers/production/}
|
|
40
|
+
- **Packaging:** {standalone script / npm package / MCP server / slash command}
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Dependencies
|
|
45
|
+
|
|
46
|
+
{Minimize ruthlessly. If dependencies are heavy, this might be an Application, not a Utility.}
|
|
47
|
+
|
|
48
|
+
| Dependency | Why | Can We Avoid It? |
|
|
49
|
+
|-----------|-----|-----------------|
|
|
50
|
+
| {e.g., node-fetch} | {HTTP requests} | {no — core need} |
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## Interface
|
|
55
|
+
|
|
56
|
+
- **Invocation:** {CLI args / MCP tool call / slash command / import}
|
|
57
|
+
- **Input:** {format, required args, optional args}
|
|
58
|
+
- **Output:** {format, stdout, file, return value}
|
|
59
|
+
|
|
60
|
+
### Examples
|
|
61
|
+
```
|
|
62
|
+
{example invocation and expected output}
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## Done Criteria
|
|
68
|
+
|
|
69
|
+
{3-5 concrete test cases. If you can't define done criteria easily, scope is too big.}
|
|
70
|
+
|
|
71
|
+
- [ ] {Test case 1: input → expected output}
|
|
72
|
+
- [ ] {Test case 2: input → expected output}
|
|
73
|
+
- [ ] {Test case 3: edge case → expected behavior}
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## Design Decisions
|
|
78
|
+
|
|
79
|
+
1. **{Decision}**: {choice} — {rationale}
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Open Questions
|
|
84
|
+
|
|
85
|
+
1. {Question}
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Next Actions
|
|
90
|
+
|
|
91
|
+
- [ ] {First concrete step — probably "just build it"}
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## References
|
|
96
|
+
|
|
97
|
+
- {Links, related files, prior art}
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
### Drive Decision
|
|
102
|
+
|
|
103
|
+
{Does this need Drive?}
|
|
104
|
+
- < 200 lines, single file → **Just build it, no Drive**
|
|
105
|
+
- Multiple files, tests needed → Light Drive (1 milestone, 1-2 phases)
|
|
106
|
+
- Complex with integrations → Probably an Application, not a Utility
|
|
107
|
+
|
|
108
|
+
**Decision:** {Just build it / Light Drive / Reclassify as Application}
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
*Last updated: {date}*
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
# {Project Name}
|
|
2
|
+
|
|
3
|
+
> {One-line description of what this workflow does}
|
|
4
|
+
|
|
5
|
+
**Created:** {date}
|
|
6
|
+
**Type:** Claude Code Workflow
|
|
7
|
+
**Skill Loadout:** {skills relevant to building this — e.g., /drive:audit}
|
|
8
|
+
**Quality Gates:** {quality checks — e.g., governance review, integration testing}
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## Problem Statement
|
|
13
|
+
|
|
14
|
+
{What workflow pain or gap does this solve? Be specific about what's broken, slow, or missing.}
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## Scope Definition
|
|
19
|
+
|
|
20
|
+
{What components make up this workflow? Check all that apply and describe each.}
|
|
21
|
+
|
|
22
|
+
### Components
|
|
23
|
+
- [ ] Slash command(s): {list}
|
|
24
|
+
- [ ] Skill(s): {list}
|
|
25
|
+
- [ ] Vector domain(s): {new or modified}
|
|
26
|
+
- [ ] Hook(s): {list}
|
|
27
|
+
- [ ] MCP server tool(s): {list}
|
|
28
|
+
- [ ] Templates / file generators: {list}
|
|
29
|
+
- [ ] Modifications to existing commands: {list}
|
|
30
|
+
|
|
31
|
+
### Out of Scope
|
|
32
|
+
- {Explicitly excluded items}
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Integration Map
|
|
37
|
+
|
|
38
|
+
### Systems Touched
|
|
39
|
+
|
|
40
|
+
| System | How It's Touched | Changes Needed |
|
|
41
|
+
|--------|-----------------|----------------|
|
|
42
|
+
| {e.g., Vector} | {e.g., new domain, rule updates} | {specific changes} |
|
|
43
|
+
| {e.g., Drive} | {e.g., new input format} | {specific changes} |
|
|
44
|
+
| {e.g., Existing commands} | {e.g., /graduate modification} | {specific changes} |
|
|
45
|
+
|
|
46
|
+
### Systems NOT Touched
|
|
47
|
+
- {List systems explicitly unaffected to prevent scope creep}
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Interaction Design
|
|
52
|
+
|
|
53
|
+
{Map the user experience as conversation flows.}
|
|
54
|
+
|
|
55
|
+
### Entry Point
|
|
56
|
+
```
|
|
57
|
+
User: /{command}
|
|
58
|
+
Claude: {what happens}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Conversation Flow
|
|
62
|
+
{Step-by-step: what Claude asks, what user provides, what Claude does with it. Include branching logic if applicable.}
|
|
63
|
+
|
|
64
|
+
### Session End
|
|
65
|
+
{What artifacts are produced? What does Claude report? What's the next step prompt?}
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## Output Artifacts
|
|
70
|
+
|
|
71
|
+
| Artifact | Location | Purpose |
|
|
72
|
+
|----------|----------|---------|
|
|
73
|
+
| {file/command/domain} | {path} | {what it does} |
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## Downstream Handoff
|
|
78
|
+
|
|
79
|
+
{How does the output connect to the next stage? What metadata travels? What does the next tool expect?}
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Skill/Tool Discovery
|
|
84
|
+
|
|
85
|
+
{Skills or tools that could enhance this workflow but don't exist yet.}
|
|
86
|
+
|
|
87
|
+
| Skill | When It Would Fire | What It Would Do |
|
|
88
|
+
|-------|-------------------|-----------------|
|
|
89
|
+
| {name} | {trigger} | {description} |
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## Edge Cases & Constraints
|
|
94
|
+
|
|
95
|
+
{What shouldn't this workflow do? When does it NOT apply? What happens with unexpected input?}
|
|
96
|
+
|
|
97
|
+
- {Edge case and how to handle it}
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## Design Decisions
|
|
102
|
+
|
|
103
|
+
1. **{Decision}**: {choice} — {rationale}
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## Open Questions
|
|
108
|
+
|
|
109
|
+
1. {Question}
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## Next Actions
|
|
114
|
+
|
|
115
|
+
- [ ] {First concrete step}
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## References
|
|
120
|
+
|
|
121
|
+
- {Links, related files, prior art}
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
*Last updated: {date}*
|