@llipe.com/dev-tasks 0.11.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 +105 -43
- package/.claude/agents/github-ops.md +48 -4
- package/.claude/agents/housekeeping.md +44 -7
- package/.claude/agents/qa-engineer.md +24 -11
- package/.claude/agents/researcher.md +26 -6
- 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 +44 -23
- package/.claude/commands/product-engineer.md +21 -9
- package/.claude/commands/researcher.md +4 -5
- 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 +4 -11
- 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-refine/SKILL.md +75 -15
- package/.claude/skills/activity-test-standards/SKILL.md +25 -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 +70 -19
- 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 +25 -4
- package/.github/agents/product-engineer.agent.md +21 -9
- package/.github/agents/qa-engineer.agent.md +23 -11
- package/.github/agents/researcher.agent.md +25 -6
- 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 +4 -5
- package/.github/prompts/technical-writer.prompt.md +1 -1
- package/.github/skills/activity-codebase-research/SKILL.md +4 -16
- 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-refine/SKILL.md +75 -15
- package/.github/skills/activity-test-standards/SKILL.md +25 -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 +71 -20
- 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 +33 -15
- package/.kiro/agents/product-engineer.md +24 -12
- package/.kiro/agents/qa-engineer.md +24 -12
- package/.kiro/agents/researcher.md +26 -7
- package/.kiro/agents/technical-writer.md +63 -9
- package/.kiro/agents/verifier.md +47 -6
- package/.kiro/skills/activity-codebase-research/SKILL.md +4 -11
- 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-refine/SKILL.md +75 -15
- package/.kiro/skills/activity-test-standards/SKILL.md +25 -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 +60 -109
- package/AGENTS.md.template +124 -0
- package/CHANGELOG.md +163 -0
- package/CLAUDE.md +23 -18
- package/CLAUDE.md.template +103 -0
- package/README.md +168 -146
- package/TESTING.md +84 -148
- 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/.claude/skills/activity-contract-validation/SKILL.md +0 -167
- package/.github/skills/activity-contract-validation/SKILL.md +0 -167
- package/.kiro/skills/activity-contract-validation/SKILL.md +0 -167
- 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/README.md
CHANGED
|
@@ -8,18 +8,17 @@ A set of agents, skills, and instructions for GitHub Copilot, Claude Code, Kiro,
|
|
|
8
8
|
|
|
9
9
|
### 1. Install the package
|
|
10
10
|
|
|
11
|
+
Use npm to install the [dev-tasks package](https://www.npmjs.com/package/@llipe.com/dev-tasks/).
|
|
12
|
+
|
|
11
13
|
```bash
|
|
12
14
|
pnpm add -g @llipe.com/dev-tasks
|
|
13
15
|
```
|
|
14
16
|
|
|
15
|
-
This gives you
|
|
16
|
-
|
|
17
|
-
| Binary | Stability | Purpose |
|
|
18
|
-
| ----------- | ------------ | ------------------------------------------------------- |
|
|
19
|
-
| `dev-tasks` | **Stable** | Bootstrap: install agent files, update, status, migrate |
|
|
20
|
-
| `dt` | **Unstable** | Runtime: extract repo metadata, build context |
|
|
17
|
+
This gives you one binary:
|
|
21
18
|
|
|
22
|
-
|
|
19
|
+
| Binary | Stability | Purpose |
|
|
20
|
+
| ----------- | ---------- | ------------------------------------------------------- |
|
|
21
|
+
| `dev-tasks` | **Stable** | Bootstrap: install agent files, update, status, migrate |
|
|
23
22
|
|
|
24
23
|
### 2. Install agent workflow files into your repo
|
|
25
24
|
|
|
@@ -39,16 +38,50 @@ dev-tasks install --profile kiro # .kiro/ only
|
|
|
39
38
|
dev-tasks install --profile both # copilot + claude only
|
|
40
39
|
```
|
|
41
40
|
|
|
42
|
-
|
|
41
|
+
**What each profile delivers, beyond the platform-specific agent/skill/command directories:**
|
|
42
|
+
|
|
43
|
+
| Profile | Root context files delivered |
|
|
44
|
+
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
45
|
+
| `copilot` | `DESIGN.md`, `TESTING.md` (install-if-absent for consumer-owned files not covered here — see below) |
|
|
46
|
+
| `claude` | `DESIGN.md`, `TESTING.md`, plus `CLAUDE.md` and `AGENTS.md` — project memory Claude Code loads on every turn, and the shared agent/skill registry it imports. Delivered install-if-absent: written on a fresh install, never overwritten once you fill them in |
|
|
47
|
+
| `kiro` | `DESIGN.md`, `TESTING.md` — Kiro's equivalent standing guidance ships as always-on steering (`.kiro/steering/git-guard-notice.md`) rather than a root file |
|
|
48
|
+
| `both` / `all` | Union of the profiles above |
|
|
49
|
+
|
|
50
|
+
`DESIGN.md` and `TESTING.md` install unconditionally on every run (they are canonical contract documents, not consumer-authored memory). `CLAUDE.md`, `AGENTS.md`, and `.claude/settings.json` use install-if-absent semantics instead: delivered once, then fully consumer-owned, so `install` and `update` never clobber content you've customized.
|
|
51
|
+
|
|
52
|
+
### 3. Configure branch protection (required, not optional)
|
|
53
|
+
|
|
54
|
+
The `git-guard`/`branch-guard` hooks (Claude Code) and their Kiro equivalents are **advisory, best-effort, local checks** — defense-in-depth, not the actual gate. They are text/JSON pattern matching over a tool call and can always be evaded by a sufficiently creative command or tool-input shape; Copilot has no hook system at all. The only control that is server-side and unbypassable by any tool surface (`gh` CLI, raw `git`, or an MCP server) is a **GitHub branch protection rule** on the repository's default branch. Configure it before relying on any agent to work in this repository:
|
|
55
|
+
|
|
56
|
+
- Require a pull request before merging
|
|
57
|
+
- Require at least 1 approving review
|
|
58
|
+
- Require status checks to pass before merging
|
|
59
|
+
- Disable force-pushes to the default branch
|
|
60
|
+
- Disable branch deletion for the default branch
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
gh api repos/<owner>/<repo>/branches/<default-branch>/protection \
|
|
64
|
+
--method PUT \
|
|
65
|
+
-f required_pull_request_reviews.required_approving_review_count=1 \
|
|
66
|
+
-F required_status_checks='{"strict":true,"contexts":[]}' \
|
|
67
|
+
-F enforce_admins=true \
|
|
68
|
+
-F restrictions=null \
|
|
69
|
+
-F allow_force_pushes=false \
|
|
70
|
+
-F allow_deletions=false
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Or configure it via **Settings → Branches → Branch protection rules** in the GitHub UI. Run this once per repository, immediately after installing dev-tasks.
|
|
74
|
+
|
|
75
|
+
### 4. Initialize your project context
|
|
43
76
|
|
|
44
77
|
Invoke the `product-engineer` agent in Init Mode (via `@product-engineer` or the `product-engineer-init` prompt). This creates:
|
|
45
78
|
|
|
46
|
-
- `docs/product
|
|
47
|
-
- `docs/
|
|
79
|
+
- `docs/product.md` — what your product is and who it's for
|
|
80
|
+
- `docs/tech.md` — stack, conventions, and constraints
|
|
48
81
|
|
|
49
82
|
Run this once per project.
|
|
50
83
|
|
|
51
|
-
###
|
|
84
|
+
### 5. Build a feature
|
|
52
85
|
|
|
53
86
|
```text
|
|
54
87
|
a) Invoke @product-engineer with a feature description or GitHub issue number
|
|
@@ -58,7 +91,7 @@ b) Invoke @developer with the task list path
|
|
|
58
91
|
→ implements, tests, and opens a PR
|
|
59
92
|
```
|
|
60
93
|
|
|
61
|
-
###
|
|
94
|
+
### 6. Keep files up to date
|
|
62
95
|
|
|
63
96
|
```bash
|
|
64
97
|
dev-tasks update # reconcile with hash-based conflict detection
|
|
@@ -68,85 +101,30 @@ dev-tasks status # compare installed vs latest version
|
|
|
68
101
|
|
|
69
102
|
---
|
|
70
103
|
|
|
71
|
-
##
|
|
72
|
-
|
|
73
|
-
> **⚠️ Unstable:** The `dt` command is under active development and recommended for testing purposes only. APIs, flags, output formats, and exit codes may change between releases.
|
|
74
|
-
|
|
75
|
-
`dt` extracts repository metadata (schema, OpenAPI, AsyncAPI), derives a `component.json` manifest with provenance and confidence tracking, and builds cross-repo context for agent sessions.
|
|
76
|
-
|
|
77
|
-
### Extract metadata from a repo
|
|
78
|
-
|
|
79
|
-
```bash
|
|
80
|
-
cd my-service
|
|
81
|
-
|
|
82
|
-
# Run the full extraction pipeline
|
|
83
|
-
dt extract all --interactive
|
|
84
|
-
|
|
85
|
-
# Or run individual extractors
|
|
86
|
-
dt extract detect # stack, framework, ORM, messaging
|
|
87
|
-
dt extract schema # database schema from ORM definitions
|
|
88
|
-
dt extract openapi # OpenAPI spec (copy existing or AST inference)
|
|
89
|
-
dt extract asyncapi # AsyncAPI spec from Kafka topic patterns
|
|
90
|
-
dt extract component # derive component.json manifest
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
### Review outputs
|
|
94
|
-
|
|
95
|
-
```bash
|
|
96
|
-
cat component.json # manifest with _provenance metadata
|
|
97
|
-
cat extraction_report.json # coverage, confidence, unresolved items
|
|
98
|
-
```
|
|
104
|
+
## `dev-tasks` CLI Reference
|
|
99
105
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
```bash
|
|
103
|
-
dt validate-component component.json # exit 0 valid, exit 4 invalid
|
|
104
|
-
dt validate-component component.json --json # structured error list
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
### Typical workflow
|
|
108
|
-
|
|
109
|
-
```bash
|
|
110
|
-
dt extract all --interactive
|
|
111
|
-
dt validate-component component.json
|
|
112
|
-
git add component.json contracts/ docs/schema.md extraction_report.json
|
|
113
|
-
git commit -m "feat: add component manifest via dt extract"
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
### Artifact formats
|
|
117
|
-
|
|
118
|
-
For which artifacts are JSON vs YAML, and which are generated vs hand-written, see [`docs/artifact-formats.md`](docs/artifact-formats.md). Generated artifacts (`catalog/index.yaml`, `catalog/components/`) are never hand-edited.
|
|
119
|
-
|
|
120
|
-
### CLI documentation
|
|
121
|
-
|
|
122
|
-
- **`dev-tasks` (bootstrap/distribution):** [`docs/dev-tasks-user-manual.md`](docs/dev-tasks-user-manual.md) — install, update, pin/unpin, profiles, manifest merging, reconciliation
|
|
123
|
-
- **`dt` (extraction/catalog/context):** [`docs/dt-user-manual.md`](docs/dt-user-manual.md) — extract, catalog, context, scope
|
|
124
|
-
- **Architecture and artifacts:** [`docs/system-overview.md`](docs/system-overview.md) and [`docs/data-model.md`](docs/data-model.md)
|
|
106
|
+
- **CLI documentation:** [`docs/dev-tasks-user-manual.md`](docs/dev-tasks-user-manual.md) — install, update, pin/unpin, profiles, manifest merging, reconciliation
|
|
107
|
+
- **Architecture and artifacts:** [`docs/system-overview.md`](docs/system-overview.md)
|
|
125
108
|
- **Everything else:** [`docs/README.md`](docs/README.md)
|
|
126
109
|
|
|
127
110
|
### Global options
|
|
128
111
|
|
|
129
|
-
| Flag
|
|
130
|
-
|
|
|
131
|
-
| `--json`
|
|
132
|
-
|
|
|
133
|
-
| `-v` | Verbose diagnostics (stderr) |
|
|
112
|
+
| Flag | Description |
|
|
113
|
+
| -------- | ---------------------------- |
|
|
114
|
+
| `--json` | Machine-readable JSON output |
|
|
115
|
+
| `-v` | Verbose diagnostics (stderr) |
|
|
134
116
|
|
|
135
117
|
### Exit codes
|
|
136
118
|
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
|
140
|
-
|
|
|
141
|
-
|
|
|
142
|
-
|
|
|
143
|
-
|
|
|
144
|
-
| 7 | Gate aborted (scope gate G1–G4) |
|
|
145
|
-
| 8 | Breaking contract change detected |
|
|
146
|
-
| 13 | Incomplete extraction: required fields unresolved |
|
|
147
|
-
| 14 | Reconciliation conflict (edited fields) |
|
|
119
|
+
| Code | Meaning |
|
|
120
|
+
| ---- | --------------------------------------- |
|
|
121
|
+
| 0 | Success |
|
|
122
|
+
| 1 | Unexpected error |
|
|
123
|
+
| 2 | Incorrect usage |
|
|
124
|
+
| 11 | Dependency check failed (`doctor`) |
|
|
125
|
+
| 14 | Reconciliation conflict (edited fields) |
|
|
148
126
|
|
|
149
|
-
Full
|
|
127
|
+
Full contract, including retirement history for codes no longer in use: [`core/exit-codes.ts`](core/exit-codes.ts).
|
|
150
128
|
|
|
151
129
|
---
|
|
152
130
|
|
|
@@ -158,8 +136,9 @@ dev-tasks update [--force] # Reconcile with hash-based conflict detec
|
|
|
158
136
|
dev-tasks status # Compare installed/pinned/latest versions
|
|
159
137
|
dev-tasks pin <version> # Pin to a specific version
|
|
160
138
|
dev-tasks unpin # Remove the version pin
|
|
161
|
-
dev-tasks doctor # Check Node ≥
|
|
139
|
+
dev-tasks doctor # Check Node ≥24, git ≥2.37, cache writable
|
|
162
140
|
dev-tasks migrate # Migrate from legacy shell-script install
|
|
141
|
+
dev-tasks migrate docs [--force] # Rename the foundation docs to their current names
|
|
163
142
|
```
|
|
164
143
|
|
|
165
144
|
### Version Pinning
|
|
@@ -183,6 +162,46 @@ dev-tasks unpin # Remove the pin (update will use the local package versi
|
|
|
183
162
|
|
|
184
163
|
`update` never overwrites a locally modified managed file without `--force`; it reports the conflict and exits `14`.
|
|
185
164
|
|
|
165
|
+
### Foundation Document Migration
|
|
166
|
+
|
|
167
|
+
The two foundation documents were renamed:
|
|
168
|
+
|
|
169
|
+
| Before | After |
|
|
170
|
+
| ------------------------------ | ----------------- |
|
|
171
|
+
| `docs/product-context.md` | `docs/product.md` |
|
|
172
|
+
| `docs/technical-guidelines.md` | `docs/tech.md` |
|
|
173
|
+
|
|
174
|
+
Nothing breaks if you do not migrate. Agents resolve the new name first and
|
|
175
|
+
fall back to the old one, so a repository installed before the rename keeps
|
|
176
|
+
working — they will just propose this command when they encounter an old name.
|
|
177
|
+
`dev-tasks doctor` reports the old names as a **warning**, not a failure, for
|
|
178
|
+
the same reason: it is telling you the migration is available, not that
|
|
179
|
+
anything is broken. Your exit code stays `0`.
|
|
180
|
+
|
|
181
|
+
`dev-tasks migrate docs` is **report-only**. It prints the pending renames and
|
|
182
|
+
the files of your own that still reference the old names, and changes nothing:
|
|
183
|
+
|
|
184
|
+
```bash
|
|
185
|
+
dev-tasks migrate docs # Show what would change
|
|
186
|
+
dev-tasks migrate docs --force # Perform the renames
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
`--force` renames the files with their content unchanged, after copying the
|
|
190
|
+
originals into `.dev-tasks/backup/<timestamp>/`. A rename whose target already
|
|
191
|
+
exists is skipped rather than overwritten — if you half-migrated by hand, your
|
|
192
|
+
file stays — and the command exits `14` so the skip is visible to a script.
|
|
193
|
+
Both forms accept `--json`.
|
|
194
|
+
|
|
195
|
+
Files you own are yours to update. The command reports which of them still
|
|
196
|
+
name the old documents; it does not edit them, and neither does
|
|
197
|
+
`dev-tasks update`.
|
|
198
|
+
|
|
199
|
+
**Note the asymmetry with the bare `migrate` command.** `dev-tasks migrate`
|
|
200
|
+
(no sub-verb) migrates a legacy shell-script install and applies its change
|
|
201
|
+
immediately. `dev-tasks migrate docs` proposes by default. The difference is
|
|
202
|
+
deliberate: `migrate` shipped with that behavior, and quietly turning it into
|
|
203
|
+
a dry run would break anyone already scripting it.
|
|
204
|
+
|
|
186
205
|
---
|
|
187
206
|
|
|
188
207
|
## The Core Idea
|
|
@@ -217,13 +236,13 @@ This system brings structure and clarity to AI-assisted development by:
|
|
|
217
236
|
|
|
218
237
|
Agents are autonomous personas that orchestrate skills and activities.
|
|
219
238
|
|
|
220
|
-
> **Available for:** Copilot (`.github/agents/`), Claude Code (`.claude/agents/`), Kiro (`.kiro/agents/`). Copilot and Kiro define all
|
|
239
|
+
> **Available for:** Copilot (`.github/agents/`), Claude Code (`.claude/agents/`), Kiro (`.kiro/agents/`). Copilot and Kiro define all 11 agents below. On Claude Code, the two orchestrators (`planner`, `product-engineer`) and `infra-engineer` run in the main thread as `/commands` so they can pause for approval gates (per-phase for the orchestrators, per-step for `infra-engineer`); the other 8 are subagents.
|
|
221
240
|
|
|
222
241
|
### `product-engineer`
|
|
223
242
|
|
|
224
243
|
Preparation agent — owns the full pre-coding chain:
|
|
225
244
|
|
|
226
|
-
- **Init Mode**: `activity-init` → product
|
|
245
|
+
- **Init Mode**: `activity-init` → product.md + tech.md
|
|
227
246
|
- **Feature Mode**: `activity-refine` → `activity-generate-spec` → `activity-generate-stories` → `activity-publish-github` → `plan`
|
|
228
247
|
- **Issue Mode**: `activity-refine` → `plan`
|
|
229
248
|
|
|
@@ -249,15 +268,16 @@ Multi-story orchestration with checkpoint/resume:
|
|
|
249
268
|
|
|
250
269
|
### Other Agents
|
|
251
270
|
|
|
252
|
-
| Agent | Purpose
|
|
253
|
-
| ------------------ |
|
|
254
|
-
| `ux-engineer` | PRD/SPEC-to-screen visualization (lite/full), DESIGN.md ownership, gap analysis
|
|
255
|
-
| `technical-writer` | Documentation maintenance
|
|
256
|
-
| `housekeeping` | Lint, type, and test-wiring fixes
|
|
257
|
-
| `github-ops` | GitHub consistency — issues, PRs, branches, labels
|
|
258
|
-
| `verifier` | Compliance test-plan design and fidelity auditing
|
|
259
|
-
| `qa-engineer` | Testing standard, missing test harnesses, coverage and gap reporting
|
|
260
|
-
| `researcher` | Bounded codebase investigation producing structured research artifacts
|
|
271
|
+
| Agent | Purpose |
|
|
272
|
+
| ------------------ | ----------------------------------------------------------------------------------------------- |
|
|
273
|
+
| `ux-engineer` | PRD/SPEC-to-screen visualization (lite/full), DESIGN.md ownership, gap analysis |
|
|
274
|
+
| `technical-writer` | Documentation maintenance |
|
|
275
|
+
| `housekeeping` | Lint, type, and test-wiring fixes |
|
|
276
|
+
| `github-ops` | GitHub consistency — issues, PRs, branches, labels |
|
|
277
|
+
| `verifier` | Compliance test-plan design and fidelity auditing |
|
|
278
|
+
| `qa-engineer` | Testing standard, missing test harnesses, coverage and gap reporting |
|
|
279
|
+
| `researcher` | Bounded codebase investigation producing structured research artifacts |
|
|
280
|
+
| `infra-engineer` | Approval-gated, reversible, recorded infrastructure changes (AWS, fly.io, Supabase, Cloudflare) |
|
|
261
281
|
|
|
262
282
|
---
|
|
263
283
|
|
|
@@ -265,25 +285,29 @@ Multi-story orchestration with checkpoint/resume:
|
|
|
265
285
|
|
|
266
286
|
On-demand capabilities loaded only when invoked.
|
|
267
287
|
|
|
268
|
-
| Skill | Purpose
|
|
269
|
-
| -------------------------------- |
|
|
270
|
-
| `activity-init` | Product context and technical guidelines
|
|
271
|
-
| `activity-refine` | Issue refinement or PRD creation
|
|
272
|
-
| `activity-generate-spec` | PRD → technical specification
|
|
273
|
-
| `activity-generate-stories` | Spec → user stories with coverage validation
|
|
274
|
-
| `activity-publish-github` | Stories → GitHub Issues
|
|
275
|
-
| `activity-drift-reconciliation` | Routes verifier drift findings into remediation
|
|
276
|
-
| `git-ops` | Branch, rebase, merge, conflict resolution
|
|
277
|
-
| `
|
|
278
|
-
| `
|
|
279
|
-
| `
|
|
280
|
-
| `
|
|
281
|
-
| `
|
|
282
|
-
| `
|
|
283
|
-
| `activity-test-
|
|
284
|
-
| `activity-test-
|
|
285
|
-
| `activity-
|
|
286
|
-
| `
|
|
288
|
+
| Skill | Purpose | Consumer |
|
|
289
|
+
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
|
|
290
|
+
| `activity-init` | Product context and technical guidelines | `product-engineer` |
|
|
291
|
+
| `activity-refine` | Issue refinement or PRD creation | `product-engineer` |
|
|
292
|
+
| `activity-generate-spec` | PRD → technical specification | `product-engineer` |
|
|
293
|
+
| `activity-generate-stories` | Spec → user stories with coverage validation | `product-engineer` |
|
|
294
|
+
| `activity-publish-github` | Stories → GitHub Issues | `product-engineer` |
|
|
295
|
+
| `activity-drift-reconciliation` | Routes verifier drift findings into remediation | `product-engineer` |
|
|
296
|
+
| `git-ops` | Branch, rebase, merge, conflict resolution | `developer`, `planner` |
|
|
297
|
+
| `aws-ops` | AWS CLI command sets, tiers, cost, backup/revert, logs | `infra-engineer` |
|
|
298
|
+
| `fly-ops` | flyctl command sets, tiers, cost, backup/revert, logs | `infra-engineer` |
|
|
299
|
+
| `supabase-ops` | Supabase CLI sets, `db diff` flow, drift rule, logs | `infra-engineer` |
|
|
300
|
+
| `deploy-ops` | Deploy script contract, env mapping, tag policy, and workflow scaffolding (`templates/scripts/`, `templates/workflows/`) | `infra-engineer` |
|
|
301
|
+
| `ux-scaffold` | Template-aware mockup generation (lite/full) | `ux-engineer` |
|
|
302
|
+
| `ux-theme-gen` | DESIGN.md → theme artifacts (CSS vars, Tailwind v4, RN) | `ux-engineer`, `developer` |
|
|
303
|
+
| `activity-e2e-test-design` | E2E black-box test scenario generation | `verifier` |
|
|
304
|
+
| `activity-contract-test-design` | Consumer/provider contract testing | `verifier` |
|
|
305
|
+
| `activity-edge-case-refinement` | Systematic edge-case discovery | `verifier` |
|
|
306
|
+
| `activity-random-test-tactics` | Randomized, fuzz, and property-inspired tests | `verifier` |
|
|
307
|
+
| `activity-test-standards` | Establish and maintain `/TESTING.md` | `qa-engineer` |
|
|
308
|
+
| `activity-test-implementation` | Author Layer 1-2 tests with enforced boundaries | `qa-engineer` |
|
|
309
|
+
| `activity-coverage-gap-analysis` | Coverage measurement and risk-ranked gaps | `qa-engineer` |
|
|
310
|
+
| `memo-cli-usage` | Shared architectural memory across sessions | `product-engineer`, `developer`, `technical-writer` |
|
|
287
311
|
|
|
288
312
|
---
|
|
289
313
|
|
|
@@ -302,7 +326,7 @@ Copilot reads `.github/instructions/*.instructions.md`, Kiro reads `.kiro/steeri
|
|
|
302
326
|
|
|
303
327
|
### Hooks
|
|
304
328
|
|
|
305
|
-
`git-guard` blocks pushes and merges to `main
|
|
329
|
+
Kiro (`.kiro/hooks/`) and Claude Code (`.claude/hooks/`, wired via `.claude/settings.json`) both ship two deterministic `PreToolUse` hooks; Copilot has no hook system. `git-guard` matches shell (`Bash`/terminal) commands and blocks pushes and merges into the default branch (resolved dynamically — `master`/`trunk` repos are protected identically to `main`), including `gh pr merge` with its base resolved via `gh pr view` (not a `--base` text check, which doesn't exist on that subcommand), `gh pr merge --admin` (blocked outright), `gh pr merge --auto` when the resolved base is the default branch, and the raw-git escape of merging a story/issue branch straight into an integration branch, plus non-Conventional commit messages, inline `gh --body`, and human-only tags. `branch-guard` matches file-write tools (`Edit`/`Write`/`NotebookEdit` on Claude Code) and blocks write operations while on the default branch. Both hooks fail open on unexpected errors — except `git-guard`'s PR-base lookup, which fails **closed** (blocks the merge) if `gh pr view` can't verify the base, since an unverified base could be the default branch. Human PR review is the actual gate.
|
|
306
330
|
|
|
307
331
|
---
|
|
308
332
|
|
|
@@ -310,21 +334,22 @@ Copilot reads `.github/instructions/*.instructions.md`, Kiro reads `.kiro/steeri
|
|
|
310
334
|
|
|
311
335
|
> Copilot: `.github/prompts/*.prompt.md`. Claude Code: `.claude/commands/*.md`. Kiro: embedded in `.kiro/agents/*.md`.
|
|
312
336
|
|
|
313
|
-
| Prompt | Agent | Purpose
|
|
314
|
-
| -------------------------- | ---------------- |
|
|
315
|
-
| `product-engineer-init` | product-engineer | Initialize foundation documents
|
|
316
|
-
| `product-engineer-feature` | product-engineer | Design and plan a feature
|
|
317
|
-
| `product-engineer-issue` | product-engineer | Refine and plan a GitHub Issue
|
|
318
|
-
| `developer-execute` | developer | Execute an existing task list
|
|
319
|
-
| `planner` | planner | Orchestrate multi-story execution
|
|
320
|
-
| `planner-resume` | planner | Resume from checkpoint
|
|
321
|
-
| `ux-engineer` | ux-engineer | Generate UX mockups
|
|
322
|
-
| `github-ops` | github-ops | GitHub consistency
|
|
323
|
-
| `technical-writer` | technical-writer | Documentation maintenance
|
|
324
|
-
| `housekeeping` | housekeeping | Lint, type, test fixes
|
|
325
|
-
| `qa-engineer` | qa-engineer | Testing standard and coverage gate
|
|
326
|
-
| `
|
|
327
|
-
| `verifier-
|
|
337
|
+
| Prompt | Agent | Purpose |
|
|
338
|
+
| -------------------------- | ---------------- | ------------------------------------- |
|
|
339
|
+
| `product-engineer-init` | product-engineer | Initialize foundation documents |
|
|
340
|
+
| `product-engineer-feature` | product-engineer | Design and plan a feature |
|
|
341
|
+
| `product-engineer-issue` | product-engineer | Refine and plan a GitHub Issue |
|
|
342
|
+
| `developer-execute` | developer | Execute an existing task list |
|
|
343
|
+
| `planner` | planner | Orchestrate multi-story execution |
|
|
344
|
+
| `planner-resume` | planner | Resume from checkpoint |
|
|
345
|
+
| `ux-engineer` | ux-engineer | Generate UX mockups |
|
|
346
|
+
| `github-ops` | github-ops | GitHub consistency |
|
|
347
|
+
| `technical-writer` | technical-writer | Documentation maintenance |
|
|
348
|
+
| `housekeeping` | housekeeping | Lint, type, test fixes |
|
|
349
|
+
| `qa-engineer` | qa-engineer | Testing standard and coverage gate |
|
|
350
|
+
| `infra-engineer` | infra-engineer | Plan and apply infrastructure changes |
|
|
351
|
+
| `verifier-design` | verifier | Generate compliance test plan |
|
|
352
|
+
| `verifier-audit` | verifier | Grey-box fidelity audit |
|
|
328
353
|
|
|
329
354
|
---
|
|
330
355
|
|
|
@@ -349,23 +374,20 @@ The `verifier` audit after implementation is mandatory and non-skippable before
|
|
|
349
374
|
|
|
350
375
|
## File Organization
|
|
351
376
|
|
|
352
|
-
| Directory | Contents
|
|
353
|
-
| --------------------- |
|
|
354
|
-
| `/docs/` | Documentation — see [`docs/README.md`](docs/README.md) for the index
|
|
355
|
-
| `/docs/adr/` | Architecture decision records
|
|
356
|
-
| `/docs/requirements/` | PRDs produced by the refine skill
|
|
357
|
-
| `/workstream/` | Active feature work — specs, stories, task lists, fidelity reports
|
|
358
|
-
| `bin/` | CLI
|
|
359
|
-
| `core/` | Business logic —
|
|
360
|
-
| `
|
|
361
|
-
| `
|
|
362
|
-
| `
|
|
363
|
-
|
|
|
364
|
-
|
|
|
365
|
-
|
|
|
366
|
-
| `.github/` | Copilot agents, skills, instructions, prompts; CI workflows |
|
|
367
|
-
| `.claude/` | Claude Code agents, skills, commands, hooks |
|
|
368
|
-
| `.kiro/` | Kiro agents, skills, steering, hooks |
|
|
377
|
+
| Directory | Contents |
|
|
378
|
+
| --------------------- | -------------------------------------------------------------------- |
|
|
379
|
+
| `/docs/` | Documentation — see [`docs/README.md`](docs/README.md) for the index |
|
|
380
|
+
| `/docs/adr/` | Architecture decision records |
|
|
381
|
+
| `/docs/requirements/` | PRDs produced by the refine skill |
|
|
382
|
+
| `/workstream/` | Active feature work — specs, stories, task lists, fidelity reports |
|
|
383
|
+
| `bin/` | CLI entrypoint (`dev-tasks.ts`) and its argument parser |
|
|
384
|
+
| `core/` | Business logic — `distribution` (install/update/status/pin/doctor) |
|
|
385
|
+
| `scripts/` | Bundle build, release, and formatting scripts |
|
|
386
|
+
| `templates/` | Claude settings, infra scaffold, deploy scripts, and CI workflows |
|
|
387
|
+
| `test/` | Unit and integration tests + fixtures |
|
|
388
|
+
| `.github/` | Copilot agents, skills, instructions, prompts; CI workflows |
|
|
389
|
+
| `.claude/` | Claude Code agents, skills, commands, hooks |
|
|
390
|
+
| `.kiro/` | Kiro agents, skills, steering, hooks |
|
|
369
391
|
|
|
370
392
|
---
|
|
371
393
|
|