@llipe.com/dev-tasks 0.10.0 → 0.16.1
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/agents/developer.md +108 -35
- package/.claude/agents/github-ops.md +48 -4
- package/.claude/agents/housekeeping.md +44 -7
- package/.claude/agents/qa-engineer.md +45 -3
- package/.claude/agents/researcher.md +116 -0
- package/.claude/agents/technical-writer.md +61 -6
- package/.claude/agents/ux-engineer.md +1 -0
- package/.claude/agents/verifier.md +48 -6
- package/.claude/commands/developer.md +2 -266
- package/.claude/commands/infra-engineer.md +92 -0
- package/.claude/commands/planner.md +64 -28
- package/.claude/commands/product-engineer.md +58 -19
- package/.claude/commands/researcher.md +27 -0
- package/.claude/commands/technical-writer.md +1 -1
- package/.claude/hooks/branch-guard.sh +30 -0
- package/.claude/hooks/git-guard.sh +483 -22
- package/.claude/skills/activity-codebase-research/SKILL.md +151 -0
- package/.claude/skills/activity-e2e-test-implementation/SKILL.md +156 -0
- package/.claude/skills/activity-generate-spec/SKILL.md +34 -10
- package/.claude/skills/activity-grill/SKILL.md +150 -0
- package/.claude/skills/activity-init/SKILL.md +121 -71
- package/.claude/skills/activity-integration-test-implementation/SKILL.md +156 -0
- package/.claude/skills/activity-refine/SKILL.md +75 -15
- package/.claude/skills/activity-test-standards/SKILL.md +66 -0
- package/.claude/skills/aws-ops/SKILL.md +155 -0
- package/.claude/skills/deploy-ops/SKILL.md +121 -0
- package/.claude/skills/fly-ops/SKILL.md +138 -0
- package/.claude/skills/git-ops/SKILL.md +27 -7
- package/.claude/skills/implement/SKILL.md +49 -4
- package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
- package/.claude/skills/memo-cli-usage/SKILL.md +66 -13
- package/.claude/skills/plan/SKILL.md +43 -1
- package/.claude/skills/supabase-ops/SKILL.md +109 -0
- package/.github/agents/developer.agent.md +80 -18
- package/.github/agents/github-ops.agent.md +46 -4
- package/.github/agents/housekeeping.agent.md +43 -7
- package/.github/agents/infra-engineer.agent.md +139 -0
- package/.github/agents/planner.agent.md +45 -9
- package/.github/agents/product-engineer.agent.md +58 -19
- package/.github/agents/qa-engineer.agent.md +43 -4
- package/.github/agents/researcher.agent.md +115 -0
- package/.github/agents/technical-writer.agent.md +60 -6
- package/.github/agents/verifier.agent.md +46 -5
- package/.github/instructions/implement.instructions.md +49 -4
- package/.github/instructions/plan.instructions.md +43 -1
- package/.github/prompts/infra-engineer.prompt.md +12 -0
- package/.github/prompts/product-engineer-init.prompt.md +5 -6
- package/.github/prompts/researcher.prompt.md +28 -0
- package/.github/prompts/technical-writer.prompt.md +1 -1
- package/.github/skills/activity-codebase-research/SKILL.md +146 -0
- package/.github/skills/activity-e2e-test-implementation/SKILL.md +156 -0
- package/.github/skills/activity-generate-spec/SKILL.md +34 -10
- package/.github/skills/activity-grill/SKILL.md +145 -0
- package/.github/skills/activity-init/SKILL.md +120 -70
- package/.github/skills/activity-integration-test-implementation/SKILL.md +156 -0
- package/.github/skills/activity-refine/SKILL.md +75 -15
- package/.github/skills/activity-test-standards/SKILL.md +66 -0
- package/.github/skills/aws-ops/SKILL.md +150 -0
- package/.github/skills/deploy-ops/SKILL.md +116 -0
- package/.github/skills/fly-ops/SKILL.md +133 -0
- package/.github/skills/git-ops/SKILL.md +27 -7
- package/.github/skills/memo-cli-usage/REFERENCE.md +230 -17
- package/.github/skills/memo-cli-usage/SKILL.md +66 -13
- package/.github/skills/supabase-ops/SKILL.md +104 -0
- package/.kiro/agents/developer.md +81 -19
- package/.kiro/agents/github-ops.md +46 -4
- package/.kiro/agents/housekeeping.md +44 -8
- package/.kiro/agents/infra-engineer.md +102 -0
- package/.kiro/agents/planner.md +53 -20
- package/.kiro/agents/product-engineer.md +61 -22
- package/.kiro/agents/qa-engineer.md +44 -5
- package/.kiro/agents/researcher.md +118 -0
- package/.kiro/agents/technical-writer.md +63 -9
- package/.kiro/agents/verifier.md +48 -7
- package/.kiro/skills/activity-codebase-research/SKILL.md +151 -0
- package/.kiro/skills/activity-e2e-test-implementation/SKILL.md +156 -0
- package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
- package/.kiro/skills/activity-grill/SKILL.md +150 -0
- package/.kiro/skills/activity-init/SKILL.md +121 -71
- package/.kiro/skills/activity-integration-test-implementation/SKILL.md +156 -0
- package/.kiro/skills/activity-refine/SKILL.md +75 -15
- package/.kiro/skills/activity-test-standards/SKILL.md +66 -0
- package/.kiro/skills/aws-ops/SKILL.md +155 -0
- package/.kiro/skills/deploy-ops/SKILL.md +121 -0
- package/.kiro/skills/fly-ops/SKILL.md +138 -0
- package/.kiro/skills/git-ops/SKILL.md +27 -7
- package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
- package/.kiro/skills/memo-cli-usage/SKILL.md +66 -13
- package/.kiro/skills/supabase-ops/SKILL.md +109 -0
- package/.kiro/steering/implement.md +49 -4
- package/.kiro/steering/plan.md +43 -1
- package/AGENTS.md +88 -261
- package/AGENTS.md.template +124 -0
- package/CHANGELOG.md +196 -0
- package/CLAUDE.md +24 -18
- package/CLAUDE.md.template +103 -0
- package/README.md +168 -145
- package/TESTING.md +84 -140
- package/bundle-manifest.json +43 -2
- package/dist/bin/dev-tasks.js +65 -3
- package/dist/bin/dev-tasks.js.map +1 -1
- package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
- package/dist/bin/parse-args.d.ts.map +1 -0
- package/dist/{adapters/cli → bin}/parse-args.js +2 -18
- package/dist/bin/parse-args.js.map +1 -0
- package/dist/core/checks/decision-log-format.d.ts +44 -0
- package/dist/core/checks/decision-log-format.d.ts.map +1 -0
- package/dist/core/checks/decision-log-format.js +171 -0
- package/dist/core/checks/decision-log-format.js.map +1 -0
- package/dist/core/checks/docs-structure.d.ts +82 -0
- package/dist/core/checks/docs-structure.d.ts.map +1 -0
- package/dist/core/checks/docs-structure.js +285 -0
- package/dist/core/checks/docs-structure.js.map +1 -0
- package/dist/core/checks/glossary.d.ts +178 -0
- package/dist/core/checks/glossary.d.ts.map +1 -0
- package/dist/core/checks/glossary.js +651 -0
- package/dist/core/checks/glossary.js.map +1 -0
- package/dist/core/checks/index.d.ts +19 -0
- package/dist/core/checks/index.d.ts.map +1 -0
- package/dist/core/checks/index.js +16 -0
- package/dist/core/checks/index.js.map +1 -0
- package/dist/core/checks/run.d.ts +22 -0
- package/dist/core/checks/run.d.ts.map +1 -0
- package/dist/core/checks/run.js +51 -0
- package/dist/core/checks/run.js.map +1 -0
- package/dist/core/distribution/doctor.d.ts +46 -1
- package/dist/core/distribution/doctor.d.ts.map +1 -1
- package/dist/core/distribution/doctor.js +161 -2
- package/dist/core/distribution/doctor.js.map +1 -1
- package/dist/core/distribution/index.d.ts +9 -3
- package/dist/core/distribution/index.d.ts.map +1 -1
- package/dist/core/distribution/index.js +5 -2
- package/dist/core/distribution/index.js.map +1 -1
- package/dist/core/distribution/install-if-absent.d.ts +46 -0
- package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
- package/dist/core/distribution/install-if-absent.js +81 -0
- package/dist/core/distribution/install-if-absent.js.map +1 -0
- package/dist/core/distribution/install.d.ts.map +1 -1
- package/dist/core/distribution/install.js +5 -0
- package/dist/core/distribution/install.js.map +1 -1
- package/dist/core/distribution/migrate-docs.d.ts +64 -0
- package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
- package/dist/core/distribution/migrate-docs.js +139 -0
- package/dist/core/distribution/migrate-docs.js.map +1 -0
- package/dist/core/distribution/profiles.d.ts +49 -0
- package/dist/core/distribution/profiles.d.ts.map +1 -1
- package/dist/core/distribution/profiles.js +45 -0
- package/dist/core/distribution/profiles.js.map +1 -1
- package/dist/core/distribution/update.d.ts +14 -0
- package/dist/core/distribution/update.d.ts.map +1 -1
- package/dist/core/distribution/update.js +77 -3
- package/dist/core/distribution/update.js.map +1 -1
- package/dist/core/distribution/workspace.d.ts +84 -0
- package/dist/core/distribution/workspace.d.ts.map +1 -0
- package/dist/core/distribution/workspace.js +276 -0
- package/dist/core/distribution/workspace.js.map +1 -0
- package/dist/core/exit-codes.d.ts +15 -35
- package/dist/core/exit-codes.d.ts.map +1 -1
- package/dist/core/exit-codes.js +15 -36
- package/dist/core/exit-codes.js.map +1 -1
- package/dist/core/index.d.ts +1 -6
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +1 -7
- package/dist/core/index.js.map +1 -1
- package/package.json +17 -32
- package/templates/claude/settings.json +48 -0
- package/templates/domain/ubiquitous-language.md +28 -0
- package/templates/infra/environments.yaml +16 -0
- package/templates/infra/redaction-patterns.txt +47 -0
- package/templates/runbooks/README.md +14 -0
- package/templates/runbooks/runbook-template.md +40 -0
- package/templates/scripts/deploy-status.sh +89 -0
- package/templates/scripts/deploy-verify.sh +85 -0
- package/templates/scripts/deploy.sh +284 -0
- package/templates/scripts/release.sh +170 -0
- package/templates/scripts/rollback.sh +109 -0
- package/templates/workflows/deploy-dev.yml +66 -0
- package/templates/workflows/deploy-prod.yml +66 -0
- package/templates/workflows/rollback.yml +77 -0
- package/dist/adapters/cli/catalog-build.d.ts +0 -30
- package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-build.js +0 -73
- package/dist/adapters/cli/catalog-build.js.map +0 -1
- package/dist/adapters/cli/catalog-query.d.ts +0 -13
- package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-query.js +0 -329
- package/dist/adapters/cli/catalog-query.js.map +0 -1
- package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
- package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-scaffold.js +0 -46
- package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
- package/dist/adapters/cli/catalog-validate.d.ts +0 -35
- package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
- package/dist/adapters/cli/catalog-validate.js +0 -122
- package/dist/adapters/cli/catalog-validate.js.map +0 -1
- package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
- package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
- package/dist/adapters/cli/ctx-assemble.js +0 -293
- package/dist/adapters/cli/ctx-assemble.js.map +0 -1
- package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
- package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
- package/dist/adapters/cli/ctx-fetch.js +0 -267
- package/dist/adapters/cli/ctx-fetch.js.map +0 -1
- package/dist/adapters/cli/extract-all.d.ts +0 -31
- package/dist/adapters/cli/extract-all.d.ts.map +0 -1
- package/dist/adapters/cli/extract-all.js +0 -374
- package/dist/adapters/cli/extract-all.js.map +0 -1
- package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
- package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
- package/dist/adapters/cli/extract-asyncapi.js +0 -142
- package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
- package/dist/adapters/cli/extract-component.d.ts +0 -24
- package/dist/adapters/cli/extract-component.d.ts.map +0 -1
- package/dist/adapters/cli/extract-component.js +0 -198
- package/dist/adapters/cli/extract-component.js.map +0 -1
- package/dist/adapters/cli/extract-detect.d.ts +0 -19
- package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
- package/dist/adapters/cli/extract-detect.js +0 -98
- package/dist/adapters/cli/extract-detect.js.map +0 -1
- package/dist/adapters/cli/extract-openapi.d.ts +0 -29
- package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
- package/dist/adapters/cli/extract-openapi.js +0 -111
- package/dist/adapters/cli/extract-openapi.js.map +0 -1
- package/dist/adapters/cli/extract-schema.d.ts +0 -15
- package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
- package/dist/adapters/cli/extract-schema.js +0 -39
- package/dist/adapters/cli/extract-schema.js.map +0 -1
- package/dist/adapters/cli/index.d.ts +0 -6
- package/dist/adapters/cli/index.d.ts.map +0 -1
- package/dist/adapters/cli/index.js +0 -5
- package/dist/adapters/cli/index.js.map +0 -1
- package/dist/adapters/cli/init.d.ts +0 -37
- package/dist/adapters/cli/init.d.ts.map +0 -1
- package/dist/adapters/cli/init.js +0 -336
- package/dist/adapters/cli/init.js.map +0 -1
- package/dist/adapters/cli/parse-args.d.ts.map +0 -1
- package/dist/adapters/cli/parse-args.js.map +0 -1
- package/dist/adapters/cli/scope-gate.d.ts +0 -25
- package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
- package/dist/adapters/cli/scope-gate.js +0 -157
- package/dist/adapters/cli/scope-gate.js.map +0 -1
- package/dist/adapters/cli/scope.d.ts +0 -26
- package/dist/adapters/cli/scope.d.ts.map +0 -1
- package/dist/adapters/cli/scope.js +0 -172
- package/dist/adapters/cli/scope.js.map +0 -1
- package/dist/adapters/cli/validate-component.d.ts +0 -24
- package/dist/adapters/cli/validate-component.d.ts.map +0 -1
- package/dist/adapters/cli/validate-component.js +0 -62
- package/dist/adapters/cli/validate-component.js.map +0 -1
- package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
- package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
- package/dist/adapters/cli/verify-contract-diff.js +0 -69
- package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
- package/dist/adapters/cli/verify-drift.d.ts +0 -24
- package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
- package/dist/adapters/cli/verify-drift.js +0 -103
- package/dist/adapters/cli/verify-drift.js.map +0 -1
- package/dist/adapters/cli/verify-impact.d.ts +0 -23
- package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
- package/dist/adapters/cli/verify-impact.js +0 -119
- package/dist/adapters/cli/verify-impact.js.map +0 -1
- package/dist/adapters/mcp/index.d.ts +0 -5
- package/dist/adapters/mcp/index.d.ts.map +0 -1
- package/dist/adapters/mcp/index.js +0 -2
- package/dist/adapters/mcp/index.js.map +0 -1
- package/dist/bin/dt.d.ts +0 -7
- package/dist/bin/dt.d.ts.map +0 -1
- package/dist/bin/dt.js +0 -647
- package/dist/bin/dt.js.map +0 -1
- package/dist/core/catalog/build.d.ts +0 -143
- package/dist/core/catalog/build.d.ts.map +0 -1
- package/dist/core/catalog/build.js +0 -475
- package/dist/core/catalog/build.js.map +0 -1
- package/dist/core/catalog/checks/index.d.ts +0 -18
- package/dist/core/catalog/checks/index.d.ts.map +0 -1
- package/dist/core/catalog/checks/index.js +0 -18
- package/dist/core/catalog/checks/index.js.map +0 -1
- package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
- package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
- package/dist/core/catalog/checks/v01-schema.js +0 -57
- package/dist/core/catalog/checks/v01-schema.js.map +0 -1
- package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
- package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
- package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
- package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
- package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
- package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
- package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
- package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
- package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
- package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
- package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
- package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
- package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
- package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
- package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
- package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
- package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
- package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
- package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
- package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
- package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
- package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
- package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
- package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
- package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
- package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
- package/dist/core/catalog/checks/v12-cycles.js +0 -28
- package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
- package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
- package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
- package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
- package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
- package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
- package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
- package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
- package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
- package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
- package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
- package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
- package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
- package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
- package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
- package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
- package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
- package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
- package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
- package/dist/core/catalog/checks/v18-low-payload.js +0 -33
- package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
- package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
- package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
- package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
- package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
- package/dist/core/catalog/coverage.d.ts +0 -39
- package/dist/core/catalog/coverage.d.ts.map +0 -1
- package/dist/core/catalog/coverage.js +0 -62
- package/dist/core/catalog/coverage.js.map +0 -1
- package/dist/core/catalog/graph.d.ts +0 -49
- package/dist/core/catalog/graph.d.ts.map +0 -1
- package/dist/core/catalog/graph.js +0 -114
- package/dist/core/catalog/graph.js.map +0 -1
- package/dist/core/catalog/index-model.d.ts +0 -96
- package/dist/core/catalog/index-model.d.ts.map +0 -1
- package/dist/core/catalog/index-model.js +0 -8
- package/dist/core/catalog/index-model.js.map +0 -1
- package/dist/core/catalog/index.d.ts +0 -5
- package/dist/core/catalog/index.d.ts.map +0 -1
- package/dist/core/catalog/index.js +0 -2
- package/dist/core/catalog/index.js.map +0 -1
- package/dist/core/catalog/queries.d.ts +0 -69
- package/dist/core/catalog/queries.d.ts.map +0 -1
- package/dist/core/catalog/queries.js +0 -165
- package/dist/core/catalog/queries.js.map +0 -1
- package/dist/core/catalog/resolve.d.ts +0 -47
- package/dist/core/catalog/resolve.d.ts.map +0 -1
- package/dist/core/catalog/resolve.js +0 -318
- package/dist/core/catalog/resolve.js.map +0 -1
- package/dist/core/catalog/scaffold.d.ts +0 -31
- package/dist/core/catalog/scaffold.d.ts.map +0 -1
- package/dist/core/catalog/scaffold.js +0 -141
- package/dist/core/catalog/scaffold.js.map +0 -1
- package/dist/core/catalog/validate-component.d.ts +0 -50
- package/dist/core/catalog/validate-component.d.ts.map +0 -1
- package/dist/core/catalog/validate-component.js +0 -105
- package/dist/core/catalog/validate-component.js.map +0 -1
- package/dist/core/catalog/validate.d.ts +0 -71
- package/dist/core/catalog/validate.d.ts.map +0 -1
- package/dist/core/catalog/validate.js +0 -103
- package/dist/core/catalog/validate.js.map +0 -1
- package/dist/core/context/assemble.d.ts +0 -126
- package/dist/core/context/assemble.d.ts.map +0 -1
- package/dist/core/context/assemble.js +0 -197
- package/dist/core/context/assemble.js.map +0 -1
- package/dist/core/context/cache.d.ts +0 -60
- package/dist/core/context/cache.d.ts.map +0 -1
- package/dist/core/context/cache.js +0 -236
- package/dist/core/context/cache.js.map +0 -1
- package/dist/core/context/exit-codes.d.ts +0 -28
- package/dist/core/context/exit-codes.d.ts.map +0 -1
- package/dist/core/context/exit-codes.js +0 -28
- package/dist/core/context/exit-codes.js.map +0 -1
- package/dist/core/context/fetch.d.ts +0 -55
- package/dist/core/context/fetch.d.ts.map +0 -1
- package/dist/core/context/fetch.js +0 -112
- package/dist/core/context/fetch.js.map +0 -1
- package/dist/core/context/index.d.ts +0 -11
- package/dist/core/context/index.d.ts.map +0 -1
- package/dist/core/context/index.js +0 -8
- package/dist/core/context/index.js.map +0 -1
- package/dist/core/context/init.d.ts +0 -179
- package/dist/core/context/init.d.ts.map +0 -1
- package/dist/core/context/init.js +0 -532
- package/dist/core/context/init.js.map +0 -1
- package/dist/core/context/layers/architecture-layer.d.ts +0 -13
- package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
- package/dist/core/context/layers/architecture-layer.js +0 -24
- package/dist/core/context/layers/architecture-layer.js.map +0 -1
- package/dist/core/context/layers/contracts-layer.d.ts +0 -13
- package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
- package/dist/core/context/layers/contracts-layer.js +0 -83
- package/dist/core/context/layers/contracts-layer.js.map +0 -1
- package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
- package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
- package/dist/core/context/layers/conventions-delta-layer.js +0 -37
- package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
- package/dist/core/context/layers/flow-layer.d.ts +0 -14
- package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
- package/dist/core/context/layers/flow-layer.js +0 -61
- package/dist/core/context/layers/flow-layer.js.map +0 -1
- package/dist/core/context/layers/index-layer.d.ts +0 -13
- package/dist/core/context/layers/index-layer.d.ts.map +0 -1
- package/dist/core/context/layers/index-layer.js +0 -77
- package/dist/core/context/layers/index-layer.js.map +0 -1
- package/dist/core/context/layers/primary-layer.d.ts +0 -16
- package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
- package/dist/core/context/layers/primary-layer.js +0 -61
- package/dist/core/context/layers/primary-layer.js.map +0 -1
- package/dist/core/context/layers/secondary-layer.d.ts +0 -19
- package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
- package/dist/core/context/layers/secondary-layer.js +0 -52
- package/dist/core/context/layers/secondary-layer.js.map +0 -1
- package/dist/core/context/session-lock.d.ts +0 -114
- package/dist/core/context/session-lock.d.ts.map +0 -1
- package/dist/core/context/session-lock.js +0 -90
- package/dist/core/context/session-lock.js.map +0 -1
- package/dist/core/context/tokens.d.ts +0 -35
- package/dist/core/context/tokens.d.ts.map +0 -1
- package/dist/core/context/tokens.js +0 -88
- package/dist/core/context/tokens.js.map +0 -1
- package/dist/core/extract/asyncapi/declared.d.ts +0 -19
- package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/declared.js +0 -168
- package/dist/core/extract/asyncapi/declared.js.map +0 -1
- package/dist/core/extract/asyncapi/index.d.ts +0 -12
- package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/index.js +0 -8
- package/dist/core/extract/asyncapi/index.js.map +0 -1
- package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
- package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/payloads.js +0 -421
- package/dist/core/extract/asyncapi/payloads.js.map +0 -1
- package/dist/core/extract/asyncapi/topics.d.ts +0 -27
- package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/topics.js +0 -368
- package/dist/core/extract/asyncapi/topics.js.map +0 -1
- package/dist/core/extract/asyncapi/types.d.ts +0 -129
- package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/types.js +0 -5
- package/dist/core/extract/asyncapi/types.js.map +0 -1
- package/dist/core/extract/asyncapi/validate.d.ts +0 -29
- package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
- package/dist/core/extract/asyncapi/validate.js +0 -156
- package/dist/core/extract/asyncapi/validate.js.map +0 -1
- package/dist/core/extract/component.d.ts +0 -204
- package/dist/core/extract/component.d.ts.map +0 -1
- package/dist/core/extract/component.js +0 -258
- package/dist/core/extract/component.js.map +0 -1
- package/dist/core/extract/detect.d.ts +0 -35
- package/dist/core/extract/detect.d.ts.map +0 -1
- package/dist/core/extract/detect.js +0 -89
- package/dist/core/extract/detect.js.map +0 -1
- package/dist/core/extract/index.d.ts +0 -12
- package/dist/core/extract/index.d.ts.map +0 -1
- package/dist/core/extract/index.js +0 -6
- package/dist/core/extract/index.js.map +0 -1
- package/dist/core/extract/ladder.d.ts +0 -79
- package/dist/core/extract/ladder.d.ts.map +0 -1
- package/dist/core/extract/ladder.js +0 -70
- package/dist/core/extract/ladder.js.map +0 -1
- package/dist/core/extract/openapi/index.d.ts +0 -43
- package/dist/core/extract/openapi/index.d.ts.map +0 -1
- package/dist/core/extract/openapi/index.js +0 -142
- package/dist/core/extract/openapi/index.js.map +0 -1
- package/dist/core/extract/openapi/route1.d.ts +0 -36
- package/dist/core/extract/openapi/route1.d.ts.map +0 -1
- package/dist/core/extract/openapi/route1.js +0 -333
- package/dist/core/extract/openapi/route1.js.map +0 -1
- package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
- package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
- package/dist/core/extract/openapi/route2-introspect.js +0 -249
- package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
- package/dist/core/extract/openapi/route2.d.ts +0 -69
- package/dist/core/extract/openapi/route2.d.ts.map +0 -1
- package/dist/core/extract/openapi/route2.js +0 -211
- package/dist/core/extract/openapi/route2.js.map +0 -1
- package/dist/core/extract/openapi/route3.d.ts +0 -26
- package/dist/core/extract/openapi/route3.d.ts.map +0 -1
- package/dist/core/extract/openapi/route3.js +0 -737
- package/dist/core/extract/openapi/route3.js.map +0 -1
- package/dist/core/extract/openapi/types.d.ts +0 -125
- package/dist/core/extract/openapi/types.d.ts.map +0 -1
- package/dist/core/extract/openapi/types.js +0 -5
- package/dist/core/extract/openapi/types.js.map +0 -1
- package/dist/core/extract/openapi/validate.d.ts +0 -29
- package/dist/core/extract/openapi/validate.d.ts.map +0 -1
- package/dist/core/extract/openapi/validate.js +0 -200
- package/dist/core/extract/openapi/validate.js.map +0 -1
- package/dist/core/extract/orm/drizzle.d.ts +0 -20
- package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
- package/dist/core/extract/orm/drizzle.js +0 -283
- package/dist/core/extract/orm/drizzle.js.map +0 -1
- package/dist/core/extract/orm/information-schema.d.ts +0 -26
- package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
- package/dist/core/extract/orm/information-schema.js +0 -142
- package/dist/core/extract/orm/information-schema.js.map +0 -1
- package/dist/core/extract/orm/prisma.d.ts +0 -23
- package/dist/core/extract/orm/prisma.d.ts.map +0 -1
- package/dist/core/extract/orm/prisma.js +0 -234
- package/dist/core/extract/orm/prisma.js.map +0 -1
- package/dist/core/extract/orm/typeorm.d.ts +0 -22
- package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
- package/dist/core/extract/orm/typeorm.js +0 -269
- package/dist/core/extract/orm/typeorm.js.map +0 -1
- package/dist/core/extract/orm/types.d.ts +0 -97
- package/dist/core/extract/orm/types.d.ts.map +0 -1
- package/dist/core/extract/orm/types.js +0 -6
- package/dist/core/extract/orm/types.js.map +0 -1
- package/dist/core/extract/prompt.d.ts +0 -21
- package/dist/core/extract/prompt.d.ts.map +0 -1
- package/dist/core/extract/prompt.js +0 -79
- package/dist/core/extract/prompt.js.map +0 -1
- package/dist/core/extract/provider.d.ts +0 -121
- package/dist/core/extract/provider.d.ts.map +0 -1
- package/dist/core/extract/provider.js +0 -6
- package/dist/core/extract/provider.js.map +0 -1
- package/dist/core/extract/providers/node-ts.d.ts +0 -69
- package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
- package/dist/core/extract/providers/node-ts.js +0 -320
- package/dist/core/extract/providers/node-ts.js.map +0 -1
- package/dist/core/extract/render/schema-md.d.ts +0 -16
- package/dist/core/extract/render/schema-md.d.ts.map +0 -1
- package/dist/core/extract/render/schema-md.js +0 -140
- package/dist/core/extract/render/schema-md.js.map +0 -1
- package/dist/core/extract/report.d.ts +0 -125
- package/dist/core/extract/report.d.ts.map +0 -1
- package/dist/core/extract/report.js +0 -52
- package/dist/core/extract/report.js.map +0 -1
- package/dist/core/extract/schema.d.ts +0 -34
- package/dist/core/extract/schema.d.ts.map +0 -1
- package/dist/core/extract/schema.js +0 -146
- package/dist/core/extract/schema.js.map +0 -1
- package/dist/core/extract/workspaces.d.ts +0 -33
- package/dist/core/extract/workspaces.d.ts.map +0 -1
- package/dist/core/extract/workspaces.js +0 -193
- package/dist/core/extract/workspaces.js.map +0 -1
- package/dist/core/providers/index.d.ts +0 -6
- package/dist/core/providers/index.d.ts.map +0 -1
- package/dist/core/providers/index.js +0 -2
- package/dist/core/providers/index.js.map +0 -1
- package/dist/core/providers/tracker.d.ts +0 -74
- package/dist/core/providers/tracker.d.ts.map +0 -1
- package/dist/core/providers/tracker.js +0 -38
- package/dist/core/providers/tracker.js.map +0 -1
- package/dist/core/scope/calibration.d.ts +0 -25
- package/dist/core/scope/calibration.d.ts.map +0 -1
- package/dist/core/scope/calibration.js +0 -52
- package/dist/core/scope/calibration.js.map +0 -1
- package/dist/core/scope/closure.d.ts +0 -31
- package/dist/core/scope/closure.d.ts.map +0 -1
- package/dist/core/scope/closure.js +0 -68
- package/dist/core/scope/closure.js.map +0 -1
- package/dist/core/scope/gate.d.ts +0 -41
- package/dist/core/scope/gate.d.ts.map +0 -1
- package/dist/core/scope/gate.js +0 -165
- package/dist/core/scope/gate.js.map +0 -1
- package/dist/core/scope/index.d.ts +0 -18
- package/dist/core/scope/index.d.ts.map +0 -1
- package/dist/core/scope/index.js +0 -12
- package/dist/core/scope/index.js.map +0 -1
- package/dist/core/scope/partition.d.ts +0 -36
- package/dist/core/scope/partition.d.ts.map +0 -1
- package/dist/core/scope/partition.js +0 -78
- package/dist/core/scope/partition.js.map +0 -1
- package/dist/core/scope/prompt.d.ts +0 -39
- package/dist/core/scope/prompt.d.ts.map +0 -1
- package/dist/core/scope/prompt.js +0 -123
- package/dist/core/scope/prompt.js.map +0 -1
- package/dist/core/scope/scoping.d.ts +0 -52
- package/dist/core/scope/scoping.d.ts.map +0 -1
- package/dist/core/scope/scoping.js +0 -99
- package/dist/core/scope/scoping.js.map +0 -1
- package/dist/core/scope/types.d.ts +0 -77
- package/dist/core/scope/types.d.ts.map +0 -1
- package/dist/core/scope/types.js +0 -5
- package/dist/core/scope/types.js.map +0 -1
- package/dist/core/scope/validate.d.ts +0 -47
- package/dist/core/scope/validate.d.ts.map +0 -1
- package/dist/core/scope/validate.js +0 -90
- package/dist/core/scope/validate.js.map +0 -1
- package/dist/core/verify/asyncapi-diff.d.ts +0 -34
- package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
- package/dist/core/verify/asyncapi-diff.js +0 -209
- package/dist/core/verify/asyncapi-diff.js.map +0 -1
- package/dist/core/verify/contract-diff.d.ts +0 -39
- package/dist/core/verify/contract-diff.d.ts.map +0 -1
- package/dist/core/verify/contract-diff.js +0 -63
- package/dist/core/verify/contract-diff.js.map +0 -1
- package/dist/core/verify/drift.d.ts +0 -47
- package/dist/core/verify/drift.d.ts.map +0 -1
- package/dist/core/verify/drift.js +0 -122
- package/dist/core/verify/drift.js.map +0 -1
- package/dist/core/verify/impact.d.ts +0 -22
- package/dist/core/verify/impact.d.ts.map +0 -1
- package/dist/core/verify/impact.js +0 -93
- package/dist/core/verify/impact.js.map +0 -1
- package/dist/core/verify/index.d.ts +0 -10
- package/dist/core/verify/index.d.ts.map +0 -1
- package/dist/core/verify/index.js +0 -9
- package/dist/core/verify/index.js.map +0 -1
- package/dist/core/verify/openapi-diff.d.ts +0 -29
- package/dist/core/verify/openapi-diff.d.ts.map +0 -1
- package/dist/core/verify/openapi-diff.js +0 -291
- package/dist/core/verify/openapi-diff.js.map +0 -1
- package/dist/core/verify/types.d.ts +0 -138
- package/dist/core/verify/types.d.ts.map +0 -1
- package/dist/core/verify/types.js +0 -5
- package/dist/core/verify/types.js.map +0 -1
- package/schemas/component.schema.json +0 -203
- package/schemas/flow.schema.json +0 -75
- package/schemas/scope-output.schema.json +0 -62
package/.kiro/steering/plan.md
CHANGED
|
@@ -65,7 +65,7 @@ The task list **MUST** follow this structure:
|
|
|
65
65
|
|
|
66
66
|
- [ ] 1.0 Implement Story [ID]: [Story Title] (or: Implement Issue [#] - [Github_Issue_URL]: [Title])
|
|
67
67
|
|
|
68
|
-
- [ ] 1.1 [First implementation step]
|
|
68
|
+
- [ ] 1.1 [First implementation step] (D-NN, when traceable — omit otherwise)
|
|
69
69
|
- [ ] 1.2 [Second implementation step]
|
|
70
70
|
- [ ] 1.x Verify Acceptance Criterion: [Criterion 1]
|
|
71
71
|
- [ ] 1.y Verify Acceptance Criterion: [Criterion 2]
|
|
@@ -74,8 +74,48 @@ The task list **MUST** follow this structure:
|
|
|
74
74
|
- [ ] 2.0 Implement Story [ID]: [Story Title] (or: Implement Issue [#] - [Github_Issue_URL]: [Title])
|
|
75
75
|
- [ ] 2.1 [First implementation step]
|
|
76
76
|
- ...
|
|
77
|
+
|
|
78
|
+
## Decisions Consumed
|
|
79
|
+
|
|
80
|
+
| ID | Decision (short form) |
|
|
81
|
+
| ---- | --------------------- |
|
|
82
|
+
| D-NN | … |
|
|
77
83
|
```
|
|
78
84
|
|
|
85
|
+
## Decision Citations
|
|
86
|
+
|
|
87
|
+
A task line that derives from a specific decision cites it inline, at the
|
|
88
|
+
end of the line: `- [ ] 3.2 Add cap-reached prompt (D-55)` (FR-16).
|
|
89
|
+
|
|
90
|
+
- Citations reference the feature's own `decisions-<feature>.md` by
|
|
91
|
+
unqualified `D-NN` — a task list belongs to exactly one feature, so the
|
|
92
|
+
qualified `<feature>#D-NN` form `activity-refine`/`activity-generate-spec`
|
|
93
|
+
use for cross-feature reuse is never needed here.
|
|
94
|
+
- This is **additive only**: a task with no traceable decision cites none.
|
|
95
|
+
You **MUST NOT** fabricate a citation to give a task one.
|
|
96
|
+
- The task list closes with a `## Decisions Consumed` section aggregating
|
|
97
|
+
every decision ID cited anywhere in the list, in the same `ID | Decision
|
|
98
|
+
(short form)` table shape the decision log itself uses. A task list that
|
|
99
|
+
cites no decisions still includes the section, empty (header plus
|
|
100
|
+
table skeleton, no rows) — consistent with how `activity-refine`'s and
|
|
101
|
+
`activity-generate-spec`'s own `## Decisions` sections may legitimately
|
|
102
|
+
be empty.
|
|
103
|
+
|
|
104
|
+
## Package Attribution
|
|
105
|
+
|
|
106
|
+
Every task **MUST** name the package it changes (FR-63), so a reader can
|
|
107
|
+
tell the blast radius from the task list without opening the diff.
|
|
108
|
+
|
|
109
|
+
- Read the package map in `docs/tech.md` for the package list.
|
|
110
|
+
- Write the package in the sub-task text, in brackets, first:
|
|
111
|
+
`- [ ] 1.1 [@acme/api] Add the token-refresh endpoint`.
|
|
112
|
+
- A sub-task touching several packages lists them all. A sub-task that
|
|
113
|
+
touches _most_ packages is usually the wrong size — split it.
|
|
114
|
+
- In a **single-package repository the bracket is omitted**, not left
|
|
115
|
+
empty. It is optional there, never blank.
|
|
116
|
+
- Non-code tasks (docs, workflow files) that belong to no package use
|
|
117
|
+
`[repo root]`.
|
|
118
|
+
|
|
79
119
|
## Conversion Guidelines
|
|
80
120
|
|
|
81
121
|
When converting a **User Story** or **Refined Issue** to a **Parent Task**:
|
|
@@ -94,6 +134,7 @@ When converting a **User Story** or **Refined Issue** to a **Parent Task**:
|
|
|
94
134
|
- If schema or data-model changes are involved, migration tasks are **required by default**; omission is allowed only with an explicit documented opt-out rationale.
|
|
95
135
|
- Migration flows **MUST** include: create migration artifact, document rollback/impact, request user confirmation before apply, apply migration after confirmation, and verify applied state.
|
|
96
136
|
- If the story involves data models, you **SHOULD** include a sub-task to generate seed data.
|
|
137
|
+
- When `workstream/decisions-<feature>.md` exists, you **MUST** cite the decision ID inline (`… (D-NN)`) on any sub-task whose approach or scope traces to a specific decision row, and **MUST** populate the closing `## Decisions Consumed` section with every ID cited anywhere in the list. This is additive only — a sub-task with no traceable decision cites none; do not fabricate a citation.
|
|
97
138
|
|
|
98
139
|
3. **Context:** You **MAY** add a `> Note:` block under the parent task for quick reference (User Story text or Business Rules), but the checkbox structure **MUST** remain clean.
|
|
99
140
|
4. **Relevant Files:** You **MUST** aggregate all "Files to Create/Modify" from selected stories into the top-level `Relevant Files` section.
|
|
@@ -139,6 +180,7 @@ If this is a **greenfield project** or a **new component**, you **MUST** include
|
|
|
139
180
|
5. You **MUST** ensure all Implementation Steps, Acceptance Criteria, and Testing requirements are preserved as sub-tasks.
|
|
140
181
|
6. For JS/TS repositories, you **MUST** prefer `pnpm` commands and canonical script names in generated tasks.
|
|
141
182
|
7. You **MUST** ensure each task includes both implementation and test/validation steps, including edge-case validation.
|
|
183
|
+
7a. When a decision log exists for the feature, you **MUST** cite the decision ID inline on any traceable sub-task and populate the closing `## Decisions Consumed` section (FR-16) — additively, never fabricated.
|
|
142
184
|
8. For schema/data-model changes, you **MUST** include migration lifecycle tasks and an explicit user-confirmation gate before applying migrations unless an opt-out rationale is documented.
|
|
143
185
|
9. You **MUST** update the corresponding GitHub Issue(s) with the task checklist by delegating to `github-ops` whenever possible. If no issue exists, you **MUST** ask the user whether to create one first.
|
|
144
186
|
10. You **MUST** save the task list file.
|
package/AGENTS.md
CHANGED
|
@@ -1,297 +1,124 @@
|
|
|
1
1
|
# dev-tasks
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Portable, repo-installed workflow harness for structured, PRD-driven AI-assisted development. Agents orchestrate the workflow end-to-end with branch discipline, test-first design, and GitHub-as-source-of-truth.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Contracts
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
| File | Owner | Purpose |
|
|
8
|
+
| ------------- | ------------- | ---------------------------------------------- |
|
|
9
|
+
| `/DESIGN.md` | `ux-engineer` | Canonical design-system tokens and UI guidance |
|
|
10
|
+
| `/TESTING.md` | `qa-engineer` | Layer taxonomy, runners, thresholds, fixtures |
|
|
8
11
|
|
|
9
|
-
|
|
10
|
-
- Breaking requirements into actionable, implementation-ready tasks
|
|
11
|
-
- Guiding the AI to tackle one task at a time with checkpoints for review
|
|
12
|
-
- Providing specialized **agents** that orchestrate the workflow end-to-end
|
|
13
|
-
- Enforcing documentation, branch discipline, and GitHub-as-source-of-truth
|
|
14
|
-
- Standardizing visual design decisions through `/DESIGN.md` as the canonical UI contract
|
|
15
|
-
- **Test-first design as the default**: `verifier` (Design Mode) produces compliance test plans before implementation, and `developer` writes tests before code
|
|
12
|
+
If `/DESIGN.md` is missing and scope includes UI work, agents **MUST** create a baseline before finalizing design-dependent outputs. An unfilled `/TESTING.md` placeholder means "no standard established", never permission.
|
|
16
13
|
|
|
17
|
-
##
|
|
14
|
+
## Taxonomy
|
|
18
15
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
- `planner` **MUST** require DESIGN.md compliance in UI-impacting delegated runs.
|
|
25
|
-
|
|
26
|
-
If `/DESIGN.md` is missing and the requested scope includes UI work, agents **MUST** create a baseline DESIGN.md before finalizing design-dependent outputs.
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
## Testing Standard Contract (TESTING.md)
|
|
31
|
-
|
|
32
|
-
`/TESTING.md` is the canonical testing contract for a repository. It declares the layer taxonomy and what belongs at each layer, the per-package runner and commands, coverage thresholds and baseline policy, the fixture and mocking strategy, and the mandatory security-negative cases.
|
|
33
|
-
|
|
34
|
-
- `qa-engineer` **OWNS** `/TESTING.md` and fills it per project via `activity-test-standards`.
|
|
35
|
-
- `developer` **MUST** keep it current when the testing contract changes.
|
|
36
|
-
- Agents that read it **MUST** treat an unfilled placeholder as "no standard established", never as permission.
|
|
37
|
-
- The contract is **per-package**: a repository mixing languages (for example vitest and pytest) **MUST** be describable without forcing every package into one language's script names.
|
|
38
|
-
|
|
39
|
-
It ships with dev-tasks as a placeholder and is listed in `consumer_owned_paths`, so `dev-tasks update` never overwrites a filled version.
|
|
40
|
-
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
## Taxonomy: Agent vs Skill vs Instruction
|
|
44
|
-
|
|
45
|
-
| Concept | Purpose | Loaded When |
|
|
46
|
-
| --------------- | ----------------------------------------------------------- | ---------------------------- |
|
|
47
|
-
| **Agent** | Autonomous role with decision-making and handoff discipline | Invoked by name (`@agent`) |
|
|
48
|
-
| **Skill** | Reusable on-demand capability (procedures/activities) | On demand (invoked by agent) |
|
|
49
|
-
| **Instruction** | Scoped rule enforced automatically for matching context | Auto-applied by runtime |
|
|
50
|
-
|
|
51
|
-
---
|
|
16
|
+
| Concept | Purpose | Loaded When |
|
|
17
|
+
| --------------- | -------------------------------------------- | ----------------------- |
|
|
18
|
+
| **Agent** | Autonomous role with decisions and handoffs | Invoked by name |
|
|
19
|
+
| **Skill** | Reusable on-demand procedure | On demand by agent |
|
|
20
|
+
| **Instruction** | Scoped rule auto-applied to matching context | Auto-applied by runtime |
|
|
52
21
|
|
|
53
22
|
## Agents
|
|
54
23
|
|
|
55
|
-
| Agent |
|
|
56
|
-
| -------------------- |
|
|
57
|
-
| **product-engineer** |
|
|
58
|
-
| **developer** |
|
|
59
|
-
| **planner** |
|
|
60
|
-
| **technical-writer** |
|
|
61
|
-
| **housekeeping** |
|
|
62
|
-
| **github-ops** |
|
|
63
|
-
| **ux-engineer** |
|
|
64
|
-
| **qa-engineer** |
|
|
65
|
-
| **
|
|
66
|
-
|
|
67
|
-
|
|
24
|
+
| Agent | Purpose |
|
|
25
|
+
| -------------------- | --------------------------------------------------------------------------------------------------------- |
|
|
26
|
+
| **product-engineer** | Preparation — PRD, spec, stories, plan. Owns drift-reconciliation. |
|
|
27
|
+
| **developer** | Execution — implements from task lists with mandatory verifier audit pre-PR. |
|
|
28
|
+
| **planner** | Multi-story orchestration with dependency ordering and integration PR. |
|
|
29
|
+
| **technical-writer** | Autonomous documentation maintenance. **Owns docs structure and content**, including `docs/runbooks/`. |
|
|
30
|
+
| **housekeeping** | Lint, type, and test-wiring fixes. Does **not** organize documentation. |
|
|
31
|
+
| **github-ops** | GitHub consistency — issues, PRs, branches, labels, milestones, merge authority. |
|
|
32
|
+
| **ux-engineer** | UX prototyping, DESIGN.md ownership, mockup generation. |
|
|
33
|
+
| **qa-engineer** | Testing standard, test authoring, coverage/gap reporting. |
|
|
34
|
+
| **researcher** | Bounded codebase investigation producing structured research artifacts. |
|
|
35
|
+
| **verifier** | Compliance test-plan design and post-implementation fidelity audit. |
|
|
36
|
+
| **infra-engineer** | Approval-gated, reversible, recorded infrastructure changes across AWS, fly.io, Supabase, and Cloudflare. |
|
|
37
|
+
|
|
38
|
+
Platform coverage: `.github/agents/` and `.kiro/agents/` carry all eleven. `.claude/agents/` carries eight — `planner`, `product-engineer`, and `infra-engineer` run as `.claude/commands/` (they need main-thread human-approval gates: per-step for `infra-engineer`, per-phase for the two orchestrators).
|
|
68
39
|
|
|
69
40
|
## Skills
|
|
70
41
|
|
|
71
|
-
Skills are on-demand capabilities invoked by agents — **not** loaded unless explicitly referenced.
|
|
72
|
-
|
|
73
42
|
### Activity Skills
|
|
74
43
|
|
|
75
|
-
| Skill
|
|
76
|
-
|
|
|
77
|
-
|
|
|
78
|
-
|
|
|
79
|
-
|
|
|
80
|
-
|
|
|
81
|
-
|
|
|
82
|
-
|
|
|
83
|
-
|
|
|
84
|
-
|
|
|
85
|
-
|
|
|
86
|
-
|
|
|
87
|
-
|
|
|
88
|
-
|
|
|
89
|
-
|
|
|
44
|
+
| Skill | Purpose | Consumer |
|
|
45
|
+
| ---------------------------------------- | ------------------------------------------------------------------------------------------- | ---------------- |
|
|
46
|
+
| activity-init | Establish product context and technical guidelines | product-engineer |
|
|
47
|
+
| activity-refine | Issue refinement or full PRD creation | product-engineer |
|
|
48
|
+
| activity-grill | One-question-at-a-time, depth-first interview to a confirmed shared-understanding exit gate | product-engineer |
|
|
49
|
+
| activity-codebase-research | Bounded codebase investigation with structured artifact | researcher |
|
|
50
|
+
| activity-generate-spec | PRD to technical specification | product-engineer |
|
|
51
|
+
| activity-generate-stories | Spec to user stories with coverage validation | product-engineer |
|
|
52
|
+
| activity-publish-github | Publish stories as GitHub Issues | product-engineer |
|
|
53
|
+
| activity-e2e-test-design | E2E scenario generation from spec/stories | verifier |
|
|
54
|
+
| activity-contract-test-design | Contract and schema compatibility test strategy | verifier |
|
|
55
|
+
| activity-edge-case-refinement | Systematic edge-case discovery | verifier |
|
|
56
|
+
| activity-random-test-tactics | Randomized/fuzz/property test generation | verifier |
|
|
57
|
+
| activity-test-standards | Establish/maintain TESTING.md, detect harness defects | qa-engineer |
|
|
58
|
+
| activity-test-implementation | Author Layer 1-2 tests with security-negative category | qa-engineer |
|
|
59
|
+
| activity-integration-test-implementation | Layer 2.5 tests against real databases | qa-engineer |
|
|
60
|
+
| activity-e2e-test-implementation | Playwright E2E from verifier scenario tables | qa-engineer |
|
|
61
|
+
| activity-coverage-gap-analysis | Coverage measurement or structural gap analysis | qa-engineer |
|
|
62
|
+
| activity-drift-reconciliation | Route drift findings to task expansion or spec write-back | product-engineer |
|
|
90
63
|
|
|
91
64
|
### Operational Skills
|
|
92
65
|
|
|
93
|
-
| Skill
|
|
94
|
-
|
|
|
95
|
-
|
|
|
96
|
-
|
|
|
97
|
-
|
|
|
98
|
-
|
|
|
99
|
-
|
|
100
|
-
|
|
66
|
+
| Skill | Purpose | Consumer |
|
|
67
|
+
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
|
|
68
|
+
| git-ops | Branch management, rebase, merge, conflict resolution | developer, planner |
|
|
69
|
+
| aws-ops | AWS CLI command sets, tiers, cost, backup/revert, log table | infra-engineer |
|
|
70
|
+
| fly-ops | flyctl command sets, tiers, cost, backup/revert, log table | infra-engineer |
|
|
71
|
+
| supabase-ops | Supabase CLI command sets, `db diff` flow, drift rule, backup/revert, log table | infra-engineer |
|
|
72
|
+
| deploy-ops | Deploy script contract, environment mapping, tag policy, deploy-target framing, and GitHub Actions workflow scaffolding (`templates/scripts/`, `templates/workflows/`) | infra-engineer |
|
|
73
|
+
| ux-scaffold | Mockup project creation (html-lite, react-full) | ux-engineer |
|
|
74
|
+
| ux-theme-gen | Generate theme artifacts from DESIGN.md | ux-engineer, developer |
|
|
75
|
+
| memo-cli-usage | Read/write decisions to shared knowledge base | technical-writer, developer |
|
|
101
76
|
|
|
102
|
-
|
|
77
|
+
## Instructions
|
|
103
78
|
|
|
104
|
-
|
|
79
|
+
| Instruction | Scope | Purpose |
|
|
80
|
+
| ----------------------- | -------------------------- | -------------------------------------------------- |
|
|
81
|
+
| plan | `workstream/**` | Convert stories/issues into task lists |
|
|
82
|
+
| implement | `workstream/**/tasks-*.md` | Execute task list with branching and PR discipline |
|
|
83
|
+
| nextjs-pages-components | `**/app/**/*.tsx` | Next.js + React conventions |
|
|
84
|
+
| git-guard-notice | Always (Kiro) | Git invariants reminder |
|
|
105
85
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
| Instruction | Copilot / Kiro file | Claude equivalent | Scope | Purpose |
|
|
109
|
-
| --------------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------- |
|
|
110
|
-
| **plan** | `.github/instructions/plan.instructions.md` / `.kiro/steering/plan.md` | `.claude/skills/plan/` | `workstream/**` | Convert stories or refined issues into execution-ready task lists |
|
|
111
|
-
| **implement** | `.github/instructions/implement.instructions.md` / `.kiro/steering/implement.md` | `.claude/skills/implement/` | `workstream/**/tasks-*.md` | Execute task list with step-gated approval, branching, and PR discipline |
|
|
112
|
-
| **nextjs-pages-components** | `.github/instructions/domain/nextjs-pages-components.instructions.md` / `.kiro/steering/nextjs-pages-components.md` | — | `**/app/**/*.tsx` | Next.js + React conventions |
|
|
113
|
-
| **git-guard-notice** | `.kiro/steering/git-guard-notice.md` | — | Always loaded (Kiro) | Restates the three git invariants: no push/merge to `main`, Conventional Commits, `--body-file` for `gh` bodies |
|
|
86
|
+
`nextjs-pages-components` has a Claude gap: there is no automatic Claude delivery mechanism (no glob-scoped auto-load, no nested-`CLAUDE.md` scaffolding) — Claude Code consumers must manually copy the conventions into their app's nested `CLAUDE.md`. See `CLAUDE.md`'s "Domain-Specific Conventions" section.
|
|
114
87
|
|
|
115
88
|
## Hooks
|
|
116
89
|
|
|
117
|
-
|
|
118
|
-
| ---------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
|
119
|
-
| **git-guard** | `.kiro/hooks/git-guard.json`, `.kiro/hooks/scripts/git-guard.sh`, `.claude/hooks/git-guard.sh` | Blocks pushes/merges to `main`, non-Conventional commit messages, and inline `gh --body` |
|
|
120
|
-
| **branch-guard** | `.kiro/hooks/scripts/branch-guard.sh` | Blocks write operations while on the default branch |
|
|
121
|
-
|
|
122
|
-
Hook enforcement is best-effort. Human PR review is the actual gate for these invariants.
|
|
90
|
+
Kiro (`.kiro/hooks/`) and Claude Code (`.claude/hooks/`, wired via `.claude/settings.json`) both ship these two `PreToolUse` hooks; Copilot has no hook system, so its enforcement is prompt-level only.
|
|
123
91
|
|
|
124
|
-
|
|
92
|
+
| Hook | Matcher (Claude Code) | Purpose |
|
|
93
|
+
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
94
|
+
| git-guard | `Bash`, plus (issue #178) the mutating GitHub MCP tool surface — `mcp__github__merge_pull_request`, `enable_pr_auto_merge`, `push_files`, `create_or_update_file`, `delete_file`, `create_branch` | Blocks pushes/merges/writes into the default branch (resolved dynamically, not hardcoded to `main`) — including `gh pr merge` with its base resolved via `gh pr view` (not a `--base` text check), `gh pr merge --admin` (blocked outright), `gh pr merge --auto` when the resolved base is the default branch, the raw-git escape of merging a story/issue branch into an integration branch, and the equivalent MCP-tool-call forms of all of the above (base/branch resolved from structured `tool_input` fields, not a command string) — plus non-Conventional commits, inline `gh --body`, and human-only tags |
|
|
95
|
+
| branch-guard | `Edit\|Write\|NotebookEdit` | Blocks write operations on default branch |
|
|
125
96
|
|
|
126
|
-
|
|
97
|
+
Hook enforcement is best-effort and fails open on unexpected errors, with one exception: if `git-guard` cannot verify a `gh pr merge`'s (or its MCP equivalent's) base branch — the `gh pr view` lookup fails (`gh` missing, unauthenticated, or a network error), or an MCP merge/auto-merge call omits enough `tool_input` to identify the PR at all — it fails **closed** and blocks the call, since an unverified base could be the default branch.
|
|
127
98
|
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
## Agent File Format (Kiro Custom Agents)
|
|
131
|
-
|
|
132
|
-
Agent files in `.kiro/agents/` use YAML frontmatter followed by a markdown body containing the system prompt. The frontmatter conforms to the [official Kiro custom agent configuration reference](https://kiro.dev/docs/cli/custom-agents/configuration-reference/).
|
|
133
|
-
|
|
134
|
-
### Frontmatter Schema
|
|
135
|
-
|
|
136
|
-
```yaml
|
|
137
|
-
---
|
|
138
|
-
description: "<human-readable agent description>"
|
|
139
|
-
tools: [<tool-tags>] # Allowed: read, write, shell, web
|
|
140
|
-
resources: # Context files auto-loaded into the agent
|
|
141
|
-
- file://<relative-path> # Project files (e.g., file://AGENTS.md)
|
|
142
|
-
- skill://<glob-pattern> # Skill definitions (e.g., skill://.kiro/skills/**/SKILL.md)
|
|
143
|
-
permissions: # (Optional) Fine-grained access control
|
|
144
|
-
- allow: <action>
|
|
145
|
-
paths: ["<glob>"]
|
|
146
|
-
- deny: <action>
|
|
147
|
-
paths: ["<glob>"]
|
|
148
|
-
---
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
### Field Reference
|
|
152
|
-
|
|
153
|
-
| Field | Required | Description |
|
|
154
|
-
| -------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
155
|
-
| `description` | Yes | Human-readable purpose. Used by the runtime for agent selection and routing. |
|
|
156
|
-
| `tools` | Yes | Tag-based tool categories: `read`, `write`, `shell`, `web`. Use `["*"]` for unrestricted. |
|
|
157
|
-
| `resources` | No | Context files auto-loaded via `file://` (project files) and `skill://` (skill definitions). |
|
|
158
|
-
| `permissions` | No | Inline permission rules for fine-grained access control (allow/deny by path glob). **Note:** Not yet supported by the Kiro runtime as of v1.0 — presence causes agents to fail to load. |
|
|
159
|
-
| `model` | No | Model selection override (omit to use the runtime default). |
|
|
160
|
-
| `mcpServers` | No | Embedded MCP server configurations for tool extensions. |
|
|
161
|
-
| `allowedTools` | No | Tools that execute without prompting (pre-approved). |
|
|
162
|
-
|
|
163
|
-
### Tool Categories
|
|
164
|
-
|
|
165
|
-
| Tag | Grants Access To |
|
|
166
|
-
| ------- | ------------------------------------- |
|
|
167
|
-
| `read` | File reading, search, code navigation |
|
|
168
|
-
| `write` | File creation, editing, deletion |
|
|
169
|
-
| `shell` | Terminal command execution |
|
|
170
|
-
| `web` | Web browsing and HTTP requests |
|
|
171
|
-
|
|
172
|
-
> **Note:** `subagent` is not an official tool category. Subagent delegation is a runtime capability, not a tool permission.
|
|
173
|
-
|
|
174
|
-
### References
|
|
175
|
-
|
|
176
|
-
- [Kiro Custom Agent Configuration Reference](https://kiro.dev/docs/cli/custom-agents/configuration-reference/)
|
|
177
|
-
- [Kiro CLI v3 Agent Config](https://kiro.dev/docs/cli/v3/agent-config/)
|
|
178
|
-
- [Sample Multi-Agent Repository](https://github.com/aws-samples/sample-kiro-cli-multiagent-development)
|
|
179
|
-
|
|
180
|
-
---
|
|
99
|
+
**Hooks are advisory, not the gate.** Every hook in this table is a best-effort, local, pattern-matching check over a command string or a structured tool-input shape — not a real parser, and not a completeness guarantee against every future command form or tool surface (a new MCP server, a future first-party tool) that could reopen the same class of gap. **GitHub branch protection on the default branch — require a PR, require ≥1 approving review, require passing status checks, disable force-push and branch deletion — is the actual, server-side, unbypassable-by-any-tool-surface control.** Hooks narrow the window and catch the common cases; they do not replace branch protection. Configure it per the README "Configure branch protection" step and `activity-init`'s Repository Setup section.
|
|
181
100
|
|
|
182
101
|
## General Agent Guidelines
|
|
183
102
|
|
|
184
|
-
All
|
|
103
|
+
All agents **MUST**:
|
|
185
104
|
|
|
186
|
-
-
|
|
105
|
+
- Create feature branches — never commit to default branch
|
|
187
106
|
- Use Conventional Commits (`feat`, `fix`, `chore`, `docs`, etc.)
|
|
188
|
-
- Create PRs for review — never self-merge into `main`
|
|
189
|
-
-
|
|
190
|
-
- Follow testing, linting, and documentation standards from `technical-guidelines.md`
|
|
107
|
+
- Create PRs for review — never self-merge into `main`; PRs targeting `main` require user approval
|
|
108
|
+
- Follow standards from `tech.md`
|
|
191
109
|
- Reference GitHub Issues in branch names and commits
|
|
192
|
-
-
|
|
193
|
-
-
|
|
194
|
-
- Use
|
|
195
|
-
-
|
|
196
|
-
-
|
|
197
|
-
-
|
|
198
|
-
-
|
|
199
|
-
- **
|
|
200
|
-
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
## Task Types
|
|
205
|
-
|
|
206
|
-
### architecture-change
|
|
207
|
-
|
|
208
|
-
The `architecture-change` task type is the **only** mode that grants write authority to the meta-repo (the shared architecture/catalog repository). It enforces structural integrity of the semantic layer by restricting what can be modified, requiring formal decision records, and mandating human approval.
|
|
209
|
-
|
|
210
|
-
#### Write Scope (RF-62)
|
|
211
|
-
|
|
212
|
-
An `architecture-change` task **MAY** modify:
|
|
213
|
-
|
|
214
|
-
- `architecture.md`
|
|
215
|
-
- `domains.md`
|
|
216
|
-
- `glossary.md`
|
|
217
|
-
- `conventions.md`
|
|
218
|
-
- `catalog/flows/` (flow definitions)
|
|
219
|
-
|
|
220
|
-
An `architecture-change` task **MUST NOT** modify:
|
|
221
|
-
|
|
222
|
-
- `catalog/components/*.json` — generated by CI from component-repo extraction; never hand-edited or agent-edited
|
|
223
|
-
- `catalog/index.yaml` — generated by `dt catalog build`; never hand-edited or agent-edited
|
|
224
|
-
|
|
225
|
-
#### Generated-File Prohibition
|
|
226
|
-
|
|
227
|
-
`catalog/components/*.json` and `catalog/index.yaml` are **generated artifacts** produced by CI pipelines (`dt extract` and `dt catalog build`). No agent or human may edit these files directly. Changes to component metadata flow exclusively through the component-repo extraction pipeline.
|
|
228
|
-
|
|
229
|
-
#### ADR Requirement
|
|
230
|
-
|
|
231
|
-
Before opening any meta-repo PR under the `architecture-change` task type, the agent **MUST** produce an Architecture Decision Record (ADR) containing:
|
|
232
|
-
|
|
233
|
-
- **Context:** Why the change is needed
|
|
234
|
-
- **Decision:** What is being changed
|
|
235
|
-
- **Consequences:** Impact on consumers, domains, or contracts
|
|
236
|
-
- **Alternatives considered:** Other approaches evaluated and reasons for rejection
|
|
237
|
-
|
|
238
|
-
The ADR **MUST** be committed as part of the PR (in the meta-repo's ADR directory).
|
|
239
|
-
|
|
240
|
-
#### Human Approval Gate
|
|
241
|
-
|
|
242
|
-
- PRs from the `architecture-change` task type targeting the meta-repo **REQUIRE** explicit human review and approval.
|
|
243
|
-
- No agent may auto-merge an `architecture-change` PR into the default branch.
|
|
244
|
-
- This aligns with the existing branch/PR discipline: PRs targeting `main` require user approval.
|
|
245
|
-
|
|
246
|
-
#### Exclusion Rule (RF-64)
|
|
247
|
-
|
|
248
|
-
Agents **MUST NOT** write to the meta-repo outside the `architecture-change` task type. Any attempt to modify meta-repo files (including those in the allowed write scope) outside this task type **MUST** be refused with a clear message:
|
|
249
|
-
|
|
250
|
-
> "Meta-repo writes require the `architecture-change` task type. Create an architecture-change task to modify these files."
|
|
251
|
-
|
|
252
|
-
This applies to all agents (`product-engineer`, `developer`, `planner`, `housekeeping`, etc.).
|
|
253
|
-
|
|
254
|
-
---
|
|
255
|
-
|
|
256
|
-
## Cross-Repo Partitioning (RF-63)
|
|
257
|
-
|
|
258
|
-
When a scoping step (via `dt init --task` or manual multi-repo planning) identifies more than one `primary` component, the feature spans multiple repositories. In this case, the agent **MUST** partition the work into per-repo sub-tasks rather than treating it as a single monolithic task.
|
|
259
|
-
|
|
260
|
-
### Partitioning Procedure
|
|
261
|
-
|
|
262
|
-
1. **Detection:** If `scope.primary` contains >1 component, the feature is cross-repo and **MUST** be partitioned.
|
|
263
|
-
2. **One sub-task per repo:** Each `primary` component becomes its own sub-task, scoped exclusively to that component's repository.
|
|
264
|
-
3. **Partition proposal consumption:** When a partition proposal is available from `dt scope gate` (G1 abort, exit 7), the agent **SHOULD** use it as the basis for the partition. When no automated proposal is available, the agent **MUST** apply the same rules manually.
|
|
265
|
-
|
|
266
|
-
### Contract-as-Interface
|
|
267
|
-
|
|
268
|
-
- Each sub-task uses the **boundary contract** (with a target version) as its interface.
|
|
269
|
-
- Acceptance criteria for each sub-task **MUST** reference the contract definition (OpenAPI spec, AsyncAPI channel, or schema), **not** the foreign repo's internal implementation.
|
|
270
|
-
- A sub-task is complete when it satisfies its contract obligations — it does not depend on or verify the other repo's implementation details.
|
|
271
|
-
|
|
272
|
-
### Ordering Rule
|
|
273
|
-
|
|
274
|
-
Sub-tasks **MUST** be ordered **producer-before-consumers**:
|
|
275
|
-
|
|
276
|
-
- The provider (producer) implements its contract first.
|
|
277
|
-
- Consumer sub-tasks implement adaptation to the contract after the provider sub-task is complete.
|
|
278
|
-
- This ensures the contract exists in its target form before consumers adapt to it.
|
|
279
|
-
|
|
280
|
-
### Low-Payload Elevation Guard
|
|
281
|
-
|
|
282
|
-
A boundary contract with `payload_confidence: low` **MUST** be raised to at least `medium` confidence before it can serve as an acceptance boundary. This is achieved by:
|
|
283
|
-
|
|
284
|
-
- Re-running extraction (`dt extract`) with improved source hints, OR
|
|
285
|
-
- Manual confirmation of the payload shape by a human reviewer.
|
|
286
|
-
|
|
287
|
-
Until the boundary contract reaches `medium` or higher confidence, the agent **MUST NOT** use it as an acceptance interface and **MUST** block the sub-task that depends on it with a clear message:
|
|
288
|
-
|
|
289
|
-
> "Boundary contract `<contract-id>` has `payload_confidence: low`. Re-run extraction or manually confirm the payload shape before using it as an acceptance boundary."
|
|
290
|
-
|
|
291
|
-
### Single-Primary — No Partition
|
|
292
|
-
|
|
293
|
-
When `scope.primary` contains exactly 1 component, no partitioning is needed. The feature is single-repo and proceeds with normal task planning.
|
|
110
|
+
- Prefer `pnpm` over `npm`; use canonical scripts: `lint`, `format:check`, `typecheck`, `test`, `audit`, `validate`
|
|
111
|
+
- Enforce quality gates before completion
|
|
112
|
+
- Use `git-ops` for complex branch operations
|
|
113
|
+
- Run `qa-engineer` at completion gate (record `coverage_gate: PASS | FAIL | SKIPPED(<reason>)`)
|
|
114
|
+
- Run `verifier` audit (mandatory, non-skippable) before PR is ready; drift findings route to `product-engineer`
|
|
115
|
+
- Follow test-first design: write tests before implementation code
|
|
116
|
+
- If `memo-cli` is available: read/write entries per role
|
|
117
|
+
- **Foundation documents: resolve the new name, fall back to the old one.** The canonical names are `docs/product.md` and `docs/tech.md`. A repository installed before the rename still carries `docs/product-context.md` and `docs/technical-guidelines.md`, and `dev-tasks update` never renames a consumer-owned file on its own. So when **reading** a foundation document, resolve the new name first and fall back to the old one only when the new name is absent; when **writing**, always write the new name. Propose `dev-tasks migrate docs` on encountering an old name. This applies to every agent and skill that reads these documents, for one release cycle (FR-45)
|
|
118
|
+
- Deliver a runbook in the **same PR** as any new or materially changed script under `templates/scripts/`, workflow under `templates/workflows/` or `.github/workflows/`, or `infra-engineer` change kind (FR-49a). Updating an existing runbook satisfies this
|
|
119
|
+
- Route a docs-structure failure in `validate` to `technical-writer`, never to `housekeeping` (FR-51): `technical-writer` owns documentation structure and content
|
|
120
|
+
- Treat a blocked guard as a decision, not an obstacle: when a hook blocks a tool call, surface the block verbatim, stop that line of work, and **MUST NOT** attempt an alternative command, tool surface, or sequence that achieves the same effect the block just prevented. Using a legitimate alternate mechanism for an unrelated, non-triggering purpose (e.g. `Read` instead of `grep`, `Write` instead of a shell heredoc) is not a route-around and remains allowed
|
|
294
121
|
|
|
295
122
|
---
|
|
296
123
|
|
|
297
|
-
For workflow chains
|
|
124
|
+
For workflow chains: [`docs/workflow-chains.md`](docs/workflow-chains.md). For architecture and invariants: [`docs/system-overview.md`](docs/system-overview.md). Full docs index: [`docs/README.md`](docs/README.md).
|