@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
|
@@ -19,12 +19,14 @@ Clarify the scope, acceptance criteria, and constraints of a feature or issue be
|
|
|
19
19
|
|
|
20
20
|
This step assumes foundation documents exist:
|
|
21
21
|
|
|
22
|
-
- `product
|
|
23
|
-
- `
|
|
22
|
+
- `product.md` — Understanding the overall product
|
|
23
|
+
- `tech.md` — Understanding technical constraints and patterns
|
|
24
24
|
|
|
25
25
|
If the user provides a **GitHub Issue number**, you **MUST** produce a lightweight refinement.
|
|
26
26
|
If the user provides a **feature description**, you **MUST** produce a full PRD.
|
|
27
27
|
|
|
28
|
+
Before drafting either output, this activity invokes the `activity-grill` sub-skill (WHAT phase for PRD Creation mode, Issue Mode for Issue Refinement mode) to walk the design tree to shared understanding, and writes every resolved question to `workstream/decisions-<feature>.md` — see Mode A and Mode B Process below.
|
|
29
|
+
|
|
28
30
|
---
|
|
29
31
|
|
|
30
32
|
## Document Changelog Convention
|
|
@@ -61,14 +63,14 @@ Every document produced by this activity **MUST** include a **Changelog** table
|
|
|
61
63
|
|
|
62
64
|
1. **Receive Issue Reference:** User provides GitHub Issue number and repo.
|
|
63
65
|
2. **Read Issue:** Delegate to `github-ops` to fetch issue body, comments, labels, and status whenever possible.
|
|
64
|
-
3. **
|
|
65
|
-
4. **Refine Scope:** Summarize scope, non-goals, risks, and dependencies.
|
|
66
|
+
3. **Invoke `activity-grill`:** Before asking any clarifying question, invoke `activity-grill(mode="issue", cap=cap.issue)` (`cap.issue` defaults to 8; read from `docs/tech.md` § Grilling if that subsection exists, else the hardcoded default) (FR-15, AC-09). The candidate questions below seed the interview's question pool — `activity-grill` owns the one-question-at-a-time, resolve-before-ask mechanics, including mandatory reuse of a matching answer from any prior `decisions-<other-feature>.md` (cited in qualified `<other-feature>#D-NN` form, not re-asked) and read-only glossary treatment (no new term proposals) for the duration of this invocation. You **MUST NOT** proceed to scope refinement until `activity-grill` returns the exit gate satisfied.
|
|
67
|
+
4. **Refine Scope:** Summarize scope, non-goals, risks, and dependencies, citing inline (`… (D-NN)`) every statement a decision shaped.
|
|
66
68
|
5. **Update GitHub Issue:** Delegate to `github-ops` to add or update a "Refined Scope" section in the issue body.
|
|
67
69
|
6. **Save Output.**
|
|
68
70
|
|
|
69
71
|
If `github-ops` delegation is unavailable in the current runtime, you **MUST** apply `github-ops` conventions directly and explicitly note that fallback in your status output.
|
|
70
72
|
|
|
71
|
-
### Clarifying Questions (ask only what is missing)
|
|
73
|
+
### Candidate Clarifying Questions (seed the `activity-grill` interview; ask only what is missing)
|
|
72
74
|
|
|
73
75
|
- "What is the exact user-visible behavior change?"
|
|
74
76
|
- "What is explicitly out of scope?"
|
|
@@ -132,11 +134,19 @@ For each criterion, you **SHOULD** use a concise "Given / When / Then" style whe
|
|
|
132
134
|
- Edge-case checks:
|
|
133
135
|
- Acceptance-criteria-to-test mapping:
|
|
134
136
|
|
|
137
|
+
## Decisions
|
|
138
|
+
|
|
139
|
+
| ID | Decision (short form) |
|
|
140
|
+
| ---- | --------------------- |
|
|
141
|
+
| D-NN | … |
|
|
142
|
+
|
|
135
143
|
## Open Questions
|
|
136
144
|
|
|
137
145
|
- [Remaining unknowns]
|
|
138
146
|
```
|
|
139
147
|
|
|
148
|
+
The `## Decisions` table lists every decision ID `activity-grill` produced or reused that shaped this document (FR-14, AC-05) — the same shape this repository's own PRDs and specs already use. A refinement with zero decisions needed still runs the `activity-grill` interview and still requires the explicit exit-gate confirmation; the table may legitimately be empty in that case.
|
|
149
|
+
|
|
140
150
|
### Output
|
|
141
151
|
|
|
142
152
|
- **Location:** `/workstream/`
|
|
@@ -149,12 +159,12 @@ For each criterion, you **SHOULD** use a concise "Given / When / Then" style whe
|
|
|
149
159
|
### Process
|
|
150
160
|
|
|
151
161
|
1. **Receive Feature Scope:** User describes the features or feature set.
|
|
152
|
-
2. **
|
|
162
|
+
2. **Invoke `activity-grill`:** Before asking any clarifying question, invoke `activity-grill(phase="WHAT", cap=cap.what)` (`cap.what` defaults to 25; read from `docs/tech.md` § Grilling if that subsection exists, else the hardcoded default) (FR-12, AC-01). The candidate questions below seed the interview's question pool — `activity-grill` owns the one-question-at-a-time, resolve-before-ask mechanics and the decision-tree summary/cap cadence. You **MUST NOT** produce any PRD section, draft, or outline until `activity-grill` returns the exit gate satisfied.
|
|
153
163
|
3. **Reference Existing Documents:** Consider product context and technical guidelines.
|
|
154
|
-
4. **Generate PRD
|
|
164
|
+
4. **Generate PRD:** Cite inline (`… (D-NN)`) every requirement, goal, or scope statement a decision shaped.
|
|
155
165
|
5. **Save Output.**
|
|
156
166
|
|
|
157
|
-
### Clarifying Questions
|
|
167
|
+
### Candidate Clarifying Questions (seed the `activity-grill` interview)
|
|
158
168
|
|
|
159
169
|
- **Feature Title & Scope:** "What is the main feature? What is included?"
|
|
160
170
|
- **Affected Repositories:** "Which repositories will be affected by this feature? (e.g., `owner/repo-frontend`, `owner/repo-backend`)"
|
|
@@ -190,6 +200,53 @@ For each criterion, you **SHOULD** use a concise "Given / When / Then" style whe
|
|
|
190
200
|
16. **Constraints & Dependencies** — Timeline, resource, external dependencies
|
|
191
201
|
17. **Security & Compliance** — Security, privacy, auth requirements
|
|
192
202
|
18. **Open Questions** — Ambiguities needing clarification
|
|
203
|
+
19. **Decisions** — Table (`ID | Decision (short form)`) listing every `activity-grill` decision ID consumed by this PRD (FR-14, AC-05); may legitimately be empty for a trivial feature that needed no decisions, but the `activity-grill` interview and exit-gate confirmation still ran
|
|
204
|
+
20. **Vocabulary** — `## Vocabulary` table listing every domain term the PRD uses and where each one stands against the glossary: `existing`, `proposed`, or settled by a decision (FR-20, AC-07). See "Vocabulary Section" below
|
|
205
|
+
|
|
206
|
+
### Vocabulary Section (FR-20, AC-07)
|
|
207
|
+
|
|
208
|
+
Every PRD carries a `## Vocabulary` section immediately after `## Decisions`. It lists the domain terms the PRD uses and where each one stands against `docs/domain/ubiquitous-language.md`, the repository's canonical vocabulary:
|
|
209
|
+
|
|
210
|
+
```markdown
|
|
211
|
+
## Vocabulary
|
|
212
|
+
|
|
213
|
+
| Term | Status in glossary | Bounded context | Definition (proposals only) | Forbidden synonyms (proposals only) |
|
|
214
|
+
| ---- | --------------------------------------- | --------------- | --------------------------- | ----------------------------------- |
|
|
215
|
+
| … | existing \| proposed \| conflict → D-NN | … | … | … |
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
A row is complete when one of these holds:
|
|
219
|
+
|
|
220
|
+
- `existing` — the glossary already defines the term (matched case-insensitively). The proposal columns stay empty.
|
|
221
|
+
- `proposed` — the row carries a bounded context, a definition, and forbidden synonyms. `none` is an answer for forbidden synonyms; an empty cell is not. A `proposed` row for a term the glossary already defines is **incomplete** — use `existing`.
|
|
222
|
+
- `conflict → D-NN` — a recorded decision settled a clash between this term and one already in the glossary. `->` and `→` are both accepted, and the ID may be qualified (`<feature>#D-NN`).
|
|
223
|
+
|
|
224
|
+
A PRD that genuinely introduces no domain concept carries the section with exactly one line, which is complete on its own:
|
|
225
|
+
|
|
226
|
+
```markdown
|
|
227
|
+
## Vocabulary
|
|
228
|
+
|
|
229
|
+
None — this PRD introduces no domain concepts.
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
Terms are identified during grilling, from what the user actually said. You **MUST NOT** derive them by scanning the PRD's prose for likely-looking nouns (D-65) — a list assembled that way is a list nobody can act on.
|
|
233
|
+
|
|
234
|
+
### Approval Append (FR-20, specification §8.4)
|
|
235
|
+
|
|
236
|
+
The glossary grows when the user approves the PRD — **never when the PRD is drafted**. A term recorded at draft time is a term nobody agreed to.
|
|
237
|
+
|
|
238
|
+
When the user approves a PRD, for each `proposed` row you **MUST**:
|
|
239
|
+
|
|
240
|
+
1. Resolve the row's bounded context against the `docs/tech.md` package map (FR-63). If it matches no package name and no `Bounded context` value, you **MUST NOT** create the heading — refuse the append for that row and report the unresolved context to the user. An unresolvable heading fails `lint` for everyone who comes after.
|
|
241
|
+
2. Append a `### <Term>` entry under the matching `## Bounded Context:` heading in `docs/domain/ubiquitous-language.md`, creating that heading only when the context resolved. The entry carries all five fields: `Definition` and `Forbidden synonyms` from the row, `Invariants` (`none` when there are none), `Origin` to the PRD's path, and `Status: active`.
|
|
242
|
+
3. Add one changelog row naming every term this approval added, in `+term` form (`+decision log, +exit gate`), and bump the frontmatter `version`.
|
|
243
|
+
4. On the first append, flip the frontmatter `status` from `unfilled` to `active`. `unfilled` means "no vocabulary established yet", never permission to invent one.
|
|
244
|
+
|
|
245
|
+
A `conflict → D-NN` row whose decision superseded a term already in the glossary rewrites that term's `Status` to `superseded by <New Term> (<feature#D-NN>)`. The old entry **MUST** stay — terms are superseded, never deleted (FR-19).
|
|
246
|
+
|
|
247
|
+
Running the append again over an already-approved PRD **MUST** be a no-op: its rows now read `existing`, and neither the entry nor the changelog row is duplicated.
|
|
248
|
+
|
|
249
|
+
This append is `activity-refine`'s write and nobody else's. `activity-grill` surfaces vocabulary conflicts as questions and writes only the decision log (D-61).
|
|
193
250
|
|
|
194
251
|
### Diagram Guidelines
|
|
195
252
|
|
|
@@ -228,10 +285,13 @@ Rules:
|
|
|
228
285
|
|
|
229
286
|
1. You **MUST NOT** start implementing anything.
|
|
230
287
|
2. You **MUST** detect the mode based on user input (issue number vs. feature description).
|
|
231
|
-
3. You **MUST** ask clarifying questions to fill gaps.
|
|
232
|
-
4.
|
|
233
|
-
5. You **
|
|
234
|
-
6. You **
|
|
235
|
-
7.
|
|
236
|
-
8.
|
|
237
|
-
9.
|
|
288
|
+
3. You **MUST** ask clarifying questions to fill gaps, conducted through `activity-grill` (WHAT phase for PRD Creation mode, Issue Mode for Issue Refinement mode) — you **MUST NOT** draft any part of the document until `activity-grill`'s exit gate returns satisfied (FR-12, FR-15).
|
|
289
|
+
4. Before presenting the PRD for review, you **MUST** run `checkVocabularySection()` from `core/checks/glossary.ts` over the drafted document and the repository's glossary, and **MUST** report every finding to the user by its rule name: `vocabulary-missing` when the `## Vocabulary` section is absent, `vocabulary-incomplete` naming the row that accounts for no term (AC-07, D-65). The same check runs under `lint` over `docs/requirements/`, so a finding left unfixed here becomes a failing gate later.
|
|
290
|
+
5. You **MUST** present the document for user review.
|
|
291
|
+
6. You **SHOULD** iterate based on feedback.
|
|
292
|
+
7. You **MUST** save the finalized document.
|
|
293
|
+
8. In Issue Refinement mode, you **MUST** update the GitHub Issue with a "Refined Scope" section by delegating to `github-ops` whenever possible.
|
|
294
|
+
9. When updating an existing document, you **MUST** add a new row to the Changelog table with an incremented version, the current date, a summary of changes, and the responsible author/agent.
|
|
295
|
+
10. After producing the document, if the feature includes UI/UX scope (detected by keywords: UI, screen, page, form, modal, dialog, navigation, layout, component, responsive, accessibility), you **SHOULD** add the following recommendation to the user: "This feature has UI scope. **Recommended:** use `ux-engineer` (lite mode) to generate screen sketches before proceeding to spec/stories."
|
|
296
|
+
11. You **MUST** cite every decision that shaped a requirement or scope statement inline (`… (D-NN)`), and **MUST** populate the document's `## Decisions` section with every ID consumed from the `activity-grill` session, in qualified `<feature>#D-NN` form when reusing a decision from another feature's log (FR-14, AC-05).
|
|
297
|
+
12. On user approval of a PRD, you **MUST** perform the Approval Append into `docs/domain/ubiquitous-language.md` for every `proposed` Vocabulary row, exactly as "Approval Append" above describes — and **MUST NOT** perform it when the PRD is merely drafted or revised (FR-20, D-61).
|
|
@@ -86,6 +86,31 @@ Non-JS packages are **not** held to these names. Record their equivalent command
|
|
|
86
86
|
|
|
87
87
|
Report per package: reached, or missed with the gate that fails to reach it.
|
|
88
88
|
|
|
89
|
+
### Per-package procedure (monorepo)
|
|
90
|
+
|
|
91
|
+
The checklist above is per package, not per repository. Run it once for
|
|
92
|
+
each package, from the same list the package map in `docs/tech.md`
|
|
93
|
+
records:
|
|
94
|
+
|
|
95
|
+
1. Enumerate packages from the package map. Where it is absent or stale,
|
|
96
|
+
fall back to the workspace signals themselves.
|
|
97
|
+
2. For each package, record the test command it actually defines and
|
|
98
|
+
whether the aggregate root command reaches it.
|
|
99
|
+
3. **A package with no test script is a finding, not a pass.** Record it
|
|
100
|
+
as `no test script` — distinct from `unreachable`, because the fix
|
|
101
|
+
differs: one needs a script, the other needs wiring.
|
|
102
|
+
4. Report one row per package:
|
|
103
|
+
|
|
104
|
+
| Package | Test command | Reached by root `test` | Finding |
|
|
105
|
+
| ----------- | ------------ | ---------------------- | ------------------------------ |
|
|
106
|
+
| `@acme/api` | `vitest run` | yes | — |
|
|
107
|
+
| `@acme/web` | `vitest run` | **no** | unreachable from the aggregate |
|
|
108
|
+
| `@acme/cli` | — | n/a | no test script |
|
|
109
|
+
|
|
110
|
+
This is an extension of the single-package procedure, not a parallel
|
|
111
|
+
monorepo path. A single-package repository produces the same table with
|
|
112
|
+
one row.
|
|
113
|
+
|
|
89
114
|
### Worked example
|
|
90
115
|
|
|
91
116
|
A monorepo defines `test:node` as `app && scraper && db` while the `api` package holds the largest suite. Every script name is canonical. The CI job and the deploy quality gate both run the aggregate.
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: aws-ops
|
|
3
|
+
description: "AWS CLI command sets, resource tiers, cost inputs, backup and revert sources, and log table for infra-engineer. Use when planning or applying AWS infrastructure changes."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# AWS Operations (aws-ops)
|
|
7
|
+
|
|
8
|
+
Per-surface mechanism skill for `infra-engineer`. It supplies the AWS CLI command sets, resource tiers, cost inputs, backup and revert sources, and the AWS log table. It does not restate the agent's working loop, approval, revert, or backup rules — those live in the agent body. AWS has no native plan, so this skill provides the synthesized plan inputs: discovery commands, the delta, and the exact forward and revert commands per change kind.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
> **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
|
|
13
|
+
|
|
14
|
+
## Tool declaration
|
|
15
|
+
|
|
16
|
+
| Field | Value |
|
|
17
|
+
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
18
|
+
| `name` | `aws` |
|
|
19
|
+
| `probe` | `aws --version` (expects `aws-cli/2.x`) |
|
|
20
|
+
| `floor` | AWS CLI `2.15` minimum; major `2.x` REQUIRED. A `1.x` install is `below-floor`. |
|
|
21
|
+
| `auth_probe` | `aws sts get-caller-identity --output json` |
|
|
22
|
+
| `remediation` | "Install AWS CLI v2 (`2.15`+) from the AWS docs and run `aws configure` or set a named profile; this skill never auto-installs and offers no v1 fallback." |
|
|
23
|
+
|
|
24
|
+
Any non-`ok` tool-check result blocks the phase with the remediation string. All parseable output uses `--output json`. Identity is asserted by comparing `Account` from `sts get-caller-identity` with the target environment's `aws.account_id`; a mismatch is `wrong-identity` and blocks.
|
|
25
|
+
|
|
26
|
+
## Resource tiers
|
|
27
|
+
|
|
28
|
+
| Tier | AWS resources |
|
|
29
|
+
| --------------- | --------------------------------------------------------------------------------------------------------------- |
|
|
30
|
+
| **foundation** | VPC, subnets, route tables, internet/NAT gateways, ECS cluster, ECR registry, IAM roles/trust, KMS keys |
|
|
31
|
+
| **application** | ECS service, task definition, target group, security group, Secrets Manager secret, ACM certificate, DNS record |
|
|
32
|
+
|
|
33
|
+
Foundation resources are **discovery-only**: this skill provides no apply commands for them. A foundation change is routed to the environment's `tier0_tool` (cdk, terraform, cloudformation) with `status: routed-to-<tool>`; the agent never writes foundation resources directly.
|
|
34
|
+
|
|
35
|
+
## Command sets per change kind
|
|
36
|
+
|
|
37
|
+
Every command references secrets by ARN or name, never by value. Forward and revert are paired so `rollback.sh` can be generated.
|
|
38
|
+
|
|
39
|
+
### Discover (read-only)
|
|
40
|
+
|
|
41
|
+
```sh
|
|
42
|
+
aws sts get-caller-identity --output json
|
|
43
|
+
aws ecs list-clusters --output json
|
|
44
|
+
aws ecs list-services --cluster "$CLUSTER" --output json
|
|
45
|
+
aws ecs describe-services --cluster "$CLUSTER" --services "$SVC" --output json
|
|
46
|
+
aws ecr describe-repositories --output json
|
|
47
|
+
aws elbv2 describe-target-groups --output json
|
|
48
|
+
aws elbv2 describe-target-health --target-group-arn "$TG_ARN" --output json
|
|
49
|
+
aws iam list-attached-role-policies --role-name "$ROLE" --output json
|
|
50
|
+
aws secretsmanager list-secrets --output json
|
|
51
|
+
aws acm list-certificates --output json
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### Build and push image (ECR)
|
|
55
|
+
|
|
56
|
+
- Forward:
|
|
57
|
+
```sh
|
|
58
|
+
aws ecr get-login-password --region "$REGION" | docker login --username AWS --password-stdin "$ACCOUNT.dkr.ecr.$REGION.amazonaws.com"
|
|
59
|
+
docker build -t "$REPO:$TAG" .
|
|
60
|
+
docker push "$ACCOUNT.dkr.ecr.$REGION.amazonaws.com/$REPO:$TAG"
|
|
61
|
+
```
|
|
62
|
+
- Revert: redeploy the previous image tag (see ECS below); images are immutable, so no delete is required for revert.
|
|
63
|
+
|
|
64
|
+
### Create and update ECS service and task definition
|
|
65
|
+
|
|
66
|
+
- Forward:
|
|
67
|
+
```sh
|
|
68
|
+
aws ecs register-task-definition --cli-input-json file://taskdef.json --output json
|
|
69
|
+
aws ecs update-service --cluster "$CLUSTER" --service "$SVC" --task-definition "$FAMILY:$REV" --output json
|
|
70
|
+
```
|
|
71
|
+
- Verify: `aws ecs describe-services --cluster "$CLUSTER" --services "$SVC" --query 'services[0].deployments' --output json` shows the new revision `PRIMARY` and `runningCount == desiredCount`.
|
|
72
|
+
- Revert: `aws ecs update-service --cluster "$CLUSTER" --service "$SVC" --task-definition "$FAMILY:$PREV_REV"` using the **previous task definition revision** recorded before the change.
|
|
73
|
+
|
|
74
|
+
### IAM policy create and attach
|
|
75
|
+
|
|
76
|
+
- Forward:
|
|
77
|
+
```sh
|
|
78
|
+
aws iam create-policy --policy-name "$NAME" --policy-document file://policy.json --output json
|
|
79
|
+
aws iam attach-role-policy --role-name "$ROLE" --policy-arn "$POLICY_ARN"
|
|
80
|
+
```
|
|
81
|
+
- Verify: `aws iam list-attached-role-policies --role-name "$ROLE"` includes the ARN.
|
|
82
|
+
- Revert (reverse order): `aws iam detach-role-policy --role-name "$ROLE" --policy-arn "$POLICY_ARN"` then `aws iam delete-policy --policy-arn "$POLICY_ARN"`.
|
|
83
|
+
|
|
84
|
+
### Secrets Manager (reference by ARN)
|
|
85
|
+
|
|
86
|
+
- Forward: `aws secretsmanager create-secret --name "$NAME" --secret-string file://value.json` or `put-secret-value`. Consumers reference the secret by its ARN in task definitions; the value is never read into a shell variable that is later echoed.
|
|
87
|
+
- Revert: `aws secretsmanager delete-secret --secret-id "$ARN" --recovery-window-in-days 7` (recoverable) or restore the prior version by `put-secret-value` from the source of truth, never from a transcript.
|
|
88
|
+
|
|
89
|
+
### ACM certificate request and DNS validation
|
|
90
|
+
|
|
91
|
+
- Forward:
|
|
92
|
+
```sh
|
|
93
|
+
aws acm request-certificate --domain-name "$FQDN" --validation-method DNS --output json
|
|
94
|
+
aws acm describe-certificate --certificate-arn "$CERT_ARN" --query 'Certificate.DomainValidationOptions' --output json
|
|
95
|
+
```
|
|
96
|
+
DNS validation records are added through the Cloudflare DNS step in the agent body.
|
|
97
|
+
- Revert: `aws acm delete-certificate --certificate-arn "$CERT_ARN"` once no listener references it.
|
|
98
|
+
|
|
99
|
+
### ALB target health and CloudWatch retention
|
|
100
|
+
|
|
101
|
+
```sh
|
|
102
|
+
aws elbv2 describe-target-health --target-group-arn "$TG_ARN" --output json
|
|
103
|
+
aws logs put-retention-policy --log-group-name "$LG" --retention-in-days 30
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
## Cost estimation
|
|
107
|
+
|
|
108
|
+
`plan.md` lists each resource with a monthly estimate and its source (the AWS pricing page URL or a `aws pricing get-products` call). The always-relevant cost list is stated on every AWS plan even when zero:
|
|
109
|
+
|
|
110
|
+
- **NAT gateway** — hourly + per-GB processing.
|
|
111
|
+
- **Application Load Balancer** — hourly + LCU.
|
|
112
|
+
- **RDS instance** — instance-hours + storage + backups.
|
|
113
|
+
- **EC2 / Fargate capacity** — vCPU and memory hours.
|
|
114
|
+
- **Interface VPC endpoints** — hourly per AZ + per-GB.
|
|
115
|
+
|
|
116
|
+
Any resource at or above the environment cost threshold is marked `APPROVAL REQUIRED` and approved by name.
|
|
117
|
+
|
|
118
|
+
## Backup commands and revert sources
|
|
119
|
+
|
|
120
|
+
| Change kind | Backup command (production, touches state) | Revert source |
|
|
121
|
+
| ---------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------- |
|
|
122
|
+
| RDS schema/data | `aws rds create-db-snapshot --db-instance-identifier "$DB" --db-snapshot-identifier "$SNAP"` | Restore snapshot to a new instance |
|
|
123
|
+
| S3 object change | Confirm versioning: `aws s3api get-bucket-versioning --bucket "$B"`; require `Enabled` before overwrite | Previous object version id |
|
|
124
|
+
| ECS deploy | Record current task definition revision | **Previous task definition revision** |
|
|
125
|
+
| Image deploy | Record current image tag | **Previous image tag** |
|
|
126
|
+
|
|
127
|
+
A production step with `touches state: yes` records the backup id and restore command in `result.md` before it applies.
|
|
128
|
+
|
|
129
|
+
## AWS log table
|
|
130
|
+
|
|
131
|
+
Every query is time-bounded and its output passes through the redaction pattern set before it reaches a transcript or file.
|
|
132
|
+
|
|
133
|
+
| Source | Command |
|
|
134
|
+
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
135
|
+
| CloudWatch Logs | `aws logs tail "$LG" --since "$START" --format short` |
|
|
136
|
+
| ECS task failure | `aws ecs describe-tasks --cluster "$CLUSTER" --tasks "$TASK" --query 'tasks[0].stoppedReason'` |
|
|
137
|
+
| ALB access logs | Query the S3 access-log prefix for the bounded window |
|
|
138
|
+
| Logs Insights | `aws logs start-query --log-group-name "$LG" --start-time "$S" --end-time "$E" --query-string ...` with a **bounded window** and stated scan scope before the billed query |
|
|
139
|
+
| VPC Flow Logs | Filtered by ENI and the bounded window |
|
|
140
|
+
| CloudTrail | `aws cloudtrail lookup-events --start-time "$S" --end-time "$E" --lookup-attributes ...` |
|
|
141
|
+
| GitHub Actions | `gh run view "$RUN" --log-failed` |
|
|
142
|
+
|
|
143
|
+
## Cost sweep categories (read-only)
|
|
144
|
+
|
|
145
|
+
- Unassociated Elastic IPs (`eip` addresses with no association).
|
|
146
|
+
- Available (unattached) EBS volumes.
|
|
147
|
+
- Stale EBS snapshots past a retention age.
|
|
148
|
+
- Idle NAT gateways with negligible processed bytes.
|
|
149
|
+
- Load balancers with no healthy targets.
|
|
150
|
+
- Zero-scaled ECS services still holding a load balancer.
|
|
151
|
+
- Resources whose `ExpiresAt` tag is in the past.
|
|
152
|
+
- Untagged resources missing environment/owner/ChangeId tags.
|
|
153
|
+
- CloudWatch log groups without a retention policy.
|
|
154
|
+
|
|
155
|
+
Sweep findings are reported, never remediated automatically.
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: deploy-ops
|
|
3
|
+
description: "Deploy script contract, environment mapping, tag policy, deploy-target framing, and workflow scaffolding for infra-engineer. Use when planning or applying deploys, rollbacks, or releases."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Deploy Operations (deploy-ops)
|
|
7
|
+
|
|
8
|
+
Cross-surface mechanism skill for `infra-engineer`. It supplies the deploy **script contract**, the environment mapping table, the tag policy summary, the deploy-target framing, and the workflow scaffolding procedure. It does not restate the agent's working loop, approval, revert, or backup rules — those live in the agent body — and it contains no deploy logic itself: the logic lives in the `templates/scripts/*.sh` files, which this skill only documents and wires. The skill declares the tools `yq` and `gh`.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
> **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
|
|
13
|
+
|
|
14
|
+
## Tool declaration
|
|
15
|
+
|
|
16
|
+
| Field | Value |
|
|
17
|
+
| ------------- | ------------------------------------------------------------------------------------------------------------------------- |
|
|
18
|
+
| `name` | `yq`, `gh` |
|
|
19
|
+
| `probe` | `yq --version`; `gh --version` |
|
|
20
|
+
| `floor` | `yq` 4.x (the mikefarah Go implementation); minimum `4.0`. A 3.x or Python `yq` is `below-floor`. `gh` any current 2.x. |
|
|
21
|
+
| `auth_probe` | `gh auth status` (for release/PR operations); `yq` needs no auth. |
|
|
22
|
+
| `remediation` | "Install `yq` 4.x from mikefarah/yq and `gh` from cli.github.com; this skill never auto-installs and offers no fallback." |
|
|
23
|
+
|
|
24
|
+
`yq` reads and resolves `infra/environments.yaml`; `gh` performs release and PR operations for the release flow. Every command references secrets by name, never by value, and every log or status query passes through the redaction pattern set before it reaches a transcript.
|
|
25
|
+
|
|
26
|
+
## Script contract
|
|
27
|
+
|
|
28
|
+
The deploy surface is a fixed set of `bash` scripts under `templates/scripts/`. Each is `set -euo pipefail`, supports `--help`, reads the environment definition from `infra/environments.yaml` via `yq`, and contains no environment names or secrets of its own.
|
|
29
|
+
|
|
30
|
+
| Script | Purpose | Mutates? | `--dry-run` | Exit codes |
|
|
31
|
+
| ------------------ | ------------------------------------------------------------ | -------- | ----------- | ------------------------------------------ |
|
|
32
|
+
| `deploy.sh` | Ordered deploy pipeline for one environment | yes | yes | 0 ok · 1 error · 2 blocked · 3 verify-fail |
|
|
33
|
+
| `deploy-verify.sh` | Post-deploy health check; prints the rollback line on fail | no | no | 0 healthy · 2 blocked · 3 fail |
|
|
34
|
+
| `rollback.sh` | Roll back to the previous good version from `infra/changes/` | yes | yes | 0 ok · 1 error · 2 blocked |
|
|
35
|
+
| `deploy-status.sh` | Read-only current status of an environment | no | n/a | 0 ok · 2 blocked |
|
|
36
|
+
| `release.sh` | Generalized changelog/version/tag/push release automation | yes | yes | 0 ok · 1 error · 2 blocked |
|
|
37
|
+
|
|
38
|
+
### `deploy.sh` ordered steps
|
|
39
|
+
|
|
40
|
+
`deploy.sh <env>` runs eight ordered steps and exits `2` on any blocked condition:
|
|
41
|
+
|
|
42
|
+
1. **preflight** — clean tree, ref rules, identity assertion.
|
|
43
|
+
2. **validate** — the project quality gate; **never** skippable by any flag.
|
|
44
|
+
3. **build** — artifact tagged `vX.Y.Z` (production) or `main-<short-sha>` (non-production).
|
|
45
|
+
4. **backup** — taken when the environment is production **and** the change migrates; **never** skipped for production.
|
|
46
|
+
5. **migrate** — with explicit confirmation for production.
|
|
47
|
+
6. **deploy** — via the detected deploy kind.
|
|
48
|
+
7. **verify** — delegates to `deploy-verify.sh`.
|
|
49
|
+
8. **record** — appends a change record under `infra/changes/`.
|
|
50
|
+
|
|
51
|
+
No `latest` mutable tag is ever a deploy target. The deploy kind is detected from the platform blocks present in the environment; `deploy.sh` refuses (`exit 2`) when the detection is ambiguous (more than one platform block and no explicit `deploy_kind`), per spec open question 3.
|
|
52
|
+
|
|
53
|
+
### Failure and rollback
|
|
54
|
+
|
|
55
|
+
`deploy-verify.sh` exits `3` on a failed health check and prints the exact `rollback.sh <env>` invocation to run next. `rollback.sh <env>` resolves the previous good version from `infra/changes/` with no manual lookup; `--to <version>` overrides the resolved version.
|
|
56
|
+
|
|
57
|
+
## Environment mapping table
|
|
58
|
+
|
|
59
|
+
Environment names and platform blocks are read from `infra/environments.yaml` via `yq`. A missing or template-status (`# status: template`) file exits `2`.
|
|
60
|
+
|
|
61
|
+
| Trigger / ref | Environment | Rule |
|
|
62
|
+
| ---------------------------- | ----------- | ----------------------------------------------------------------------------- |
|
|
63
|
+
| push to `main` | `dev` | non-production deploys `main` HEAD; artifact tagged `main-<short-sha>` |
|
|
64
|
+
| annotated tag `vX.Y.Z` | `prod` | production refuses any ref that is not an annotated tag on `main` |
|
|
65
|
+
| manual (`workflow_dispatch`) | any | dev is optional; installed only when a `production: false` environment exists |
|
|
66
|
+
|
|
67
|
+
## Tag policy summary
|
|
68
|
+
|
|
69
|
+
Tags are human-only and owned by the policy in `github-ops`: annotated `vX.Y.Z`, created on `main` only, immutable, no prerelease in v1. `deploy-ops` never creates, moves, or deletes a tag — `git-guard` rule 4 blocks agent tag operations deterministically. `release.sh` suggests the bump type from Conventional Commits and confirms it; production deploys consume the resulting annotated tag.
|
|
70
|
+
|
|
71
|
+
## Deploy-target framing
|
|
72
|
+
|
|
73
|
+
`deploy-ops` does not choose the platform for a consumer. It frames the decision so the operator (or `infra-engineer`) picks a **deploy target** deliberately, then records the choice in `infra/environments.yaml`.
|
|
74
|
+
|
|
75
|
+
| Decision input | Question the operator answers |
|
|
76
|
+
| ---------------- | -------------------------------------------------------------------- |
|
|
77
|
+
| compute platform | fly.io app, AWS ECS service, or another target? |
|
|
78
|
+
| data platform | is there a Supabase (or other) migration step to sequence? |
|
|
79
|
+
| environment tier | is this environment `production: true` or `false`? |
|
|
80
|
+
| ref discipline | does production consume an annotated tag, and does dev track `main`? |
|
|
81
|
+
| rollback source | is the previous good version recorded in `infra/changes/`? |
|
|
82
|
+
|
|
83
|
+
When two platform blocks are present with no explicit `deploy_kind`, the deploy target is ambiguous and `deploy.sh` refuses until the operator sets `deploy_kind`.
|
|
84
|
+
|
|
85
|
+
## Workflow scaffolding procedure
|
|
86
|
+
|
|
87
|
+
`deploy-ops` scaffolds the GitHub Actions workflow templates (`templates/workflows/`) into a consumer repo as recorded changes delivered by a draft PR — never applied silently.
|
|
88
|
+
|
|
89
|
+
1. Read `infra/environments.yaml`.
|
|
90
|
+
2. Install `deploy-dev.yml` **only when** an environment with `production: false` is declared.
|
|
91
|
+
3. Install `deploy-prod.yml` (triggered on the exact-semver tag, behind a required reviewer) and `rollback.yml` (`workflow_dispatch`) when a `production: true` environment exists.
|
|
92
|
+
4. Every workflow calls the canonical scripts only — no inline deploy logic.
|
|
93
|
+
5. Workflow edits are recorded changes; they are delivered by PR and reviewed by a human.
|
|
94
|
+
|
|
95
|
+
## `package.json` wrappers for JS/TS repos
|
|
96
|
+
|
|
97
|
+
For JavaScript/TypeScript repos only, `deploy-ops` generates thin `package.json` script wrappers so the deploy surface is reachable through the project's canonical script runner. The shell scripts remain the implementation; the wrappers are one-line delegations:
|
|
98
|
+
|
|
99
|
+
```jsonc
|
|
100
|
+
{
|
|
101
|
+
"scripts": {
|
|
102
|
+
"deploy": "bash templates/scripts/deploy.sh",
|
|
103
|
+
"deploy:verify": "bash templates/scripts/deploy-verify.sh",
|
|
104
|
+
"deploy:rollback": "bash templates/scripts/rollback.sh",
|
|
105
|
+
"deploy:status": "bash templates/scripts/deploy-status.sh",
|
|
106
|
+
"release": "bash templates/scripts/release.sh",
|
|
107
|
+
},
|
|
108
|
+
}
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Non-JS/TS repos call the scripts directly; no wrapper is generated.
|
|
112
|
+
|
|
113
|
+
## Human-only guard
|
|
114
|
+
|
|
115
|
+
`release.sh` and `deploy.sh prod` refuse to run when `CI` is set without `INFRA_HUMAN_APPROVED=1` exported by the protected-environment job, and refuse in a non-interactive agent context. This keeps release and production deploy decisions with a human even when the scripts run inside automation.
|
|
116
|
+
|
|
117
|
+
## Boundary rules
|
|
118
|
+
|
|
119
|
+
- No deploy logic lives in this skill or in a workflow; it lives only in `templates/scripts/*.sh`.
|
|
120
|
+
- No deploy targets a mutable `latest` tag.
|
|
121
|
+
- The agent never creates tags; tags are human-only per `github-ops`.
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: fly-ops
|
|
3
|
+
description: "flyctl command sets, resource tiers, cost inputs, backup and revert sources, and log table for infra-engineer. Use when planning or applying fly.io infrastructure changes."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Fly.io Operations (fly-ops)
|
|
7
|
+
|
|
8
|
+
Per-surface mechanism skill for `infra-engineer`. It supplies the `flyctl` command sets, resource tiers, cost inputs, backup and revert sources, and the fly.io log table. It does not restate the agent's working loop, approval, revert, or backup rules — those live in the agent body. fly.io has release history (`fly releases`) that makes revert concrete and volume snapshots that make backup concrete, so it is the cheapest surface for the manual Phase 1 verification.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
> **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
|
|
13
|
+
|
|
14
|
+
## Tool declaration
|
|
15
|
+
|
|
16
|
+
| Field | Value |
|
|
17
|
+
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
18
|
+
| `name` | `flyctl` |
|
|
19
|
+
| `probe` | `flyctl version` |
|
|
20
|
+
| `floor` | Current major release channel; minimum `0.3`. An older channel is `below-floor`. |
|
|
21
|
+
| `auth_probe` | `flyctl auth whoami` |
|
|
22
|
+
| `remediation` | "Install `flyctl` from fly.io and run `flyctl auth login` (or export `FLY_API_TOKEN`); this skill never auto-installs and offers no fallback." |
|
|
23
|
+
|
|
24
|
+
Use `--json` wherever `flyctl` supports it. Identity is asserted by comparing the authenticated org (from `flyctl auth whoami` / `flyctl orgs list --json`) with the target environment's `fly.org`; a mismatch is `wrong-identity` and blocks.
|
|
25
|
+
|
|
26
|
+
## Resource tiers
|
|
27
|
+
|
|
28
|
+
| Tier | Fly resources |
|
|
29
|
+
| --------------- | ----------------------------------------------------------------- |
|
|
30
|
+
| **foundation** | org |
|
|
31
|
+
| **application** | app, machine, volume, secret, certificate |
|
|
32
|
+
| **ephemeral** | throwaway apps, which carry an `ExpiresAt` tag and a cleanup step |
|
|
33
|
+
|
|
34
|
+
An ephemeral app without an `ExpiresAt` is a finding. Foundation (org) changes are routed, never written by this agent.
|
|
35
|
+
|
|
36
|
+
## Command sets per change kind
|
|
37
|
+
|
|
38
|
+
Every command references secrets by name, never by value.
|
|
39
|
+
|
|
40
|
+
### Discover (read-only)
|
|
41
|
+
|
|
42
|
+
```sh
|
|
43
|
+
flyctl auth whoami
|
|
44
|
+
flyctl apps list --json
|
|
45
|
+
flyctl status -a "$APP" --json
|
|
46
|
+
flyctl machine list -a "$APP" --json
|
|
47
|
+
flyctl volumes list -a "$APP" --json
|
|
48
|
+
flyctl secrets list -a "$APP"
|
|
49
|
+
flyctl certs list -a "$APP"
|
|
50
|
+
flyctl releases -a "$APP" --json
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### Create app
|
|
54
|
+
|
|
55
|
+
- Forward: `fly apps create "$APP" --org "$ORG"`
|
|
56
|
+
- Verify: `flyctl status -a "$APP" --json`
|
|
57
|
+
- Revert: `fly apps destroy "$APP" --yes` (requires the typed app name and environment name per the agent body).
|
|
58
|
+
|
|
59
|
+
### Deploy
|
|
60
|
+
|
|
61
|
+
- Forward: `fly deploy -a "$APP" --image "$IMAGE"` or a build then deploy:
|
|
62
|
+
```sh
|
|
63
|
+
fly deploy -a "$APP" --build-only --push --image-label "$TAG"
|
|
64
|
+
fly deploy -a "$APP" --image "registry.fly.io/$APP:$TAG"
|
|
65
|
+
```
|
|
66
|
+
- Verify: `flyctl status -a "$APP" --json` shows the new release healthy.
|
|
67
|
+
- Revert: `fly deploy -a "$APP" --image <previous>` using the previous image from `fly releases`.
|
|
68
|
+
|
|
69
|
+
### Secrets
|
|
70
|
+
|
|
71
|
+
- Forward: `fly secrets set KEY=value -a "$APP"` (value from its source of truth, never a transcript) / `fly secrets unset KEY -a "$APP"`.
|
|
72
|
+
- Revert: re-set the prior value from its source of truth; **never** reconstruct a secret from a transcript or log.
|
|
73
|
+
|
|
74
|
+
### Volumes
|
|
75
|
+
|
|
76
|
+
- Forward: `fly volumes create "$NAME" -a "$APP" --region "$REGION" --size "$GB"`.
|
|
77
|
+
- Backup: `fly volumes snapshots create "$VOL_ID"` before any production step touching a volume.
|
|
78
|
+
- Revert: restore from the recorded snapshot; `fly volumes destroy "$VOL_ID"` only after the typed confirmation.
|
|
79
|
+
|
|
80
|
+
### Certificates
|
|
81
|
+
|
|
82
|
+
- Forward: `fly certs add "$FQDN" -a "$APP"`; then `fly certs check "$FQDN" -a "$APP"`.
|
|
83
|
+
- Revert: `fly certs remove "$FQDN" -a "$APP" --yes`.
|
|
84
|
+
|
|
85
|
+
### Scale and machines
|
|
86
|
+
|
|
87
|
+
```sh
|
|
88
|
+
fly scale count "$N" -a "$APP"
|
|
89
|
+
fly scale vm "$SIZE" -a "$APP"
|
|
90
|
+
fly machine status "$MACHINE" -a "$APP" --json
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Revert for a scale change is the prior count/size recorded before the step.
|
|
94
|
+
|
|
95
|
+
### Destroy
|
|
96
|
+
|
|
97
|
+
`fly apps destroy "$APP" --yes` requires the operator to type both the app name and the environment name. A production foundation target is refused.
|
|
98
|
+
|
|
99
|
+
## Revert sources
|
|
100
|
+
|
|
101
|
+
- **Deploy:** `fly releases -a "$APP" --json` supplies the previous image; revert is `fly deploy --image <previous>`.
|
|
102
|
+
- **Secret:** re-set the prior value from its source of truth.
|
|
103
|
+
- **Volume:** the snapshot recorded as backup.
|
|
104
|
+
- **Scale/cert:** the prior value/record captured before the step.
|
|
105
|
+
|
|
106
|
+
## Backup
|
|
107
|
+
|
|
108
|
+
`fly volumes snapshots create "$VOL_ID"` runs before any production step that touches a volume; the snapshot id and the restore command are recorded in `result.md` before the step applies.
|
|
109
|
+
|
|
110
|
+
## Fly log table
|
|
111
|
+
|
|
112
|
+
Every query is time-bounded and its output passes through the redaction pattern set before it reaches a transcript or file.
|
|
113
|
+
|
|
114
|
+
| Source | Command |
|
|
115
|
+
| --------------- | ----------------------------------------- |
|
|
116
|
+
| App logs | `fly logs -a "$APP" --since "$START"` |
|
|
117
|
+
| App status | `fly status -a "$APP" --json` |
|
|
118
|
+
| Machine status | `fly machine status "$MACHINE" -a "$APP"` |
|
|
119
|
+
| Release history | `fly releases -a "$APP" --json` |
|
|
120
|
+
|
|
121
|
+
## Cost entries and sweep
|
|
122
|
+
|
|
123
|
+
Cost entries listed on every fly plan:
|
|
124
|
+
|
|
125
|
+
- **Machines** by size (shared/performance vCPU + memory).
|
|
126
|
+
- **Volumes** by GB.
|
|
127
|
+
- **Dedicated IPv4** addresses.
|
|
128
|
+
|
|
129
|
+
Sweep categories (read-only, reported never remediated):
|
|
130
|
+
|
|
131
|
+
- Stopped machines still holding volumes.
|
|
132
|
+
- Unattached volumes.
|
|
133
|
+
- Apps past their `ExpiresAt` tag.
|
|
134
|
+
|
|
135
|
+
## Boundary rules
|
|
136
|
+
|
|
137
|
+
- No AWS Secrets Manager entry for a fly-only workload; fly secrets stay on fly.
|
|
138
|
+
- `fly apps destroy` requires the typed app name and environment name.
|