@williambeto/ai-workflow 1.19.0 → 2.1.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/CHANGELOG.md +56 -837
- package/PUBLISH_MANIFEST.json +34 -0
- package/README.md +70 -149
- package/{packages/ai-workflow/bin → bin}/ai-workflow.js +0 -0
- package/dist-assets/AGENTS.md +27 -0
- package/dist-assets/agents/astra.md +63 -0
- package/dist-assets/agents/atlas.md +169 -0
- package/dist-assets/agents/nexus.md +42 -0
- package/dist-assets/agents/orion.md +44 -0
- package/dist-assets/agents/phoenix.md +42 -0
- package/dist-assets/agents/sage.md +54 -0
- package/dist-assets/commands/README.md +14 -0
- package/dist-assets/commands/atlas.md +12 -0
- package/dist-assets/commands/audit.md +10 -0
- package/dist-assets/commands/deploy.md +12 -0
- package/dist-assets/commands/discover.md +10 -0
- package/dist-assets/commands/implement.md +28 -0
- package/dist-assets/commands/optimize-tokens.md +10 -0
- package/dist-assets/commands/plan.md +10 -0
- package/dist-assets/commands/release.md +12 -0
- package/dist-assets/commands/run.md +26 -0
- package/dist-assets/commands/spec-create.md +10 -0
- package/dist-assets/commands/spec-implement.md +10 -0
- package/dist-assets/commands/spec-review.md +10 -0
- package/dist-assets/commands/update-memory.md +10 -0
- package/dist-assets/commands/validate.md +12 -0
- package/dist-assets/docs/INDEX.md +21 -0
- package/dist-assets/docs/QUICKSTART.md +23 -0
- package/dist-assets/docs/adr/ADR-0000.md +19 -0
- package/dist-assets/docs/adr/ADR-0001.md +45 -0
- package/dist-assets/docs/adr/ADR-0002.md +62 -0
- package/dist-assets/docs/adr/ADR-0003.md +60 -0
- package/dist-assets/docs/adr/ADR-0004.md +71 -0
- package/dist-assets/docs/adr/ADR-0005.md +22 -0
- package/dist-assets/docs/adr/ADR-0006.md +82 -0
- package/dist-assets/docs/adr/ADR-0007.md +78 -0
- package/dist-assets/docs/api-engine-reference.md +7 -0
- package/{docs → dist-assets/docs}/architecture-policy.md +1 -1
- package/dist-assets/docs/cli-reference.md +27 -0
- package/dist-assets/docs/compatibility/provider-usage.md +38 -0
- package/dist-assets/docs/compatibility/runtime-matrix.md +30 -0
- package/dist-assets/docs/consumer-onboarding.md +17 -0
- package/dist-assets/docs/contributing-guide.md +11 -0
- package/{docs → dist-assets/docs}/design-patterns-policy.md +2 -2
- package/dist-assets/docs/full-documentation.md +113 -0
- package/{docs → dist-assets/docs}/npm-consumer-quickstart.md +18 -46
- package/dist-assets/docs/opencode-readme.md +8 -0
- package/dist-assets/docs/policies/01-BRANCH_GATE.md +63 -0
- package/dist-assets/docs/policies/02-SDD_METHODOLOGY.md +95 -0
- package/dist-assets/docs/policies/03-QUALITY_GATE.md +22 -0
- package/dist-assets/docs/policies/05-AGENT_CONTRACT.md +7 -0
- package/dist-assets/docs/policies/06-FINAL_EVIDENCE_CONTRACT.md +31 -0
- package/dist-assets/docs/policies/07-RELEASE_GATE.md +47 -0
- package/dist-assets/docs/policies/08-PRODUCT_TRUTHFULNESS_AND_PROJECT_DOCS.md +18 -0
- package/dist-assets/docs/policies/09-SPEC_VISIBILITY_AND_PUBLICATION.md +28 -0
- package/dist-assets/docs/policies/10-BEHAVIORAL_CONTRACT_HARDENING.md +9 -0
- package/dist-assets/docs/policies/11-EXECUTABLE_DELEGATION_AND_TRUTHFULNESS.md +7 -0
- package/dist-assets/docs/policies/ORCHESTRATION_PROTOCOL.md +15 -0
- package/dist-assets/docs/policies/PROCEDURE_DELIVERY_ARTIFACTS.md +21 -0
- package/dist-assets/docs/policies/PROCEDURE_DOCUMENTATION_CHECKLIST.md +24 -0
- package/dist-assets/docs/policies/PROCEDURE_UI_CHECKLIST.md +54 -0
- package/dist-assets/docs/profiles/README.md +19 -0
- package/dist-assets/docs/profiles/backend-api.md +5 -0
- package/dist-assets/docs/profiles/documentation.md +3 -0
- package/dist-assets/docs/profiles/frontend-product.md +19 -0
- package/dist-assets/docs/profiles/frontend-utility.md +19 -0
- package/dist-assets/docs/profiles/refactor.md +3 -0
- package/dist-assets/docs/profiles/security-review.md +3 -0
- package/dist-assets/docs/references/frontend-quality/landing-page-quality-checklist.md +11 -0
- package/dist-assets/docs/references/frontend-quality/product-copy-truthfulness.md +7 -0
- package/dist-assets/docs/references/frontend-quality/quality-failure-examples.md +20 -0
- package/dist-assets/docs/references/frontend-quality/visual-composition-patterns.md +10 -0
- package/dist-assets/docs/specs/runtime-operational-contract.md +39 -0
- package/dist-assets/docs/troubleshooting-guide.md +21 -0
- package/dist-assets/examples/README.md +10 -0
- package/dist-assets/examples/autopilot-cycle/00-CONTEXT.md +3 -0
- package/dist-assets/examples/autopilot-cycle/01-requirement.md +16 -0
- package/dist-assets/examples/autopilot-cycle/02-gate-a-check.md +23 -0
- package/dist-assets/examples/autopilot-cycle/03-orion-planning.md +20 -0
- package/dist-assets/examples/autopilot-cycle/04-astra-implementation.md +17 -0
- package/dist-assets/examples/autopilot-cycle/05-sage-validation.md +15 -0
- package/dist-assets/examples/autopilot-cycle/06-phoenix-healing.md +12 -0
- package/dist-assets/examples/autopilot-cycle/07-orchestration-report.md +18 -0
- package/dist-assets/examples/backend-api/00-CONTEXT.md +12 -0
- package/dist-assets/examples/backend-api/01-requirement.md +19 -0
- package/dist-assets/examples/backend-api/02-functional-spec.md +20 -0
- package/dist-assets/examples/backend-api/03-technical-plan.md +15 -0
- package/dist-assets/examples/backend-api/04-pr-breakdown.md +10 -0
- package/dist-assets/examples/backend-api/05-execution-handoff.md +13 -0
- package/dist-assets/examples/backend-api/06-validation-report.md +11 -0
- package/dist-assets/examples/backend-api/07-orchestration-report.md +7 -0
- package/dist-assets/examples/blocked-scenarios/00-CONTEXT.md +9 -0
- package/dist-assets/examples/blocked-scenarios/01-branch-gate-block.md +12 -0
- package/dist-assets/examples/blocked-scenarios/02-quality-gate-block.md +13 -0
- package/dist-assets/examples/blocked-scenarios/03-scope-creep-block.md +13 -0
- package/dist-assets/examples/blocked-scenarios/04-unblock-resolution.md +9 -0
- package/dist-assets/examples/blocked-scenarios/05-orchestration-decision-log.md +11 -0
- package/dist-assets/examples/bugfix-critical/00-CONTEXT.md +12 -0
- package/dist-assets/examples/bugfix-critical/01-bug-report.md +11 -0
- package/dist-assets/examples/bugfix-critical/02-diagnosis-hypothesis.md +11 -0
- package/dist-assets/examples/bugfix-critical/03-technical-plan.md +12 -0
- package/dist-assets/examples/bugfix-critical/04-implementation-handoff.md +8 -0
- package/dist-assets/examples/bugfix-critical/05-validation-report.md +10 -0
- package/dist-assets/examples/bugfix-critical/06-orchestration-report.md +7 -0
- package/dist-assets/examples/cli-package/00-CONTEXT.md +9 -0
- package/dist-assets/examples/cli-package/01-requirement.md +14 -0
- package/dist-assets/examples/cli-package/02-technical-spec.md +16 -0
- package/dist-assets/examples/cli-package/03-technical-plan.md +12 -0
- package/dist-assets/examples/cli-package/04-pr-breakdown.md +9 -0
- package/dist-assets/examples/cli-package/05-release-report.md +15 -0
- package/dist-assets/examples/docs-only-repo/01-requirement.md +31 -0
- package/dist-assets/examples/docs-only-repo/02-functional-spec.md +25 -0
- package/dist-assets/examples/docs-only-repo/03-technical-plan.md +21 -0
- package/dist-assets/examples/docs-only-repo/04-pr-breakdown.md +13 -0
- package/dist-assets/examples/docs-only-repo/05-execution-handoff.md +17 -0
- package/dist-assets/examples/docs-only-repo/06-validation-report.md +16 -0
- package/dist-assets/examples/docs-only-repo/README.md +26 -0
- package/dist-assets/examples/full-stack-checkout/00-CONTEXT.md +9 -0
- package/dist-assets/examples/full-stack-checkout/01-requirement.md +12 -0
- package/dist-assets/examples/full-stack-checkout/02-functional-spec.md +15 -0
- package/dist-assets/examples/full-stack-checkout/03-technical-plan.md +15 -0
- package/dist-assets/examples/full-stack-checkout/04-pr-breakdown.md +8 -0
- package/dist-assets/examples/full-stack-checkout/05-execution-handoff.md +14 -0
- package/dist-assets/examples/full-stack-checkout/06-validation-report.md +12 -0
- package/dist-assets/examples/healing-cycle/00-CONTEXT.md +15 -0
- package/dist-assets/examples/healing-cycle/01-broken-implementation.md +10 -0
- package/dist-assets/examples/healing-cycle/02-sage-fails.md +14 -0
- package/dist-assets/examples/healing-cycle/03-phoenix-diagnosis.md +17 -0
- package/dist-assets/examples/healing-cycle/04-phoenix-fix.md +18 -0
- package/dist-assets/examples/healing-cycle/05-sage-revalidation.md +12 -0
- package/dist-assets/examples/healing-cycle/06-orchestration-log.md +14 -0
- package/dist-assets/examples/infra-deploy/00-CONTEXT.md +9 -0
- package/dist-assets/examples/infra-deploy/01-operational-goal.md +12 -0
- package/dist-assets/examples/infra-deploy/02-architecture-specs.md +15 -0
- package/dist-assets/examples/infra-deploy/03-implementation-plan.md +14 -0
- package/dist-assets/examples/infra-deploy/04-step-breakdown.md +9 -0
- package/dist-assets/examples/infra-deploy/05-execution-handoff.md +13 -0
- package/dist-assets/examples/infra-deploy/06-operational-report.md +11 -0
- package/dist-assets/examples/multi-pr-release/00-CONTEXT.md +9 -0
- package/dist-assets/examples/multi-pr-release/01-requirement.md +13 -0
- package/dist-assets/examples/multi-pr-release/02-strategic-plan.md +13 -0
- package/dist-assets/examples/multi-pr-release/03-pr-breakdown.md +14 -0
- package/dist-assets/examples/multi-pr-release/04-release-plan.md +12 -0
- package/dist-assets/examples/multi-pr-release/05-orchestration-report.md +7 -0
- package/dist-assets/examples/nuxt-dashboard/01-requirement.md +81 -0
- package/dist-assets/examples/nuxt-dashboard/02-functional-spec.md +88 -0
- package/dist-assets/examples/nuxt-dashboard/03-technical-plan.md +76 -0
- package/dist-assets/examples/nuxt-dashboard/04-pr-breakdown.md +219 -0
- package/dist-assets/examples/nuxt-dashboard/05-execution-handoff.md +88 -0
- package/dist-assets/examples/nuxt-dashboard/06-validation-report.md +56 -0
- package/dist-assets/examples/nuxt-dashboard/07-orchestration-report.md +79 -0
- package/dist-assets/examples/nuxt-dashboard/README.md +52 -0
- package/dist-assets/examples/react-dashboard/01-requirement.md +84 -0
- package/dist-assets/examples/react-dashboard/02-functional-spec.md +88 -0
- package/dist-assets/examples/react-dashboard/03-technical-plan.md +76 -0
- package/dist-assets/examples/react-dashboard/04-pr-breakdown.md +218 -0
- package/dist-assets/examples/react-dashboard/05-execution-handoff.md +13 -0
- package/dist-assets/examples/react-dashboard/06-validation-report.md +12 -0
- package/dist-assets/examples/react-dashboard/07-orchestration-report.md +7 -0
- package/dist-assets/examples/react-dashboard/README.md +70 -0
- package/dist-assets/examples/refactoring-service/00-CONTEXT.md +9 -0
- package/dist-assets/examples/refactoring-service/01-debt-report.md +12 -0
- package/dist-assets/examples/refactoring-service/02-behavior-spec.md +11 -0
- package/dist-assets/examples/refactoring-service/03-technical-plan.md +13 -0
- package/dist-assets/examples/refactoring-service/04-pr-breakdown.md +9 -0
- package/dist-assets/examples/refactoring-service/05-execution-handoff.md +14 -0
- package/dist-assets/examples/refactoring-service/06-stability-report.md +12 -0
- package/dist-assets/examples/sdd-cycle/00-CONTEXT.md +12 -0
- package/dist-assets/examples/sdd-cycle/01-raw-request.md +13 -0
- package/dist-assets/examples/sdd-cycle/02-spec-creation.md +18 -0
- package/dist-assets/examples/sdd-cycle/03-spec-review.md +12 -0
- package/dist-assets/examples/sdd-cycle/04-technical-plan.md +16 -0
- package/dist-assets/examples/sdd-cycle/05-pr-breakdown.md +9 -0
- package/dist-assets/examples/sdd-cycle/06-spec-implement.md +13 -0
- package/dist-assets/examples/sdd-cycle/07-validation-against-spec.md +13 -0
- package/dist-assets/examples/wordpress-theme/01-requirement.md +29 -0
- package/dist-assets/examples/wordpress-theme/02-functional-spec.md +22 -0
- package/dist-assets/examples/wordpress-theme/03-technical-plan.md +22 -0
- package/dist-assets/examples/wordpress-theme/04-pr-breakdown.md +14 -0
- package/dist-assets/examples/wordpress-theme/05-execution-handoff.md +17 -0
- package/dist-assets/examples/wordpress-theme/06-validation-report.md +16 -0
- package/dist-assets/examples/wordpress-theme/README.md +32 -0
- package/{harness → dist-assets/harness}/handoffs/HANDOFF.template.md +2 -2
- package/{harness → dist-assets/harness}/workflows/agent-evaluation-checklist.md +5 -5
- package/{harness → dist-assets/harness}/workflows/implement-review-validate.md +24 -0
- package/{harness → dist-assets/harness}/workflows/multi-agent-handoff.md +4 -4
- package/{harness → dist-assets/harness}/workflows/planner-executor-workflow.md +5 -5
- package/{harness → dist-assets/harness}/workflows/requirement-to-pr.md +1 -1
- package/dist-assets/runbooks/agent-delegation-workflow.md +50 -0
- package/dist-assets/runbooks/apply-starter-to-real-project.md +45 -0
- package/dist-assets/runbooks/commands-cheatsheet.md +44 -0
- package/dist-assets/runbooks/how-to-use-skills.md +44 -0
- package/dist-assets/runbooks/private-spec-publication-safety.md +35 -0
- package/{runbooks → dist-assets/runbooks}/spec-driven-development.md +3 -6
- package/dist-assets/runbooks/tutorial-walkthroughs.md +23 -0
- package/dist-assets/runbooks/use-linear-for-operational-planning.md +45 -0
- package/dist-assets/runbooks/use-napkin-project-memory.md +33 -0
- package/dist-assets/skills/architecture/SKILL.md +166 -0
- package/dist-assets/skills/backend-development/SKILL.md +166 -0
- package/dist-assets/skills/deployment/SKILL.md +166 -0
- package/dist-assets/skills/design-principles/SKILL.md +166 -0
- package/dist-assets/skills/documentation/SKILL.md +171 -0
- package/dist-assets/skills/frontend-development/SKILL.md +225 -0
- package/dist-assets/skills/full-stack-development/SKILL.md +166 -0
- package/dist-assets/skills/optimize-tokens/SKILL.md +166 -0
- package/dist-assets/skills/pr-workflow/SKILL.md +166 -0
- package/dist-assets/skills/product-discovery/SKILL.md +166 -0
- package/dist-assets/skills/product-planning/SKILL.md +166 -0
- package/dist-assets/skills/project-memory/SKILL.md +166 -0
- package/dist-assets/skills/prompt-engineer/SKILL.md +166 -0
- package/dist-assets/skills/qa-workflow/SKILL.md +186 -0
- package/dist-assets/skills/refactoring/SKILL.md +166 -0
- package/dist-assets/skills/release-workflow/SKILL.md +166 -0
- package/dist-assets/skills/spec-driven-development/SKILL.md +166 -0
- package/dist-assets/skills/technical-leadership/SKILL.md +166 -0
- package/dist-assets/skills/ui-ux-design/SKILL.md +202 -0
- package/dist-assets/templates/.geminiignore.template +8 -0
- package/dist-assets/templates/CLAUDE.md.template +20 -0
- package/dist-assets/templates/CODEX.md.template +20 -0
- package/dist-assets/templates/GEMINI.md.template +20 -0
- package/dist-assets/templates/HANDOFF.template.md +45 -0
- package/dist-assets/templates/SPEC.template.md +38 -0
- package/dist-assets/templates/change-proposal.template.md +14 -0
- package/dist-assets/templates/owner-evidence/astra-implementation.json +10 -0
- package/dist-assets/templates/owner-evidence/phoenix-remediation.json +8 -0
- package/dist-assets/templates/owner-evidence/sage-revalidation.json +8 -0
- package/dist-assets/templates/owner-evidence/sage-validation.json +8 -0
- package/dist-assets/templates/specs/deep.md +48 -0
- package/dist-assets/templates/specs/standard.md +38 -0
- package/dist-assets/templates/specs/tiny.md +19 -0
- package/package.json +42 -47
- package/src/adapters/index.js +3 -0
- package/src/adapters/platforms/claude.js +126 -0
- package/src/adapters/platforms/codex.js +100 -0
- package/src/adapters/platforms/gemini.js +232 -0
- package/src/cli.js +96 -0
- package/src/commands/collect-evidence.js +61 -0
- package/src/commands/doctor.js +186 -0
- package/{packages/ai-workflow/src → src}/commands/init.js +119 -20
- package/src/commands/run.js +111 -0
- package/src/core/completion-contract.js +35 -0
- package/src/core/gates/branch-gate.js +113 -0
- package/src/core/handoff/handoff-engine.js +78 -0
- package/src/core/healing/cli-remediation-executor.js +151 -0
- package/src/core/healing/healer-engine.js +179 -0
- package/src/core/identity.js +43 -0
- package/{packages/ai-workflow/src → src}/core/install-plan.js +3 -3
- package/src/core/opencode-merge.js +149 -0
- package/{packages/ai-workflow/src → src}/core/package-assets.js +29 -10
- package/src/core/sdd/validator.js +67 -0
- package/src/core/statuses.js +29 -0
- package/src/core/symlink-layout.js +93 -0
- package/src/core/templates.js +218 -0
- package/src/core/validation/canonical-finalization.js +43 -0
- package/src/core/validation/evidence-collector.js +109 -0
- package/src/core/validation/quality-guard.js +243 -0
- package/src/core/workflow-profiles.js +107 -0
- package/.agents/napkin.md +0 -89
- package/.agents/skills/backend-implementer/SKILL.md +0 -490
- package/.agents/skills/build-and-validate/SKILL.md +0 -442
- package/.agents/skills/deploy-engineer/SKILL.md +0 -541
- package/.agents/skills/docs-writer/SKILL.md +0 -430
- package/.agents/skills/frontend-implementer/SKILL.md +0 -488
- package/.agents/skills/interface-design/SKILL.md +0 -428
- package/.agents/skills/interface-design/references/critique.md +0 -67
- package/.agents/skills/interface-design/references/example.md +0 -86
- package/.agents/skills/interface-design/references/principles.md +0 -235
- package/.agents/skills/interface-design/references/validation.md +0 -48
- package/.agents/skills/minimal-context/SKILL.md +0 -177
- package/.agents/skills/napkin/SKILL.md +0 -84
- package/.agents/skills/opencode-agent-design/SKILL.md +0 -77
- package/.agents/skills/playwright-cli/SKILL.md +0 -62
- package/.agents/skills/pr-orchestrator/SKILL.md +0 -366
- package/.agents/skills/product-manager/SKILL.md +0 -519
- package/.agents/skills/seo-audit/SKILL.md +0 -176
- package/.agents/skills/stack-variant-creator/SKILL.md +0 -265
- package/.agents/skills/tech-lead/SKILL.md +0 -453
- package/.agents/skills/tester/SKILL.md +0 -399
- package/.agents/skills/token-economy/SKILL.md +0 -137
- package/.agents/skills/vue-nuxt/SKILL.md +0 -102
- package/.agents/skills/wordpress-engineer/SKILL.md +0 -75
- package/.codex/prompts/README.md +0 -44
- package/.codex/prompts/autopilot.md +0 -50
- package/.codex/prompts/deploy.md +0 -33
- package/.codex/prompts/execute-selected-pr.md +0 -35
- package/.codex/prompts/fix-issue.md +0 -34
- package/.codex/prompts/minimal-context-mode.md +0 -55
- package/.codex/prompts/orchestrate-next.md +0 -33
- package/.codex/prompts/plan-from-requirement.md +0 -37
- package/.codex/prompts/review-implementation.md +0 -33
- package/.codex/prompts/roadmap-audit.md +0 -22
- package/.codex/prompts/specs/create-spec-from-requirement.md +0 -26
- package/.codex/prompts/specs/review-spec.md +0 -29
- package/.codex/prompts/specs/spec-to-pr-breakdown.md +0 -23
- package/.codex/prompts/specs/spec-to-technical-plan.md +0 -28
- package/.codex/prompts/start-project.md +0 -29
- package/.codex/prompts/token-economy-mode.md +0 -48
- package/.codex/prompts/validate-work.md +0 -28
- package/checklists/change-spec-readiness-checklist.md +0 -34
- package/docs/full-documentation.md +0 -661
- package/docs/setup-codex-opencode.md +0 -313
- package/harness/README.md +0 -106
- package/opencode/README.md +0 -84
- package/opencode/agents/README.md +0 -113
- package/opencode/agents/atlas.md +0 -127
- package/opencode/agents/discovery.md +0 -61
- package/opencode/agents/fixer.md +0 -51
- package/opencode/agents/implementer.md +0 -61
- package/opencode/agents/orchestrator.md +0 -145
- package/opencode/agents/planner.md +0 -60
- package/opencode/agents/prompt-engineer.md +0 -50
- package/opencode/agents/release-manager.md +0 -50
- package/opencode/agents/reviewer.md +0 -51
- package/opencode/agents/spec-engineer.md +0 -85
- package/opencode/agents/validator.md +0 -50
- package/opencode/agents/wordpress-engineer.md +0 -49
- package/opencode/commands/README.md +0 -48
- package/opencode/commands/autopilot.md +0 -50
- package/opencode/commands/deploy.md +0 -35
- package/opencode/commands/execute.md +0 -47
- package/opencode/commands/orchestrate.md +0 -37
- package/opencode/commands/plan.md +0 -39
- package/opencode/commands/review.md +0 -33
- package/opencode/commands/roadmap-audit.md +0 -30
- package/opencode/commands/ship.md +0 -48
- package/opencode/commands/specs/create-spec-from-request.md +0 -27
- package/opencode/commands/specs/create-spec-from-requirement.md +0 -25
- package/opencode/commands/specs/review-spec.md +0 -26
- package/opencode/commands/specs/spec-to-pr-breakdown.md +0 -19
- package/opencode/commands/specs/spec-to-tasks.md +0 -26
- package/opencode/commands/specs/spec-to-technical-plan.md +0 -27
- package/opencode/commands/start.md +0 -45
- package/opencode/commands/token-economy.md +0 -29
- package/opencode/commands/validate.md +0 -33
- package/opencode.jsonc +0 -235
- package/packages/ai-workflow/README.md +0 -82
- package/packages/ai-workflow/src/cli.js +0 -70
- package/packages/ai-workflow/src/commands/codex.js +0 -37
- package/packages/ai-workflow/src/commands/doctor.js +0 -168
- package/packages/ai-workflow/src/commands/guide.js +0 -194
- package/packages/ai-workflow/src/core/opencode-merge.js +0 -172
- package/packages/ai-workflow/src/core/symlink-layout.js +0 -54
- package/packages/ai-workflow/src/core/templates.js +0 -275
- package/runbooks/agent-delegation-workflow.md +0 -111
- package/runbooks/apply-starter-to-real-project.md +0 -445
- package/runbooks/commands-cheatsheet.md +0 -71
- package/runbooks/how-to-use-skills.md +0 -713
- package/runbooks/quick-start-guide.md +0 -213
- package/runbooks/tutorial-walkthroughs.md +0 -416
- package/runbooks/use-linear-for-operational-planning.md +0 -185
- package/runbooks/use-napkin-project-memory.md +0 -77
- package/templates/AGENTS.template.md +0 -397
- package/templates/DESIGN.template.md +0 -484
- package/templates/PR-PLAN.template.md +0 -172
- package/templates/README.template.md +0 -293
- package/templates/REQUIREMENT.template.md +0 -165
- package/templates/SPEC.template.md +0 -397
- package/templates/TECH-PLAN.template.md +0 -244
- package/templates/change-proposal.template.md +0 -97
- /package/{checklists/spec-readiness-checklist.md → dist-assets/docs/policies/SPEC_READINESS.md} +0 -0
- /package/{prompts → dist-assets/prompts}/00-bootstrap-project.md +0 -0
- /package/{prompts → dist-assets/prompts}/01-create-requirement.md +0 -0
- /package/{prompts → dist-assets/prompts}/02-create-spec.md +0 -0
- /package/{prompts → dist-assets/prompts}/03-create-tech-plan.md +0 -0
- /package/{prompts → dist-assets/prompts}/04-breakdown-prs.md +0 -0
- /package/{prompts → dist-assets/prompts}/05-implement-pr.md +0 -0
- /package/{prompts → dist-assets/prompts}/06-review-and-fix.md +0 -0
- /package/{prompts → dist-assets/prompts}/07-apply-design.md +0 -0
- /package/{prompts → dist-assets/prompts}/08-validate.md +0 -0
- /package/{prompts → dist-assets/prompts}/09-deploy.md +0 -0
- /package/{prompts → dist-assets/prompts}/commands/implement.md +0 -0
- /package/{prompts → dist-assets/prompts}/commands/requirement.md +0 -0
- /package/{prompts → dist-assets/prompts}/commands/spec.md +0 -0
- /package/{prompts → dist-assets/prompts}/commands/tech-plan.md +0 -0
- /package/{prompts → dist-assets/prompts}/commands/validate.md +0 -0
- /package/{runbooks → dist-assets/runbooks}/branch-cleanup.md +0 -0
- /package/{runbooks → dist-assets/runbooks}/deploy-checklist.md +0 -0
- /package/{runbooks → dist-assets/runbooks}/publication-readiness-checklist.md +0 -0
- /package/{runbooks → dist-assets/runbooks}/publish-package-checklist.md +0 -0
- /package/{runbooks → dist-assets/runbooks}/team-governance-pr-readiness.md +0 -0
- /package/{runbooks → dist-assets/runbooks}/validate-starter-in-real-project.md +0 -0
- /package/{runbooks → dist-assets/runbooks}/validation-checklist.md +0 -0
- /package/{schemas → dist-assets/schemas}/README.md +0 -0
- /package/{schemas → dist-assets/schemas}/functional-spec.schema.json +0 -0
- /package/{schemas → dist-assets/schemas}/handoff.schema.json +0 -0
- /package/{schemas → dist-assets/schemas}/pr-breakdown.schema.json +0 -0
- /package/{schemas → dist-assets/schemas}/requirement.schema.json +0 -0
- /package/{schemas → dist-assets/schemas}/technical-plan.schema.json +0 -0
- /package/{schemas → dist-assets/schemas}/validation-report.schema.json +0 -0
- /package/{packages/ai-workflow/src → src}/core/backup.js +0 -0
- /package/{packages/ai-workflow/src → src}/core/filesystem.js +0 -0
|
@@ -1,293 +0,0 @@
|
|
|
1
|
-
# [Project Name]
|
|
2
|
-
|
|
3
|
-
[Short description of what this repository is and what problem it solves.]
|
|
4
|
-
|
|
5
|
-
## Purpose
|
|
6
|
-
|
|
7
|
-
[Explain the purpose of this repository.]
|
|
8
|
-
|
|
9
|
-
This repository exists to:
|
|
10
|
-
|
|
11
|
-
- [Goal 1]
|
|
12
|
-
- [Goal 2]
|
|
13
|
-
- [Goal 3]
|
|
14
|
-
|
|
15
|
-
## Repository type
|
|
16
|
-
|
|
17
|
-
[Application / library / documentation repository / starter kit / workflow repository / learning repository / internal tool]
|
|
18
|
-
|
|
19
|
-
## Target users
|
|
20
|
-
|
|
21
|
-
This repository is intended for:
|
|
22
|
-
|
|
23
|
-
- [User type 1]
|
|
24
|
-
- [User type 2]
|
|
25
|
-
- [User type 3]
|
|
26
|
-
|
|
27
|
-
## Tech stack
|
|
28
|
-
|
|
29
|
-
| Area | Technology |
|
|
30
|
-
| --------------- | -------------------------------------- |
|
|
31
|
-
| Language | [Language] |
|
|
32
|
-
| Framework | [Framework] |
|
|
33
|
-
| Package manager | [npm / pnpm / yarn / composer / other] |
|
|
34
|
-
| Testing | [Test tool] |
|
|
35
|
-
| Build | [Build tool] |
|
|
36
|
-
| Deployment | [Deployment platform or method] |
|
|
37
|
-
|
|
38
|
-
Use `Not applicable` for areas that do not apply.
|
|
39
|
-
|
|
40
|
-
## Project status
|
|
41
|
-
|
|
42
|
-
Current status:
|
|
43
|
-
|
|
44
|
-
```txt
|
|
45
|
-
Draft | Active development | Stable | Experimental | Deprecated
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
## Repository structure
|
|
49
|
-
|
|
50
|
-
```txt
|
|
51
|
-
[project-name]/
|
|
52
|
-
├── [folder]/
|
|
53
|
-
├── [folder]/
|
|
54
|
-
├── [file]
|
|
55
|
-
└── README.md
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
## Main folders
|
|
59
|
-
|
|
60
|
-
### `[folder-name-1]/`
|
|
61
|
-
|
|
62
|
-
[Explain what this folder contains and when it should be used.]
|
|
63
|
-
|
|
64
|
-
### `[folder-name-2]/`
|
|
65
|
-
|
|
66
|
-
[Explain what this folder contains and when it should be used.]
|
|
67
|
-
|
|
68
|
-
### `[folder-name-3]/`
|
|
69
|
-
|
|
70
|
-
[Explain what this folder contains and when it should be used.]
|
|
71
|
-
|
|
72
|
-
## Getting started
|
|
73
|
-
|
|
74
|
-
### Prerequisites
|
|
75
|
-
|
|
76
|
-
- [Prerequisite 1]
|
|
77
|
-
- [Prerequisite 2]
|
|
78
|
-
- [Prerequisite 3]
|
|
79
|
-
|
|
80
|
-
### Installation
|
|
81
|
-
|
|
82
|
-
```bash
|
|
83
|
-
[install command]
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
### Development
|
|
87
|
-
|
|
88
|
-
```bash
|
|
89
|
-
[development command]
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
### Build
|
|
93
|
-
|
|
94
|
-
```bash
|
|
95
|
-
[build command]
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
### Test
|
|
99
|
-
|
|
100
|
-
```bash
|
|
101
|
-
[test command]
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
Use `Not applicable` if this repository does not require runtime setup.
|
|
105
|
-
|
|
106
|
-
## Environment variables
|
|
107
|
-
|
|
108
|
-
Create a local environment file if required.
|
|
109
|
-
|
|
110
|
-
```bash
|
|
111
|
-
cp .env.example .env
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
| Variable | Required | Description |
|
|
115
|
-
| --------------- | -------- | ------------- |
|
|
116
|
-
| `VARIABLE_NAME` | Yes / No | [Description] |
|
|
117
|
-
|
|
118
|
-
Do not commit real secrets.
|
|
119
|
-
|
|
120
|
-
Use `Not applicable` if this repository does not use environment variables.
|
|
121
|
-
|
|
122
|
-
## Workflow
|
|
123
|
-
|
|
124
|
-
[Explain the main workflow used in this repository.]
|
|
125
|
-
|
|
126
|
-
Recommended flow:
|
|
127
|
-
|
|
128
|
-
1. [Step 1]
|
|
129
|
-
2. [Step 2]
|
|
130
|
-
3. [Step 3]
|
|
131
|
-
4. [Step 4]
|
|
132
|
-
|
|
133
|
-
## Development rules
|
|
134
|
-
|
|
135
|
-
Contributors should follow these rules:
|
|
136
|
-
|
|
137
|
-
- preserve existing behavior unless a behavior change is explicitly requested;
|
|
138
|
-
- keep changes small and reviewable;
|
|
139
|
-
- avoid unrelated refactors;
|
|
140
|
-
- follow existing project patterns;
|
|
141
|
-
- validate changes before marking them ready;
|
|
142
|
-
- document assumptions and untested areas;
|
|
143
|
-
- do not commit secrets or private credentials.
|
|
144
|
-
|
|
145
|
-
## Documentation
|
|
146
|
-
|
|
147
|
-
Important documentation files:
|
|
148
|
-
|
|
149
|
-
| File | Purpose |
|
|
150
|
-
| ----------- | ------------------------------------ |
|
|
151
|
-
| `AGENTS.md` | Rules for AI agents and contributors |
|
|
152
|
-
| `DESIGN.md` | Visual design system and UI guidance |
|
|
153
|
-
| `[file].md` | [Purpose] |
|
|
154
|
-
|
|
155
|
-
Use `Not applicable` if the repository does not include these files.
|
|
156
|
-
|
|
157
|
-
## Validation
|
|
158
|
-
|
|
159
|
-
Before opening or approving a pull request, run the relevant checks.
|
|
160
|
-
|
|
161
|
-
```bash
|
|
162
|
-
[validation command]
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
Recommended validation checklist:
|
|
166
|
-
|
|
167
|
-
- [ ] Formatting checked
|
|
168
|
-
- [ ] Lint checked
|
|
169
|
-
- [ ] Typecheck checked
|
|
170
|
-
- [ ] Tests executed
|
|
171
|
-
- [ ] Build executed
|
|
172
|
-
- [ ] Manual validation completed
|
|
173
|
-
- [ ] Regression risks reviewed
|
|
174
|
-
- [ ] Untested areas documented
|
|
175
|
-
|
|
176
|
-
Use only the checks relevant to the project.
|
|
177
|
-
|
|
178
|
-
## Pull request workflow
|
|
179
|
-
|
|
180
|
-
Each pull request should include:
|
|
181
|
-
|
|
182
|
-
- clear objective;
|
|
183
|
-
- controlled scope;
|
|
184
|
-
- list of changed files;
|
|
185
|
-
- validation evidence;
|
|
186
|
-
- regression risks;
|
|
187
|
-
- out-of-scope items;
|
|
188
|
-
- final status.
|
|
189
|
-
|
|
190
|
-
Avoid combining unrelated changes in the same pull request.
|
|
191
|
-
|
|
192
|
-
## Deployment
|
|
193
|
-
|
|
194
|
-
Deployment method:
|
|
195
|
-
|
|
196
|
-
```txt
|
|
197
|
-
[Manual / CI/CD / hosting platform / package publish / not applicable]
|
|
198
|
-
```
|
|
199
|
-
|
|
200
|
-
Before deployment, verify:
|
|
201
|
-
|
|
202
|
-
- build passed;
|
|
203
|
-
- required tests passed;
|
|
204
|
-
- environment configuration is ready;
|
|
205
|
-
- secrets are configured safely;
|
|
206
|
-
- smoke tests are defined;
|
|
207
|
-
- rollback or recovery path is known.
|
|
208
|
-
|
|
209
|
-
Use `Not applicable` if this repository is not deployed.
|
|
210
|
-
|
|
211
|
-
## Security
|
|
212
|
-
|
|
213
|
-
Security rules:
|
|
214
|
-
|
|
215
|
-
- do not commit secrets;
|
|
216
|
-
- do not expose tokens, passwords, private keys, or credentials;
|
|
217
|
-
- keep environment-specific values out of source control;
|
|
218
|
-
- preserve authentication and authorization behavior;
|
|
219
|
-
- validate user input when relevant;
|
|
220
|
-
- avoid logging sensitive data.
|
|
221
|
-
|
|
222
|
-
## Troubleshooting
|
|
223
|
-
|
|
224
|
-
### [Problem 1]
|
|
225
|
-
|
|
226
|
-
Symptoms:
|
|
227
|
-
|
|
228
|
-
```txt
|
|
229
|
-
[Describe symptoms]
|
|
230
|
-
```
|
|
231
|
-
|
|
232
|
-
Cause:
|
|
233
|
-
|
|
234
|
-
```txt
|
|
235
|
-
[Likely cause]
|
|
236
|
-
```
|
|
237
|
-
|
|
238
|
-
Fix:
|
|
239
|
-
|
|
240
|
-
```bash
|
|
241
|
-
[Fix command or steps]
|
|
242
|
-
```
|
|
243
|
-
|
|
244
|
-
### [Problem 2]
|
|
245
|
-
|
|
246
|
-
Symptoms:
|
|
247
|
-
|
|
248
|
-
```txt
|
|
249
|
-
[Describe symptoms]
|
|
250
|
-
```
|
|
251
|
-
|
|
252
|
-
Cause:
|
|
253
|
-
|
|
254
|
-
```txt
|
|
255
|
-
[Likely cause]
|
|
256
|
-
```
|
|
257
|
-
|
|
258
|
-
Fix:
|
|
259
|
-
|
|
260
|
-
```bash
|
|
261
|
-
[Fix command or steps]
|
|
262
|
-
```
|
|
263
|
-
|
|
264
|
-
Use `Not applicable` if there are no known troubleshooting notes yet.
|
|
265
|
-
|
|
266
|
-
## Out of scope
|
|
267
|
-
|
|
268
|
-
This repository does not cover:
|
|
269
|
-
|
|
270
|
-
- [Out-of-scope item 1]
|
|
271
|
-
- [Out-of-scope item 2]
|
|
272
|
-
- [Out-of-scope item 3]
|
|
273
|
-
|
|
274
|
-
## Contributing
|
|
275
|
-
|
|
276
|
-
Before contributing:
|
|
277
|
-
|
|
278
|
-
1. read this `README.md`;
|
|
279
|
-
2. read `AGENTS.md` if available;
|
|
280
|
-
3. understand the current scope;
|
|
281
|
-
4. create or review the relevant requirement/spec/technical plan when needed;
|
|
282
|
-
5. keep the change small;
|
|
283
|
-
6. validate before requesting review.
|
|
284
|
-
|
|
285
|
-
## License
|
|
286
|
-
|
|
287
|
-
[License name]
|
|
288
|
-
|
|
289
|
-
Use `Not decided yet` if the license has not been chosen.
|
|
290
|
-
|
|
291
|
-
## Notes
|
|
292
|
-
|
|
293
|
-
[Any relevant project notes, assumptions, known limitations, or future improvements.]
|
|
@@ -1,165 +0,0 @@
|
|
|
1
|
-
# Requirement
|
|
2
|
-
|
|
3
|
-
## Title
|
|
4
|
-
|
|
5
|
-
[Short, clear title for the requirement]
|
|
6
|
-
|
|
7
|
-
## Status
|
|
8
|
-
|
|
9
|
-
Draft | Ready for spec | Needs clarification | Too broad | Not recommended
|
|
10
|
-
|
|
11
|
-
## Summary
|
|
12
|
-
|
|
13
|
-
[Short explanation of the requirement in one or two sentences]
|
|
14
|
-
|
|
15
|
-
## Problem
|
|
16
|
-
|
|
17
|
-
[Describe the problem that needs to be solved]
|
|
18
|
-
|
|
19
|
-
## Target user
|
|
20
|
-
|
|
21
|
-
[Describe who is affected by this problem]
|
|
22
|
-
|
|
23
|
-
Examples:
|
|
24
|
-
|
|
25
|
-
- end user;
|
|
26
|
-
- admin user;
|
|
27
|
-
- developer;
|
|
28
|
-
- maintainer;
|
|
29
|
-
- support team;
|
|
30
|
-
- business stakeholder.
|
|
31
|
-
|
|
32
|
-
## Goal
|
|
33
|
-
|
|
34
|
-
[Describe the expected outcome]
|
|
35
|
-
|
|
36
|
-
The goal should explain what should improve after this requirement is delivered.
|
|
37
|
-
|
|
38
|
-
## Current behavior
|
|
39
|
-
|
|
40
|
-
[Describe what happens today]
|
|
41
|
-
|
|
42
|
-
Use `Not applicable` if this is a new project or a new feature with no existing behavior.
|
|
43
|
-
|
|
44
|
-
## Desired behavior
|
|
45
|
-
|
|
46
|
-
[Describe what should happen after the requirement is implemented]
|
|
47
|
-
|
|
48
|
-
## Scope
|
|
49
|
-
|
|
50
|
-
### Included
|
|
51
|
-
|
|
52
|
-
- [Item included in this requirement]
|
|
53
|
-
- [Item included in this requirement]
|
|
54
|
-
|
|
55
|
-
### Not included
|
|
56
|
-
|
|
57
|
-
- [Item explicitly out of scope]
|
|
58
|
-
- [Item explicitly out of scope]
|
|
59
|
-
|
|
60
|
-
## Priority classification
|
|
61
|
-
|
|
62
|
-
### Must-have
|
|
63
|
-
|
|
64
|
-
Required for the requirement to be considered complete.
|
|
65
|
-
|
|
66
|
-
- [Must-have item]
|
|
67
|
-
|
|
68
|
-
### Should-have
|
|
69
|
-
|
|
70
|
-
Important, but can be delayed if needed.
|
|
71
|
-
|
|
72
|
-
- [Should-have item]
|
|
73
|
-
|
|
74
|
-
### Could-have
|
|
75
|
-
|
|
76
|
-
Useful, but not required for the first version.
|
|
77
|
-
|
|
78
|
-
- [Could-have item]
|
|
79
|
-
|
|
80
|
-
### Won't-have
|
|
81
|
-
|
|
82
|
-
Explicitly out of scope for now.
|
|
83
|
-
|
|
84
|
-
- [Won't-have item]
|
|
85
|
-
|
|
86
|
-
## User story
|
|
87
|
-
|
|
88
|
-
As a [type of user],
|
|
89
|
-
I want [capability],
|
|
90
|
-
so that [benefit].
|
|
91
|
-
|
|
92
|
-
## Acceptance criteria
|
|
93
|
-
|
|
94
|
-
### Scenario 1 — [Scenario name]
|
|
95
|
-
|
|
96
|
-
Given [context],
|
|
97
|
-
when [action],
|
|
98
|
-
then [expected result].
|
|
99
|
-
|
|
100
|
-
### Scenario 2 — [Scenario name]
|
|
101
|
-
|
|
102
|
-
Given [context],
|
|
103
|
-
when [action],
|
|
104
|
-
then [expected result].
|
|
105
|
-
|
|
106
|
-
## Business rules
|
|
107
|
-
|
|
108
|
-
- [Business rule 1]
|
|
109
|
-
- [Business rule 2]
|
|
110
|
-
|
|
111
|
-
Use `Not applicable` if there are no known business rules.
|
|
112
|
-
|
|
113
|
-
## Dependencies
|
|
114
|
-
|
|
115
|
-
- [Dependency 1]
|
|
116
|
-
- [Dependency 2]
|
|
117
|
-
|
|
118
|
-
Use `None known` if there are no known dependencies.
|
|
119
|
-
|
|
120
|
-
## Constraints
|
|
121
|
-
|
|
122
|
-
- [Technical, business, legal, security, compatibility, design, or delivery constraint]
|
|
123
|
-
|
|
124
|
-
Use `None known` if there are no known constraints.
|
|
125
|
-
|
|
126
|
-
## Assumptions
|
|
127
|
-
|
|
128
|
-
- [Assumption 1]
|
|
129
|
-
- [Assumption 2]
|
|
130
|
-
|
|
131
|
-
Assumptions must not be treated as confirmed facts.
|
|
132
|
-
|
|
133
|
-
## Open questions
|
|
134
|
-
|
|
135
|
-
- [Question 1]
|
|
136
|
-
- [Question 2]
|
|
137
|
-
|
|
138
|
-
Use `None` only when there are no relevant open questions.
|
|
139
|
-
|
|
140
|
-
## Risks
|
|
141
|
-
|
|
142
|
-
| Risk | Impact | Mitigation |
|
|
143
|
-
| -------- | -------- | ------------ |
|
|
144
|
-
| [Risk 1] | [Impact] | [Mitigation] |
|
|
145
|
-
| [Risk 2] | [Impact] | [Mitigation] |
|
|
146
|
-
|
|
147
|
-
## Success metrics
|
|
148
|
-
|
|
149
|
-
- [Metric 1]
|
|
150
|
-
- [Metric 2]
|
|
151
|
-
|
|
152
|
-
Use `Not applicable` if success metrics are not relevant for this requirement.
|
|
153
|
-
|
|
154
|
-
## Out of scope
|
|
155
|
-
|
|
156
|
-
- [Explicitly excluded item]
|
|
157
|
-
- [Explicitly excluded item]
|
|
158
|
-
|
|
159
|
-
## Notes
|
|
160
|
-
|
|
161
|
-
[Any useful context, examples, screenshots, links, previous decisions, or related references]
|
|
162
|
-
|
|
163
|
-
## Final recommendation
|
|
164
|
-
|
|
165
|
-
Ready for spec | Needs clarification | Too broad | Not recommended
|