@llipe.com/dev-tasks 0.6.6 → 0.7.3
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 +2 -0
- package/.claude/commands/developer.md +2 -0
- package/.claude/commands/planner.md +2 -0
- package/.claude/commands/product-engineer.md +13 -7
- package/.claude/skills/activity-init/SKILL.md +81 -8
- package/.github/agents/developer.agent.md +2 -0
- package/.github/agents/planner.agent.md +2 -0
- package/.github/agents/product-engineer.agent.md +13 -7
- package/.github/prompts/product-engineer-init.prompt.md +7 -1
- package/.github/skills/activity-init/SKILL.md +81 -8
- package/.kiro/agents/developer.md +2 -0
- package/.kiro/agents/planner.md +2 -0
- package/.kiro/agents/product-engineer.md +13 -7
- package/.kiro/skills/activity-init/SKILL.md +81 -8
- package/AGENTS.md +96 -1
- package/CHANGELOG.md +96 -0
- package/README.md +288 -632
- package/dist/adapters/cli/catalog-build.d.ts +30 -0
- package/dist/adapters/cli/catalog-build.d.ts.map +1 -0
- package/dist/adapters/cli/catalog-build.js +73 -0
- package/dist/adapters/cli/catalog-build.js.map +1 -0
- package/dist/adapters/cli/catalog-query.d.ts +13 -0
- package/dist/adapters/cli/catalog-query.d.ts.map +1 -0
- package/dist/adapters/cli/catalog-query.js +329 -0
- package/dist/adapters/cli/catalog-query.js.map +1 -0
- package/dist/adapters/cli/catalog-scaffold.d.ts +24 -0
- package/dist/adapters/cli/catalog-scaffold.d.ts.map +1 -0
- package/dist/adapters/cli/catalog-scaffold.js +46 -0
- package/dist/adapters/cli/catalog-scaffold.js.map +1 -0
- package/dist/adapters/cli/catalog-validate.d.ts +35 -0
- package/dist/adapters/cli/catalog-validate.d.ts.map +1 -0
- package/dist/adapters/cli/catalog-validate.js +122 -0
- package/dist/adapters/cli/catalog-validate.js.map +1 -0
- package/dist/adapters/cli/ctx-assemble.d.ts +19 -0
- package/dist/adapters/cli/ctx-assemble.d.ts.map +1 -0
- package/dist/adapters/cli/ctx-assemble.js +293 -0
- package/dist/adapters/cli/ctx-assemble.js.map +1 -0
- package/dist/adapters/cli/ctx-fetch.d.ts +49 -0
- package/dist/adapters/cli/ctx-fetch.d.ts.map +1 -0
- package/dist/adapters/cli/ctx-fetch.js +267 -0
- package/dist/adapters/cli/ctx-fetch.js.map +1 -0
- package/dist/adapters/cli/extract-all.d.ts +2 -2
- package/dist/adapters/cli/extract-all.d.ts.map +1 -1
- package/dist/adapters/cli/extract-all.js.map +1 -1
- package/dist/adapters/cli/extract-component.d.ts +2 -2
- package/dist/adapters/cli/extract-component.d.ts.map +1 -1
- package/dist/adapters/cli/extract-component.js.map +1 -1
- package/dist/adapters/cli/init.d.ts +37 -0
- package/dist/adapters/cli/init.d.ts.map +1 -0
- package/dist/adapters/cli/init.js +336 -0
- package/dist/adapters/cli/init.js.map +1 -0
- package/dist/adapters/cli/scope-gate.d.ts +25 -0
- package/dist/adapters/cli/scope-gate.d.ts.map +1 -0
- package/dist/adapters/cli/scope-gate.js +157 -0
- package/dist/adapters/cli/scope-gate.js.map +1 -0
- package/dist/adapters/cli/scope.d.ts +26 -0
- package/dist/adapters/cli/scope.d.ts.map +1 -0
- package/dist/adapters/cli/scope.js +172 -0
- package/dist/adapters/cli/scope.js.map +1 -0
- package/dist/adapters/cli/validate-component.d.ts +24 -0
- package/dist/adapters/cli/validate-component.d.ts.map +1 -0
- package/dist/adapters/cli/validate-component.js +62 -0
- package/dist/adapters/cli/validate-component.js.map +1 -0
- package/dist/adapters/cli/verify-contract-diff.d.ts +21 -0
- package/dist/adapters/cli/verify-contract-diff.d.ts.map +1 -0
- package/dist/adapters/cli/verify-contract-diff.js +69 -0
- package/dist/adapters/cli/verify-contract-diff.js.map +1 -0
- package/dist/adapters/cli/verify-drift.d.ts +24 -0
- package/dist/adapters/cli/verify-drift.d.ts.map +1 -0
- package/dist/adapters/cli/verify-drift.js +103 -0
- package/dist/adapters/cli/verify-drift.js.map +1 -0
- package/dist/adapters/cli/verify-impact.d.ts +23 -0
- package/dist/adapters/cli/verify-impact.d.ts.map +1 -0
- package/dist/adapters/cli/verify-impact.js +119 -0
- package/dist/adapters/cli/verify-impact.js.map +1 -0
- package/dist/bin/dev-tasks.d.ts +1 -1
- package/dist/bin/dev-tasks.js +28 -6
- package/dist/bin/dev-tasks.js.map +1 -1
- package/dist/bin/dt.js +488 -0
- package/dist/bin/dt.js.map +1 -1
- package/dist/core/catalog/build.d.ts +143 -0
- package/dist/core/catalog/build.d.ts.map +1 -0
- package/dist/core/catalog/build.js +475 -0
- package/dist/core/catalog/build.js.map +1 -0
- package/dist/core/catalog/checks/index.d.ts +18 -0
- package/dist/core/catalog/checks/index.d.ts.map +1 -0
- package/dist/core/catalog/checks/index.js +18 -0
- package/dist/core/catalog/checks/index.js.map +1 -0
- package/dist/core/catalog/checks/v01-schema.d.ts +17 -0
- package/dist/core/catalog/checks/v01-schema.d.ts.map +1 -0
- package/dist/core/catalog/checks/v01-schema.js +57 -0
- package/dist/core/catalog/checks/v01-schema.js.map +1 -0
- package/dist/core/catalog/checks/v02-v03-identity.d.ts +14 -0
- package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +1 -0
- package/dist/core/catalog/checks/v02-v03-identity.js +60 -0
- package/dist/core/catalog/checks/v02-v03-identity.js.map +1 -0
- package/dist/core/catalog/checks/v04-referential-integrity.d.ts +7 -0
- package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +1 -0
- package/dist/core/catalog/checks/v04-referential-integrity.js +32 -0
- package/dist/core/catalog/checks/v04-referential-integrity.js.map +1 -0
- package/dist/core/catalog/checks/v05-domain-existence.d.ts +6 -0
- package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +1 -0
- package/dist/core/catalog/checks/v05-domain-existence.js +23 -0
- package/dist/core/catalog/checks/v05-domain-existence.js.map +1 -0
- package/dist/core/catalog/checks/v06-v07-paths.d.ts +29 -0
- package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +1 -0
- package/dist/core/catalog/checks/v06-v07-paths.js +107 -0
- package/dist/core/catalog/checks/v06-v07-paths.js.map +1 -0
- package/dist/core/catalog/checks/v08-v10-contracts.d.ts +13 -0
- package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +1 -0
- package/dist/core/catalog/checks/v08-v10-contracts.js +70 -0
- package/dist/core/catalog/checks/v08-v10-contracts.js.map +1 -0
- package/dist/core/catalog/checks/v11-manual-fields.d.ts +16 -0
- package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +1 -0
- package/dist/core/catalog/checks/v11-manual-fields.js +60 -0
- package/dist/core/catalog/checks/v11-manual-fields.js.map +1 -0
- package/dist/core/catalog/checks/v12-cycles.d.ts +8 -0
- package/dist/core/catalog/checks/v12-cycles.d.ts.map +1 -0
- package/dist/core/catalog/checks/v12-cycles.js +28 -0
- package/dist/core/catalog/checks/v12-cycles.js.map +1 -0
- package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +7 -0
- package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +1 -0
- package/dist/core/catalog/checks/v13-orphan-contracts.js +33 -0
- package/dist/core/catalog/checks/v13-orphan-contracts.js.map +1 -0
- package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +8 -0
- package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +1 -0
- package/dist/core/catalog/checks/v14-v15-lifecycle.js +42 -0
- package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +1 -0
- package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +7 -0
- package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +1 -0
- package/dist/core/catalog/checks/v16-deprecated-consumers.js +47 -0
- package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +1 -0
- package/dist/core/catalog/checks/v17-low-confidence.d.ts +7 -0
- package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +1 -0
- package/dist/core/catalog/checks/v17-low-confidence.js +32 -0
- package/dist/core/catalog/checks/v17-low-confidence.js.map +1 -0
- package/dist/core/catalog/checks/v18-low-payload.d.ts +7 -0
- package/dist/core/catalog/checks/v18-low-payload.d.ts.map +1 -0
- package/dist/core/catalog/checks/v18-low-payload.js +33 -0
- package/dist/core/catalog/checks/v18-low-payload.js.map +1 -0
- package/dist/core/catalog/checks/v19-domain-membership.d.ts +8 -0
- package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +1 -0
- package/dist/core/catalog/checks/v19-domain-membership.js +55 -0
- package/dist/core/catalog/checks/v19-domain-membership.js.map +1 -0
- package/dist/core/catalog/coverage.d.ts +39 -0
- package/dist/core/catalog/coverage.d.ts.map +1 -0
- package/dist/core/catalog/coverage.js +62 -0
- package/dist/core/catalog/coverage.js.map +1 -0
- package/dist/core/catalog/graph.d.ts +49 -0
- package/dist/core/catalog/graph.d.ts.map +1 -0
- package/dist/core/catalog/graph.js +114 -0
- package/dist/core/catalog/graph.js.map +1 -0
- package/dist/core/catalog/index-model.d.ts +96 -0
- package/dist/core/catalog/index-model.d.ts.map +1 -0
- package/dist/core/catalog/index-model.js +8 -0
- package/dist/core/catalog/index-model.js.map +1 -0
- package/dist/core/catalog/queries.d.ts +69 -0
- package/dist/core/catalog/queries.d.ts.map +1 -0
- package/dist/core/catalog/queries.js +165 -0
- package/dist/core/catalog/queries.js.map +1 -0
- package/dist/core/catalog/resolve.d.ts +47 -0
- package/dist/core/catalog/resolve.d.ts.map +1 -0
- package/dist/core/catalog/resolve.js +318 -0
- package/dist/core/catalog/resolve.js.map +1 -0
- package/dist/core/catalog/scaffold.d.ts +31 -0
- package/dist/core/catalog/scaffold.d.ts.map +1 -0
- package/dist/core/catalog/scaffold.js +141 -0
- package/dist/core/catalog/scaffold.js.map +1 -0
- package/dist/core/catalog/validate-component.d.ts +50 -0
- package/dist/core/catalog/validate-component.d.ts.map +1 -0
- package/dist/core/catalog/validate-component.js +105 -0
- package/dist/core/catalog/validate-component.js.map +1 -0
- package/dist/core/catalog/validate.d.ts +71 -0
- package/dist/core/catalog/validate.d.ts.map +1 -0
- package/dist/core/catalog/validate.js +103 -0
- package/dist/core/catalog/validate.js.map +1 -0
- package/dist/core/context/assemble.d.ts +126 -0
- package/dist/core/context/assemble.d.ts.map +1 -0
- package/dist/core/context/assemble.js +197 -0
- package/dist/core/context/assemble.js.map +1 -0
- package/dist/core/context/cache.d.ts +60 -0
- package/dist/core/context/cache.d.ts.map +1 -0
- package/dist/core/context/cache.js +236 -0
- package/dist/core/context/cache.js.map +1 -0
- package/dist/core/context/exit-codes.d.ts +28 -0
- package/dist/core/context/exit-codes.d.ts.map +1 -0
- package/dist/core/context/exit-codes.js +28 -0
- package/dist/core/context/exit-codes.js.map +1 -0
- package/dist/core/context/fetch.d.ts +55 -0
- package/dist/core/context/fetch.d.ts.map +1 -0
- package/dist/core/context/fetch.js +112 -0
- package/dist/core/context/fetch.js.map +1 -0
- package/dist/core/context/index.d.ts +7 -1
- package/dist/core/context/index.d.ts.map +1 -1
- package/dist/core/context/index.js +7 -1
- package/dist/core/context/index.js.map +1 -1
- package/dist/core/context/init.d.ts +179 -0
- package/dist/core/context/init.d.ts.map +1 -0
- package/dist/core/context/init.js +532 -0
- package/dist/core/context/init.js.map +1 -0
- package/dist/core/context/layers/architecture-layer.d.ts +13 -0
- package/dist/core/context/layers/architecture-layer.d.ts.map +1 -0
- package/dist/core/context/layers/architecture-layer.js +24 -0
- package/dist/core/context/layers/architecture-layer.js.map +1 -0
- package/dist/core/context/layers/contracts-layer.d.ts +13 -0
- package/dist/core/context/layers/contracts-layer.d.ts.map +1 -0
- package/dist/core/context/layers/contracts-layer.js +83 -0
- package/dist/core/context/layers/contracts-layer.js.map +1 -0
- package/dist/core/context/layers/conventions-delta-layer.d.ts +13 -0
- package/dist/core/context/layers/conventions-delta-layer.d.ts.map +1 -0
- package/dist/core/context/layers/conventions-delta-layer.js +37 -0
- package/dist/core/context/layers/conventions-delta-layer.js.map +1 -0
- package/dist/core/context/layers/flow-layer.d.ts +14 -0
- package/dist/core/context/layers/flow-layer.d.ts.map +1 -0
- package/dist/core/context/layers/flow-layer.js +61 -0
- package/dist/core/context/layers/flow-layer.js.map +1 -0
- package/dist/core/context/layers/index-layer.d.ts +13 -0
- package/dist/core/context/layers/index-layer.d.ts.map +1 -0
- package/dist/core/context/layers/index-layer.js +77 -0
- package/dist/core/context/layers/index-layer.js.map +1 -0
- package/dist/core/context/layers/primary-layer.d.ts +16 -0
- package/dist/core/context/layers/primary-layer.d.ts.map +1 -0
- package/dist/core/context/layers/primary-layer.js +61 -0
- package/dist/core/context/layers/primary-layer.js.map +1 -0
- package/dist/core/context/layers/secondary-layer.d.ts +19 -0
- package/dist/core/context/layers/secondary-layer.d.ts.map +1 -0
- package/dist/core/context/layers/secondary-layer.js +52 -0
- package/dist/core/context/layers/secondary-layer.js.map +1 -0
- package/dist/core/context/session-lock.d.ts +114 -0
- package/dist/core/context/session-lock.d.ts.map +1 -0
- package/dist/core/context/session-lock.js +90 -0
- package/dist/core/context/session-lock.js.map +1 -0
- package/dist/core/context/tokens.d.ts +35 -0
- package/dist/core/context/tokens.d.ts.map +1 -0
- package/dist/core/context/tokens.js +88 -0
- package/dist/core/context/tokens.js.map +1 -0
- package/dist/core/distribution/fetch-package.d.ts +18 -0
- package/dist/core/distribution/fetch-package.d.ts.map +1 -0
- package/dist/core/distribution/fetch-package.js +42 -0
- package/dist/core/distribution/fetch-package.js.map +1 -0
- package/dist/core/distribution/index.d.ts +3 -1
- package/dist/core/distribution/index.d.ts.map +1 -1
- package/dist/core/distribution/index.js +2 -1
- package/dist/core/distribution/index.js.map +1 -1
- package/dist/core/distribution/install.d.ts +1 -1
- package/dist/core/distribution/install.d.ts.map +1 -1
- package/dist/core/distribution/install.js +10 -2
- package/dist/core/distribution/install.js.map +1 -1
- package/dist/core/distribution/pin.d.ts +5 -0
- package/dist/core/distribution/pin.d.ts.map +1 -1
- package/dist/core/distribution/pin.js +17 -1
- package/dist/core/distribution/pin.js.map +1 -1
- package/dist/core/distribution/update.d.ts +11 -1
- package/dist/core/distribution/update.d.ts.map +1 -1
- package/dist/core/distribution/update.js +45 -1
- package/dist/core/distribution/update.js.map +1 -1
- package/dist/core/exit-codes.d.ts +30 -1
- package/dist/core/exit-codes.d.ts.map +1 -1
- package/dist/core/exit-codes.js +31 -1
- package/dist/core/exit-codes.js.map +1 -1
- package/dist/core/extract/component.d.ts +11 -8
- package/dist/core/extract/component.d.ts.map +1 -1
- package/dist/core/extract/component.js.map +1 -1
- package/dist/core/extract/index.d.ts +1 -1
- package/dist/core/extract/index.d.ts.map +1 -1
- package/dist/core/extract/openapi/route1.d.ts.map +1 -1
- package/dist/core/extract/openapi/route1.js +6 -0
- package/dist/core/extract/openapi/route1.js.map +1 -1
- package/dist/core/extract/providers/node-ts.d.ts.map +1 -1
- package/dist/core/extract/providers/node-ts.js +9 -0
- package/dist/core/extract/providers/node-ts.js.map +1 -1
- package/dist/core/index.d.ts +1 -0
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +1 -0
- package/dist/core/index.js.map +1 -1
- package/dist/core/providers/index.d.ts +3 -2
- package/dist/core/providers/index.d.ts.map +1 -1
- package/dist/core/providers/index.js +1 -1
- package/dist/core/providers/index.js.map +1 -1
- package/dist/core/providers/tracker.d.ts +74 -0
- package/dist/core/providers/tracker.d.ts.map +1 -0
- package/dist/core/providers/tracker.js +38 -0
- package/dist/core/providers/tracker.js.map +1 -0
- package/dist/core/scope/calibration.d.ts +25 -0
- package/dist/core/scope/calibration.d.ts.map +1 -0
- package/dist/core/scope/calibration.js +52 -0
- package/dist/core/scope/calibration.js.map +1 -0
- package/dist/core/scope/closure.d.ts +31 -0
- package/dist/core/scope/closure.d.ts.map +1 -0
- package/dist/core/scope/closure.js +68 -0
- package/dist/core/scope/closure.js.map +1 -0
- package/dist/core/scope/gate.d.ts +41 -0
- package/dist/core/scope/gate.d.ts.map +1 -0
- package/dist/core/scope/gate.js +165 -0
- package/dist/core/scope/gate.js.map +1 -0
- package/dist/core/scope/index.d.ts +15 -2
- package/dist/core/scope/index.d.ts.map +1 -1
- package/dist/core/scope/index.js +11 -1
- package/dist/core/scope/index.js.map +1 -1
- package/dist/core/scope/partition.d.ts +36 -0
- package/dist/core/scope/partition.d.ts.map +1 -0
- package/dist/core/scope/partition.js +78 -0
- package/dist/core/scope/partition.js.map +1 -0
- package/dist/core/scope/prompt.d.ts +39 -0
- package/dist/core/scope/prompt.d.ts.map +1 -0
- package/dist/core/scope/prompt.js +123 -0
- package/dist/core/scope/prompt.js.map +1 -0
- package/dist/core/scope/scoping.d.ts +52 -0
- package/dist/core/scope/scoping.d.ts.map +1 -0
- package/dist/core/scope/scoping.js +99 -0
- package/dist/core/scope/scoping.js.map +1 -0
- package/dist/core/scope/types.d.ts +77 -0
- package/dist/core/scope/types.d.ts.map +1 -0
- package/dist/core/scope/types.js +5 -0
- package/dist/core/scope/types.js.map +1 -0
- package/dist/core/scope/validate.d.ts +47 -0
- package/dist/core/scope/validate.d.ts.map +1 -0
- package/dist/core/scope/validate.js +90 -0
- package/dist/core/scope/validate.js.map +1 -0
- package/dist/core/verify/asyncapi-diff.d.ts +34 -0
- package/dist/core/verify/asyncapi-diff.d.ts.map +1 -0
- package/dist/core/verify/asyncapi-diff.js +209 -0
- package/dist/core/verify/asyncapi-diff.js.map +1 -0
- package/dist/core/verify/contract-diff.d.ts +39 -0
- package/dist/core/verify/contract-diff.d.ts.map +1 -0
- package/dist/core/verify/contract-diff.js +63 -0
- package/dist/core/verify/contract-diff.js.map +1 -0
- package/dist/core/verify/drift.d.ts +47 -0
- package/dist/core/verify/drift.d.ts.map +1 -0
- package/dist/core/verify/drift.js +122 -0
- package/dist/core/verify/drift.js.map +1 -0
- package/dist/core/verify/impact.d.ts +22 -0
- package/dist/core/verify/impact.d.ts.map +1 -0
- package/dist/core/verify/impact.js +93 -0
- package/dist/core/verify/impact.js.map +1 -0
- package/dist/core/verify/index.d.ts +10 -0
- package/dist/core/verify/index.d.ts.map +1 -0
- package/dist/core/verify/index.js +9 -0
- package/dist/core/verify/index.js.map +1 -0
- package/dist/core/verify/openapi-diff.d.ts +29 -0
- package/dist/core/verify/openapi-diff.d.ts.map +1 -0
- package/dist/core/verify/openapi-diff.js +291 -0
- package/dist/core/verify/openapi-diff.js.map +1 -0
- package/dist/core/verify/types.d.ts +138 -0
- package/dist/core/verify/types.d.ts.map +1 -0
- package/dist/core/verify/types.js +5 -0
- package/dist/core/verify/types.js.map +1 -0
- package/package.json +11 -2
- package/schemas/component.schema.json +203 -0
- package/schemas/flow.schema.json +75 -0
- package/schemas/scope-output.schema.json +62 -0
- package/schemas/.gitkeep +0 -0
package/README.md
CHANGED
|
@@ -2,390 +2,202 @@
|
|
|
2
2
|
|
|
3
3
|
A set of agents, skills, and instructions for GitHub Copilot, Claude Code, Kiro, and other AI coding agents to run structured, PRD-driven development workflows. Inspired by [snarktank/ai-dev-tasks](https://github.com/snarktank/ai-dev-tasks).
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
### Agent workflow (skills + instructions)
|
|
5
|
+
---
|
|
8
6
|
|
|
9
|
-
|
|
10
|
-
# 1. Bootstrap the installer into your repo
|
|
11
|
-
curl -fsSL https://raw.githubusercontent.com/llipe/dev-tasks/main/dev-tasks.sh \
|
|
12
|
-
-o dev-tasks.sh && chmod +x dev-tasks.sh
|
|
13
|
-
|
|
14
|
-
# 2. Install (default: all platforms — Copilot + Claude Code + Kiro)
|
|
15
|
-
./dev-tasks.sh install
|
|
16
|
-
|
|
17
|
-
# 3. Initialize your project context (run once per project)
|
|
18
|
-
# Invoke @product-engineer in Init Mode — produces docs/product-context.md
|
|
19
|
-
# and docs/technical-guidelines.md
|
|
20
|
-
|
|
21
|
-
# 4. Build a feature
|
|
22
|
-
# a) Invoke @product-engineer with a feature description or GitHub issue number
|
|
23
|
-
# → creates PRD → spec → stories → task list
|
|
24
|
-
# b) Invoke @developer with the task list path
|
|
25
|
-
# → implements, tests, and opens a PR
|
|
26
|
-
|
|
27
|
-
# 5. Keep up to date
|
|
28
|
-
./dev-tasks.sh update # update toolkit files
|
|
29
|
-
./dev-tasks.sh update --backup # same, but backs up current files first
|
|
30
|
-
./dev-tasks.sh check # compare installed vs latest version
|
|
31
|
-
```
|
|
7
|
+
## Getting Started
|
|
32
8
|
|
|
33
|
-
###
|
|
9
|
+
### 1. Install the package
|
|
34
10
|
|
|
35
11
|
```bash
|
|
36
|
-
# 1. Install the npm package
|
|
37
12
|
pnpm add -g @llipe.com/dev-tasks
|
|
13
|
+
```
|
|
38
14
|
|
|
39
|
-
|
|
40
|
-
dt extract all --interactive
|
|
41
|
-
|
|
42
|
-
# 3. Review the generated component.json and extraction_report.json
|
|
43
|
-
cat component.json
|
|
44
|
-
cat extraction_report.json
|
|
15
|
+
This gives you two binaries:
|
|
45
16
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
17
|
+
| Binary | Purpose |
|
|
18
|
+
| ----------- | ------------------------------------------------------- |
|
|
19
|
+
| `dev-tasks` | Bootstrap: install agent files, update, status, migrate |
|
|
20
|
+
| `dt` | Runtime: extract repo metadata, build context |
|
|
49
21
|
|
|
50
|
-
|
|
22
|
+
### 2. Install agent workflow files into your repo
|
|
51
23
|
|
|
52
24
|
```bash
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
./dev-tasks.sh install --profile kiro # .kiro/ only
|
|
56
|
-
./dev-tasks.sh install --profile claude,kiro # mix and match
|
|
57
|
-
./dev-tasks.sh install --profile all # everything (default)
|
|
25
|
+
cd your-project
|
|
26
|
+
dev-tasks install
|
|
58
27
|
```
|
|
59
28
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
## The Core Idea
|
|
63
|
-
|
|
64
|
-
This system brings structure and clarity to AI-assisted development by:
|
|
65
|
-
|
|
66
|
-
- Defining scope with Product Requirements Documents (PRDs)
|
|
67
|
-
- Breaking requirements into actionable, implementation-ready tasks
|
|
68
|
-
- Guiding the AI to tackle one task at a time with checkpoints for review
|
|
69
|
-
- Providing specialized **agents** that orchestrate the workflow end-to-end
|
|
70
|
-
- Enforcing documentation, branch discipline, and GitHub-as-source-of-truth
|
|
71
|
-
|
|
72
|
-
---
|
|
29
|
+
This installs agent definitions, skills, instructions, and prompts into your project for the AI platforms you use. By default it installs for all platforms (`--profile all`).
|
|
73
30
|
|
|
74
|
-
|
|
31
|
+
**Choose your platform profile:**
|
|
75
32
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
**Key distinctions:**
|
|
83
|
-
|
|
84
|
-
- Skills save context window space — they are loaded only when invoked, unlike instructions which are always present.
|
|
85
|
-
- Agent files define _who_ (identity, phases, handoff rules). Skill files define _how_ (procedures, templates, steps).
|
|
86
|
-
- Instructions are for cross-cutting rules that must never be forgotten (e.g., implementation discipline, planning format).
|
|
33
|
+
```bash
|
|
34
|
+
dev-tasks install --profile copilot # .github/ only
|
|
35
|
+
dev-tasks install --profile claude # .claude/ only
|
|
36
|
+
dev-tasks install --profile kiro # .kiro/ only
|
|
37
|
+
dev-tasks install --profile both # copilot + claude only
|
|
38
|
+
```
|
|
87
39
|
|
|
88
|
-
|
|
40
|
+
### 3. Initialize your project context
|
|
89
41
|
|
|
90
|
-
|
|
42
|
+
Invoke the `product-engineer` agent in Init Mode (via `@product-engineer` or the `product-engineer-init` prompt). This creates:
|
|
91
43
|
|
|
92
|
-
|
|
44
|
+
- `docs/product-context.md` — what your product is and who it's for
|
|
45
|
+
- `docs/technical-guidelines.md` — stack, conventions, and constraints
|
|
93
46
|
|
|
94
|
-
|
|
95
|
-
- `git`
|
|
96
|
-
- `curl`
|
|
97
|
-
- `tar`
|
|
98
|
-
- `shasum` (or `sha256sum`)
|
|
47
|
+
Run this once per project.
|
|
99
48
|
|
|
100
|
-
###
|
|
49
|
+
### 4. Build a feature
|
|
101
50
|
|
|
102
|
-
|
|
51
|
+
```text
|
|
52
|
+
a) Invoke @product-engineer with a feature description or GitHub issue number
|
|
53
|
+
→ creates PRD → spec → stories → task list
|
|
103
54
|
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
-o dev-tasks.sh && chmod +x dev-tasks.sh
|
|
107
|
-
./dev-tasks.sh install
|
|
55
|
+
b) Invoke @developer with the task list path
|
|
56
|
+
→ implements, tests, and opens a PR
|
|
108
57
|
```
|
|
109
58
|
|
|
110
|
-
###
|
|
59
|
+
### 5. Keep files up to date
|
|
111
60
|
|
|
112
61
|
```bash
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
./dev-tasks.sh version
|
|
117
|
-
./dev-tasks.sh check
|
|
62
|
+
dev-tasks update # reconcile with hash-based conflict detection
|
|
63
|
+
dev-tasks update --force # accept all upstream changes
|
|
64
|
+
dev-tasks status # compare installed vs latest version
|
|
118
65
|
```
|
|
119
66
|
|
|
120
|
-
### Verify the installation
|
|
121
|
-
|
|
122
|
-
After install, confirm these paths exist in your target repo:
|
|
123
|
-
|
|
124
|
-
- `.github/agents/`
|
|
125
|
-
- `.github/skills/`
|
|
126
|
-
- `.github/instructions/`
|
|
127
|
-
- `.github/prompts/`
|
|
128
|
-
- `.dev-tasks-version`
|
|
129
|
-
|
|
130
|
-
The default `--profile both` installs Copilot (`.github/`) and Claude Code (`.claude/`) file sets only. If you installed with `--profile kiro` or `--profile all`, also confirm:
|
|
131
|
-
|
|
132
|
-
- `.kiro/agents/`
|
|
133
|
-
- `.kiro/skills/`
|
|
134
|
-
- `.kiro/steering/`
|
|
135
|
-
- `.kiro/hooks/`
|
|
136
|
-
|
|
137
67
|
---
|
|
138
68
|
|
|
139
|
-
##
|
|
140
|
-
|
|
141
|
-
### 1. Install with the single-script installer
|
|
142
|
-
|
|
143
|
-
Bootstrap from any repository with one command:
|
|
69
|
+
## Using `dt` for Multi-Repo Context
|
|
144
70
|
|
|
145
|
-
|
|
146
|
-
curl -fsSL https://raw.githubusercontent.com/llipe/dev-tasks/main/dev-tasks.sh \
|
|
147
|
-
-o dev-tasks.sh && chmod +x dev-tasks.sh
|
|
148
|
-
./dev-tasks.sh install
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
This downloads the latest versioned bundle from GitHub Releases, places all managed files in `.github/agents/`, `.github/skills/`, `.github/instructions/`, and `.github/prompts/`, writes `.dev-tasks-version` for traceability, and prints an **AGENTS.md integration prompt** showing what changed.
|
|
71
|
+
`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.
|
|
152
72
|
|
|
153
|
-
|
|
73
|
+
### Extract metadata from a repo
|
|
154
74
|
|
|
155
75
|
```bash
|
|
156
|
-
|
|
157
|
-
```
|
|
76
|
+
cd my-service
|
|
158
77
|
|
|
159
|
-
|
|
78
|
+
# Run the full extraction pipeline
|
|
79
|
+
dt extract all --interactive
|
|
160
80
|
|
|
161
|
-
|
|
162
|
-
|
|
81
|
+
# Or run individual extractors
|
|
82
|
+
dt extract detect # stack, framework, ORM, messaging
|
|
83
|
+
dt extract schema # database schema from ORM definitions
|
|
84
|
+
dt extract openapi # OpenAPI spec (copy existing or AST inference)
|
|
85
|
+
dt extract asyncapi # AsyncAPI spec from Kafka topic patterns
|
|
86
|
+
dt extract component # derive component.json manifest
|
|
163
87
|
```
|
|
164
88
|
|
|
165
|
-
|
|
89
|
+
### Review outputs
|
|
166
90
|
|
|
167
91
|
```bash
|
|
168
|
-
|
|
92
|
+
cat component.json # manifest with _provenance metadata
|
|
93
|
+
cat extraction_report.json # coverage, confidence, unresolved items
|
|
169
94
|
```
|
|
170
95
|
|
|
171
|
-
|
|
96
|
+
### Validate a manifest (offline, no network access)
|
|
172
97
|
|
|
173
98
|
```bash
|
|
174
|
-
|
|
99
|
+
dt validate-component component.json # exit 0 valid, exit 4 invalid
|
|
100
|
+
dt validate-component component.json --json # structured error list
|
|
175
101
|
```
|
|
176
102
|
|
|
177
|
-
|
|
103
|
+
### Typical workflow
|
|
178
104
|
|
|
179
105
|
```bash
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
After install, your repo contains (Copilot + Claude Code, the default `--profile both`):
|
|
186
|
-
|
|
187
|
-
```text
|
|
188
|
-
your-repo/
|
|
189
|
-
├── dev-tasks.sh # Keep this — used for future updates
|
|
190
|
-
├── .dev-tasks-version # Installed version metadata (JSON)
|
|
191
|
-
├── .github/
|
|
192
|
-
│ ├── instructions/ # Always-loaded rules
|
|
193
|
-
│ │ ├── plan.instructions.md
|
|
194
|
-
│ │ ├── implement.instructions.md
|
|
195
|
-
│ │ └── domain/
|
|
196
|
-
│ │ └── nextjs-pages-components.instructions.md
|
|
197
|
-
│ ├── agents/ # Agent definitions (8 agents)
|
|
198
|
-
│ ├── skills/ # On-demand capabilities (13 skills)
|
|
199
|
-
│ └── prompts/ # Ready-to-use prompt templates
|
|
200
|
-
├── docs/ # Foundation docs (generated by init)
|
|
201
|
-
├── workstream/ # Active feature work
|
|
202
|
-
└── AGENTS.md # Master registry (you own this — see integration prompt)
|
|
203
|
-
```
|
|
204
|
-
|
|
205
|
-
With `--profile kiro` or `--profile all`, your repo additionally (or instead, for `kiro`) contains:
|
|
206
|
-
|
|
207
|
-
```text
|
|
208
|
-
your-repo/
|
|
209
|
-
└── .kiro/
|
|
210
|
-
├── steering/ # Kiro's "instructions" equivalent (4 files)
|
|
211
|
-
│ ├── plan.md # inclusion: always
|
|
212
|
-
│ ├── implement.md # inclusion: always
|
|
213
|
-
│ ├── nextjs-pages-components.md # inclusion: fileMatch, fileMatchPattern: "**/*.tsx"
|
|
214
|
-
│ └── git-guard-notice.md # inclusion: always — Kiro-specific hook-limitation disclosure
|
|
215
|
-
├── agents/ # Agent definitions (8 agents; prompts folded in as "Invocation Modes")
|
|
216
|
-
├── skills/ # On-demand capabilities (13 skills, one dir each with SKILL.md)
|
|
217
|
-
└── hooks/
|
|
218
|
-
├── git-guard.json # PreToolUse hook definition
|
|
219
|
-
└── scripts/git-guard.sh
|
|
106
|
+
dt extract all --interactive
|
|
107
|
+
dt validate-component component.json
|
|
108
|
+
git add component.json contracts/ docs/schema.md extraction_report.json
|
|
109
|
+
git commit -m "feat: add component manifest via dt extract"
|
|
220
110
|
```
|
|
221
111
|
|
|
222
|
-
###
|
|
112
|
+
### Artifact formats
|
|
223
113
|
|
|
224
|
-
|
|
114
|
+
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.
|
|
225
115
|
|
|
226
|
-
|
|
116
|
+
### CLI documentation
|
|
227
117
|
|
|
228
|
-
|
|
118
|
+
- **`dev-tasks` (bootstrap/distribution):** [`docs/dev-tasks-user-manual.md`](docs/dev-tasks-user-manual.md) — install, update, pin/unpin, profiles, manifest merging, reconciliation
|
|
119
|
+
- **`dt` (extraction/catalog/context):** [`docs/dt-user-manual.md`](docs/dt-user-manual.md) — extract, catalog, context, scope
|
|
229
120
|
|
|
230
|
-
###
|
|
231
|
-
|
|
232
|
-
| Situation | How to start |
|
|
233
|
-
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
|
|
234
|
-
| **New feature / epic** | Invoke `product-engineer` with a feature description, then `developer` to implement |
|
|
235
|
-
| **Single GitHub Issue** | Invoke `product-engineer` with an issue number, then `developer` to implement |
|
|
236
|
-
| **Already have a task list** | Invoke `developer` with a task list path |
|
|
237
|
-
| **Multi-story PRD batch** | Invoke `planner` with a `/workstream` task file or milestone |
|
|
238
|
-
| **UX prototype** | Invoke `ux-engineer` with a PRD or SPEC path |
|
|
239
|
-
| **Docs out of date** | Invoke `technical-writer` |
|
|
240
|
-
| **Lint/type/test cleanup** | Invoke `housekeeping` |
|
|
241
|
-
| **Verifier compliance testing** | Invoke `verifier` with a spec or story to generate test plans (Design Mode) and audit delivered fidelity (Audit Mode) |
|
|
121
|
+
### Global options
|
|
242
122
|
|
|
243
|
-
|
|
123
|
+
| Flag | Description |
|
|
124
|
+
| -------------------- | ---------------------------- |
|
|
125
|
+
| `--json` | Machine-readable JSON output |
|
|
126
|
+
| `--meta-repo <path>` | Path or URL to the meta-repo |
|
|
127
|
+
| `-v` | Verbose diagnostics (stderr) |
|
|
244
128
|
|
|
245
|
-
|
|
129
|
+
### Exit codes
|
|
246
130
|
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
131
|
+
| Code | Meaning |
|
|
132
|
+
| ---- | ------------------------------------------------- |
|
|
133
|
+
| 0 | OK |
|
|
134
|
+
| 1 | Unexpected error |
|
|
135
|
+
| 2 | Incorrect usage |
|
|
136
|
+
| 13 | Incomplete extraction: required fields unresolved |
|
|
137
|
+
| 14 | Reconciliation conflict (edited fields) |
|
|
253
138
|
|
|
254
139
|
---
|
|
255
140
|
|
|
256
|
-
##
|
|
141
|
+
## `dev-tasks` Command Reference
|
|
257
142
|
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
DEV[developer]
|
|
267
|
-
PL[planner]
|
|
268
|
-
UX[ux-engineer]
|
|
269
|
-
VD[verifier\nDesign Mode]
|
|
270
|
-
VA[verifier\nAudit Mode]
|
|
271
|
-
GO[github-ops]
|
|
272
|
-
TW[technical-writer]
|
|
273
|
-
HK[housekeeping]
|
|
274
|
-
|
|
275
|
-
%% Skills (grouped)
|
|
276
|
-
subgraph "product-engineer skills"
|
|
277
|
-
S_INIT[activity-init]
|
|
278
|
-
S_REFINE[activity-refine]
|
|
279
|
-
S_SPEC[activity-generate-spec]
|
|
280
|
-
S_STORIES[activity-generate-stories]
|
|
281
|
-
S_PUBLISH[activity-publish-github]
|
|
282
|
-
S_DRIFT[activity-drift-reconciliation]
|
|
283
|
-
end
|
|
284
|
-
|
|
285
|
-
subgraph "verifier skills"
|
|
286
|
-
S_E2E[activity-e2e-test-design]
|
|
287
|
-
S_CONTRACT[activity-contract-test-design]
|
|
288
|
-
S_EDGE[activity-edge-case-refinement]
|
|
289
|
-
S_RANDOM[activity-random-test-tactics]
|
|
290
|
-
end
|
|
291
|
-
|
|
292
|
-
subgraph "shared skills"
|
|
293
|
-
S_GITOPS[git-ops]
|
|
294
|
-
S_MEMO[memo-cli-usage]
|
|
295
|
-
S_MOCKUP[webapp-mockup]
|
|
296
|
-
end
|
|
297
|
-
|
|
298
|
-
%% Main workflow: product-engineer → developer
|
|
299
|
-
PE -->|"PRD → spec → stories → plan"| DEV
|
|
300
|
-
PE -->|"multi-story plan"| PL
|
|
301
|
-
PL -->|"delegates per story"| DEV
|
|
302
|
-
|
|
303
|
-
%% UX loop
|
|
304
|
-
PE -->|"spec"| UX
|
|
305
|
-
UX -->|"gap analysis & refinements"| PE
|
|
306
|
-
|
|
307
|
-
%% Verifier design mode (test-first)
|
|
308
|
-
PE -->|"spec/stories"| VD
|
|
309
|
-
VD -->|"test plan"| DEV
|
|
310
|
-
|
|
311
|
-
%% Mandatory audit before PR
|
|
312
|
-
DEV -->|"PR ready"| VA
|
|
313
|
-
VA -->|"fidelity report"| DEV
|
|
314
|
-
|
|
315
|
-
%% Drift reconciliation
|
|
316
|
-
VA -.->|"drift findings\n(non-blocking)"| PE
|
|
317
|
-
|
|
318
|
-
%% Skill usage
|
|
319
|
-
PE --- S_INIT & S_REFINE & S_SPEC & S_STORIES & S_PUBLISH & S_DRIFT
|
|
320
|
-
VD --- S_E2E & S_CONTRACT & S_EDGE & S_RANDOM
|
|
321
|
-
DEV --- S_GITOPS & S_MEMO
|
|
322
|
-
PL --- S_GITOPS
|
|
323
|
-
UX --- S_MOCKUP
|
|
324
|
-
TW --- S_MEMO
|
|
325
|
-
PE --- S_MEMO
|
|
326
|
-
|
|
327
|
-
%% GitHub-ops supports all agents
|
|
328
|
-
GO -.->|"issues, PRs, labels"| PE
|
|
329
|
-
GO -.->|"issues, PRs, labels"| DEV
|
|
330
|
-
GO -.->|"issues, PRs, labels"| PL
|
|
143
|
+
```bash
|
|
144
|
+
dev-tasks install [--pin <version>] # Install skill files + write manifest
|
|
145
|
+
dev-tasks update [--force] # Reconcile with hash-based conflict detection
|
|
146
|
+
dev-tasks status # Compare installed/pinned/latest versions
|
|
147
|
+
dev-tasks pin <version> # Pin to a specific version
|
|
148
|
+
dev-tasks unpin # Remove the version pin
|
|
149
|
+
dev-tasks doctor # Check Node ≥20, git ≥2.37, cache writable
|
|
150
|
+
dev-tasks migrate # Migrate from legacy shell-script install
|
|
331
151
|
```
|
|
332
152
|
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
- Solid arrows → direct handoffs between agents
|
|
336
|
-
- Dashed arrows → supporting/non-blocking interactions
|
|
337
|
-
- Boxes at the bottom → skills invoked by each agent
|
|
338
|
-
- The `verifier` audit before every PR is mandatory and non-skippable
|
|
153
|
+
### Version Pinning
|
|
339
154
|
|
|
340
|
-
|
|
155
|
+
Pin locks your project to a specific version. When pinned, `update` fetches the pinned version from the npm registry and reconciles against it — even if your locally installed package is newer:
|
|
341
156
|
|
|
342
|
-
```
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
157
|
+
```bash
|
|
158
|
+
dev-tasks pin 0.5.0 # Lock to 0.5.0
|
|
159
|
+
dev-tasks update # Fetches 0.5.0 from registry and reconciles against it
|
|
160
|
+
dev-tasks unpin # Remove the pin (update will use the local package version)
|
|
346
161
|
```
|
|
347
162
|
|
|
348
|
-
###
|
|
163
|
+
### Options (install / update)
|
|
349
164
|
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
165
|
+
| Option | Description |
|
|
166
|
+
| ------------------ | ---------------------------------------------------- |
|
|
167
|
+
| `--profile <name>` | `copilot` \| `claude` \| `kiro` \| `both` \| `all` |
|
|
168
|
+
| `--dry-run` | Print planned changes without writing any files |
|
|
169
|
+
| `--backup` | Backup managed files before replacing |
|
|
170
|
+
| `--yes` | Skip confirmation prompts (useful in CI) |
|
|
171
|
+
| `--pin <version>` | Pin to a specific release version |
|
|
172
|
+
| `--force` | Accept all upstream changes without conflict prompts |
|
|
355
173
|
|
|
356
|
-
|
|
174
|
+
---
|
|
357
175
|
|
|
358
|
-
|
|
359
|
-
product-engineer: ... → plan
|
|
360
|
-
↓
|
|
361
|
-
planner: orchestrate → developer: implement (per story, sequential)
|
|
362
|
-
```
|
|
176
|
+
## The Core Idea
|
|
363
177
|
|
|
364
|
-
|
|
178
|
+
This system brings structure and clarity to AI-assisted development by:
|
|
365
179
|
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
180
|
+
- Defining scope with Product Requirements Documents (PRDs)
|
|
181
|
+
- Breaking requirements into actionable, implementation-ready tasks
|
|
182
|
+
- Guiding the AI to tackle one task at a time with checkpoints for review
|
|
183
|
+
- Providing specialized **agents** that orchestrate the workflow end-to-end
|
|
184
|
+
- Enforcing documentation, branch discipline, and GitHub-as-source-of-truth
|
|
369
185
|
|
|
370
|
-
|
|
186
|
+
---
|
|
371
187
|
|
|
372
|
-
|
|
373
|
-
product-engineer: refine → generate-spec → ux-engineer: mockups → product-engineer: update
|
|
374
|
-
```
|
|
188
|
+
## Taxonomy: Agent vs Skill vs Instruction
|
|
375
189
|
|
|
376
|
-
|
|
190
|
+
| Concept | Purpose | Loaded When |
|
|
191
|
+
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- |
|
|
192
|
+
| **Agent** | Autonomous role with decision-making, phases, and handoff discipline. Owns a workflow end-to-end. | Invoked by name (`@agent`) |
|
|
193
|
+
| **Skill** | Reusable on-demand capability. Describes _procedures_ or _activities_ that any agent can invoke when needed. Not loaded unless referenced. | On demand (invoked by agent or prompt) |
|
|
194
|
+
| **Instruction** | Always-loaded rule scoped via `applyTo` frontmatter. Enforced automatically for every matching context. | Always (auto-applied by runtime) |
|
|
377
195
|
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
developer/planner: implement (feature + tests from test plan)
|
|
384
|
-
↓ (automatic, mandatory, non-skippable)
|
|
385
|
-
verifier (audit mode): grey-box fidelity audit → fidelity report
|
|
386
|
-
↓ (drift findings, non-blocking)
|
|
387
|
-
product-engineer: activity-drift-reconciliation
|
|
388
|
-
```
|
|
196
|
+
**Key distinctions:**
|
|
197
|
+
|
|
198
|
+
- Skills save context window space — they are loaded only when invoked, unlike instructions which are always present.
|
|
199
|
+
- Agent files define _who_ (identity, phases, handoff rules). Skill files define _how_ (procedures, templates, steps).
|
|
200
|
+
- Instructions are for cross-cutting rules that must never be forgotten (e.g., implementation discipline, planning format).
|
|
389
201
|
|
|
390
202
|
---
|
|
391
203
|
|
|
@@ -393,7 +205,7 @@ developer/planner: implement (feature + tests from test plan)
|
|
|
393
205
|
|
|
394
206
|
Agents are autonomous personas that orchestrate skills and activities.
|
|
395
207
|
|
|
396
|
-
> **Available for:** Copilot (`.github/agents/`), Claude Code (`.claude/agents/`), Kiro (`.kiro/agents/`). All three platforms define the same 8 agents below.
|
|
208
|
+
> **Available for:** Copilot (`.github/agents/`), Claude Code (`.claude/agents/`), Kiro (`.kiro/agents/`). All three platforms define the same 8 agents below.
|
|
397
209
|
|
|
398
210
|
### `product-engineer`
|
|
399
211
|
|
|
@@ -403,37 +215,35 @@ Preparation agent — owns the full pre-coding chain:
|
|
|
403
215
|
- **Feature Mode**: `activity-refine` → `activity-generate-spec` → `activity-generate-stories` → `activity-publish-github` → `plan`
|
|
404
216
|
- **Issue Mode**: `activity-refine` → `plan`
|
|
405
217
|
|
|
406
|
-
Also owns drift reconciliation
|
|
407
|
-
|
|
408
|
-
Hands off to `developer` or `planner` for execution.
|
|
218
|
+
Also owns drift reconciliation via `activity-drift-reconciliation`.
|
|
409
219
|
|
|
410
220
|
### `developer`
|
|
411
221
|
|
|
412
|
-
Execution agent — implements code from an existing task list. Runs `implement`,
|
|
222
|
+
Execution agent — implements code from an existing task list. Runs `implement`, including a mandatory `verifier` audit before every PR is marked ready. Uses `git-ops` for branch management.
|
|
413
223
|
|
|
414
224
|
### `planner`
|
|
415
225
|
|
|
416
226
|
Multi-story orchestration with checkpoint/resume:
|
|
417
227
|
|
|
418
|
-
| Phase | What Happens
|
|
419
|
-
| ----- |
|
|
420
|
-
| 0 | Discover task source
|
|
421
|
-
| 0.5 | Resume detection
|
|
422
|
-
| 1 | Parse stories and infer dependencies
|
|
423
|
-
| 2 | Dependency graph —
|
|
424
|
-
| 3 | Pre-flight — creates integration branch
|
|
425
|
-
| 4 | Delegate to `developer` per story
|
|
426
|
-
| 5 | PRD-level rollup `verifier` audit, then consolidated PR to `main`
|
|
228
|
+
| Phase | What Happens |
|
|
229
|
+
| ----- | ----------------------------------------------------------------- |
|
|
230
|
+
| 0 | Discover task source |
|
|
231
|
+
| 0.5 | Resume detection |
|
|
232
|
+
| 1 | Parse stories and infer dependencies |
|
|
233
|
+
| 2 | Dependency graph — user approval required |
|
|
234
|
+
| 3 | Pre-flight — creates integration branch |
|
|
235
|
+
| 4 | Delegate to `developer` per story; merge and write checkpoint |
|
|
236
|
+
| 5 | PRD-level rollup `verifier` audit, then consolidated PR to `main` |
|
|
427
237
|
|
|
428
238
|
### Other Agents
|
|
429
239
|
|
|
430
|
-
| Agent | Purpose
|
|
431
|
-
| ------------------ |
|
|
432
|
-
| `ux-engineer` | PRD/SPEC-to-mockup
|
|
433
|
-
| `technical-writer` | Documentation maintenance
|
|
434
|
-
| `housekeeping` | Lint, type, and test-wiring fixes
|
|
435
|
-
| `github-ops` | GitHub consistency — issues, PRs, branches, labels
|
|
436
|
-
| `verifier` |
|
|
240
|
+
| Agent | Purpose |
|
|
241
|
+
| ------------------ | -------------------------------------------------- |
|
|
242
|
+
| `ux-engineer` | PRD/SPEC-to-mockup prototyping |
|
|
243
|
+
| `technical-writer` | Documentation maintenance |
|
|
244
|
+
| `housekeeping` | Lint, type, and test-wiring fixes |
|
|
245
|
+
| `github-ops` | GitHub consistency — issues, PRs, branches, labels |
|
|
246
|
+
| `verifier` | Compliance test-plan design and fidelity auditing |
|
|
437
247
|
|
|
438
248
|
---
|
|
439
249
|
|
|
@@ -441,30 +251,26 @@ Multi-story orchestration with checkpoint/resume:
|
|
|
441
251
|
|
|
442
252
|
On-demand capabilities loaded only when invoked.
|
|
443
253
|
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
|
447
|
-
|
|
|
448
|
-
| `activity-
|
|
449
|
-
| `activity-
|
|
450
|
-
| `activity-
|
|
451
|
-
| `activity-
|
|
452
|
-
| `
|
|
453
|
-
| `
|
|
454
|
-
| `
|
|
455
|
-
| `
|
|
456
|
-
| `activity-
|
|
457
|
-
| `activity-
|
|
458
|
-
| `
|
|
459
|
-
| `activity-random-test-tactics` | Randomized, fuzz, and property-inspired test generation | `verifier` |
|
|
460
|
-
| `memo-cli-usage` | Shared architectural memory with `memo-cli` (read session context, write intent/outcome and ADR/decision rationale) | `product-engineer`, `developer`, `technical-writer` |
|
|
254
|
+
| Skill | Purpose | Consumer |
|
|
255
|
+
| ------------------------------- | ----------------------------------------------- | --------------------------------------------------- |
|
|
256
|
+
| `activity-init` | Product context and technical guidelines | `product-engineer` |
|
|
257
|
+
| `activity-refine` | Issue refinement or PRD creation | `product-engineer` |
|
|
258
|
+
| `activity-generate-spec` | PRD → technical specification | `product-engineer` |
|
|
259
|
+
| `activity-generate-stories` | Spec → user stories with coverage validation | `product-engineer` |
|
|
260
|
+
| `activity-publish-github` | Stories → GitHub Issues | `product-engineer` |
|
|
261
|
+
| `activity-drift-reconciliation` | Routes verifier drift findings into remediation | `product-engineer` |
|
|
262
|
+
| `git-ops` | Branch, rebase, merge, conflict resolution | `developer`, `planner` |
|
|
263
|
+
| `webapp-mockup` | React mockup scaffold for UX testing | `ux-engineer` |
|
|
264
|
+
| `activity-e2e-test-design` | E2E black-box test scenario generation | `verifier` |
|
|
265
|
+
| `activity-contract-test-design` | Consumer/provider contract testing | `verifier` |
|
|
266
|
+
| `activity-edge-case-refinement` | Systematic edge-case discovery | `verifier` |
|
|
267
|
+
| `activity-random-test-tactics` | Randomized, fuzz, and property-inspired tests | `verifier` |
|
|
268
|
+
| `memo-cli-usage` | Shared architectural memory across sessions | `product-engineer`, `developer`, `technical-writer` |
|
|
461
269
|
|
|
462
270
|
---
|
|
463
271
|
|
|
464
272
|
## Instructions (Always-Loaded)
|
|
465
273
|
|
|
466
|
-
> **Available for:** Copilot (`.github/instructions/*.instructions.md`, scoped via `applyTo`), Claude Code (`plan` and `implement` are on-demand skills instead of always-loaded instructions — see `CLAUDE.md`), Kiro (`.kiro/steering/*.md`, called "steering" and scoped via `inclusion: always|fileMatch` + `fileMatchPattern`, the Kiro analogue of `applyTo`). Kiro's steering set has a 4th file, `git-guard-notice.md` (`inclusion: always`), with no equivalent on Copilot or Claude Code — it discloses a Kiro-specific hook enforcement gap.
|
|
467
|
-
|
|
468
274
|
| Instruction | Scope | Purpose |
|
|
469
275
|
| ------------------------------------------------ | ---------- | -------------------------------------- |
|
|
470
276
|
| `plan.instructions.md` | `**` | Convert stories/issues into task lists |
|
|
@@ -475,361 +281,211 @@ On-demand capabilities loaded only when invoked.
|
|
|
475
281
|
|
|
476
282
|
## Prompts
|
|
477
283
|
|
|
478
|
-
>
|
|
479
|
-
|
|
480
|
-
| Prompt | Agent | Purpose
|
|
481
|
-
| -------------------------- | ---------------- |
|
|
482
|
-
| `product-engineer-init` | product-engineer | Initialize foundation documents
|
|
483
|
-
| `product-engineer-feature` | product-engineer | Design and plan a feature
|
|
484
|
-
| `product-engineer-issue` | product-engineer | Refine and plan a GitHub Issue
|
|
485
|
-
| `developer-execute` | developer | Execute an existing task list
|
|
486
|
-
| `planner` | planner | Orchestrate multi-story execution
|
|
487
|
-
| `planner-resume` | planner | Resume from checkpoint
|
|
488
|
-
| `ux-engineer` | ux-engineer | Generate UX mockups
|
|
489
|
-
| `github-ops` | github-ops | GitHub consistency
|
|
490
|
-
| `technical-writer` | technical-writer | Documentation maintenance
|
|
491
|
-
| `housekeeping` | housekeeping | Lint, type, test fixes
|
|
492
|
-
| `verifier-design` | verifier | Generate compliance test plan
|
|
493
|
-
| `verifier-audit` | verifier | Grey-box fidelity audit
|
|
284
|
+
> Copilot: `.github/prompts/*.prompt.md`. Claude Code: `.claude/commands/*.md`. Kiro: embedded in `.kiro/agents/*.md`.
|
|
285
|
+
|
|
286
|
+
| Prompt | Agent | Purpose |
|
|
287
|
+
| -------------------------- | ---------------- | --------------------------------- |
|
|
288
|
+
| `product-engineer-init` | product-engineer | Initialize foundation documents |
|
|
289
|
+
| `product-engineer-feature` | product-engineer | Design and plan a feature |
|
|
290
|
+
| `product-engineer-issue` | product-engineer | Refine and plan a GitHub Issue |
|
|
291
|
+
| `developer-execute` | developer | Execute an existing task list |
|
|
292
|
+
| `planner` | planner | Orchestrate multi-story execution |
|
|
293
|
+
| `planner-resume` | planner | Resume from checkpoint |
|
|
294
|
+
| `ux-engineer` | ux-engineer | Generate UX mockups |
|
|
295
|
+
| `github-ops` | github-ops | GitHub consistency |
|
|
296
|
+
| `technical-writer` | technical-writer | Documentation maintenance |
|
|
297
|
+
| `housekeeping` | housekeeping | Lint, type, test fixes |
|
|
298
|
+
| `verifier-design` | verifier | Generate compliance test plan |
|
|
299
|
+
| `verifier-audit` | verifier | Grey-box fidelity audit |
|
|
494
300
|
|
|
495
301
|
---
|
|
496
302
|
|
|
497
|
-
##
|
|
498
|
-
|
|
499
|
-
| Directory | Contents |
|
|
500
|
-
| ------------------------------ | ------------------------------------------------------------------------------------------------- |
|
|
501
|
-
| `/docs/` | Foundation documents — product-context, technical-guidelines, ADRs |
|
|
502
|
-
| `/docs/requirements/` | PRDs produced by the refine skill |
|
|
503
|
-
| `/workstream/` | Active feature work — specs, stories, task lists, planner state files |
|
|
504
|
-
| `bin/` | CLI entrypoints (`dev-tasks.ts`, `dt.ts`) |
|
|
505
|
-
| `core/` | Business logic library (extract, distribution, reconcile) — no CLI deps |
|
|
506
|
-
| `adapters/cli/` | CLI adapter — wraps core, formats stdout/JSON |
|
|
507
|
-
| `schemas/` | JSON Schemas for validation (`component.schema.json`) |
|
|
508
|
-
| `test/` | Unit and integration tests + fixture repos |
|
|
509
|
-
| `.github/instructions/` | Always-loaded instruction files |
|
|
510
|
-
| `.github/instructions/domain/` | Project-specific coding standards (auto-applied) |
|
|
511
|
-
| `.github/agents/` | Agent definition files |
|
|
512
|
-
| `.github/skills/` | On-demand skill definitions |
|
|
513
|
-
| `.github/prompts/` | Agent invocation prompts |
|
|
514
|
-
| `.kiro/steering/` | Always-loaded/file-matched steering docs (Kiro's instructions equivalent; `--profile kiro`/`all`) |
|
|
515
|
-
| `.kiro/agents/` | Agent definition files, with invocation modes folded in (`--profile kiro`/`all`) |
|
|
516
|
-
| `.kiro/skills/` | On-demand skill definitions (`--profile kiro`/`all`) |
|
|
517
|
-
| `.kiro/hooks/` | Guard hook definition + script (`--profile kiro`/`all`) |
|
|
518
|
-
|
|
519
|
-
---
|
|
520
|
-
|
|
521
|
-
## Tips
|
|
522
|
-
|
|
523
|
-
- Use `step-gated` mode (default) to review each sub-task
|
|
524
|
-
- Use `pre-approved autonomous batch` mode when you trust the agent to run autonomously
|
|
525
|
-
- Use `planner-resume` when a multi-story orchestration is interrupted
|
|
526
|
-
- Run `housekeeping` after major feature branches to catch regressions
|
|
527
|
-
- Domain instructions are auto-applied based on `applyTo` patterns
|
|
303
|
+
## Workflow Chains
|
|
528
304
|
|
|
529
|
-
|
|
305
|
+
Match your situation to a chain below, then invoke the first agent in the chain.
|
|
530
306
|
|
|
531
|
-
|
|
307
|
+
### Full Feature (PRD-Driven)
|
|
532
308
|
|
|
533
|
-
|
|
534
|
-
-
|
|
535
|
-
|
|
309
|
+
```
|
|
310
|
+
product-engineer: refine → generate-spec → generate-stories → publish-github → plan
|
|
311
|
+
↓
|
|
312
|
+
developer: implement
|
|
313
|
+
```
|
|
536
314
|
|
|
537
|
-
|
|
315
|
+
### Single GitHub Issue
|
|
538
316
|
|
|
539
|
-
```
|
|
540
|
-
|
|
317
|
+
```
|
|
318
|
+
product-engineer: refine → plan
|
|
319
|
+
↓
|
|
320
|
+
developer: implement
|
|
541
321
|
```
|
|
542
322
|
|
|
543
|
-
|
|
323
|
+
### Multi-Story Orchestration
|
|
544
324
|
|
|
545
|
-
```
|
|
546
|
-
|
|
325
|
+
```
|
|
326
|
+
product-engineer: ... → plan
|
|
327
|
+
↓
|
|
328
|
+
planner: orchestrate → developer: implement (per story, sequential)
|
|
547
329
|
```
|
|
548
330
|
|
|
549
|
-
|
|
331
|
+
### Quick Fix
|
|
550
332
|
|
|
551
|
-
|
|
333
|
+
```
|
|
334
|
+
developer: implement
|
|
335
|
+
```
|
|
552
336
|
|
|
553
|
-
|
|
337
|
+
### Test-First Design (Verifier)
|
|
554
338
|
|
|
555
|
-
```bash
|
|
556
|
-
./scripts/format.sh --check
|
|
557
|
-
./scripts/format.sh --write
|
|
558
339
|
```
|
|
559
|
-
|
|
560
|
-
|
|
340
|
+
product-engineer: spec → stories → plan
|
|
341
|
+
↓
|
|
342
|
+
verifier (design mode): generate test plan
|
|
343
|
+
↓
|
|
344
|
+
developer: implement (tests first, then code)
|
|
345
|
+
↓ (mandatory)
|
|
346
|
+
verifier (audit mode): fidelity audit → report
|
|
347
|
+
↓ (drift findings, non-blocking)
|
|
348
|
+
product-engineer: drift-reconciliation
|
|
349
|
+
```
|
|
561
350
|
|
|
562
351
|
---
|
|
563
352
|
|
|
564
|
-
##
|
|
565
|
-
|
|
566
|
-
The toolkit is distributed as a versioned tarball via **GitHub Releases**. `dev-tasks.sh` is the single installer/updater — no runtime beyond standard POSIX tools (`curl`, `tar`, `shasum`) is required.
|
|
567
|
-
|
|
568
|
-
### Commands
|
|
569
|
-
|
|
570
|
-
| Command | Description |
|
|
571
|
-
| ---------------------------------- | -------------------------------------------------------- |
|
|
572
|
-
| `./dev-tasks.sh install [version]` | Install latest or a pinned version |
|
|
573
|
-
| `./dev-tasks.sh update [version]` | Update managed files to the latest or a specific version |
|
|
574
|
-
| `./dev-tasks.sh check` | Compare installed version vs latest release |
|
|
575
|
-
| `./dev-tasks.sh list` | List installed directories, files, and metadata |
|
|
576
|
-
| `./dev-tasks.sh version` | Print installed version and script version |
|
|
577
|
-
|
|
578
|
-
### Options (install / update)
|
|
579
|
-
|
|
580
|
-
| Option | Description |
|
|
581
|
-
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
|
|
582
|
-
| `--profile <name>` | Install/update file sets: `copilot` \| `claude` \| `kiro` \| `both` \| `all` (default: `both`, meaning Copilot + Claude only) |
|
|
583
|
-
| `--dry-run` | Print planned changes without writing any files |
|
|
584
|
-
| `--backup` | Copy managed files to `.dev-tasks-backup/<timestamp>/` before replacing |
|
|
585
|
-
| `--yes` | Skip confirmation prompts (useful in CI) |
|
|
586
|
-
|
|
587
|
-
> **Kiro guard hook — enforcement gap disclosure:** `--profile kiro`/`all` installs `.kiro/hooks/git-guard.json` + `.kiro/hooks/scripts/git-guard.sh`, a best-effort port of `.claude/hooks/git-guard.sh` that blocks pushes/merges to `main`, non-Conventional-Commit messages, and inline `--body` on `gh issue`/`pr create|edit|comment|review` (must use `--body-file`, which prevents markdown-flattening in PR/issue bodies). **This hook is not guaranteed to be equivalent to `.claude/hooks/git-guard.sh`.** A tracked upstream Kiro defect (kirodotdev/Kiro#7375) may prevent Kiro IDE's `PreToolUse` hook from seeing command text, in which case it cannot reliably block anything; when it can't see command context it fails loud (stderr warning) rather than silently allowing. Until this is verified fixed on a live Kiro install, treat PR review as the actual enforcement backstop for these rules on Kiro. See `.kiro/steering/git-guard-notice.md` for the full disclosure.
|
|
588
|
-
|
|
589
|
-
### Managed file surface
|
|
590
|
-
|
|
591
|
-
The script owns these paths and may overwrite them on update:
|
|
592
|
-
|
|
593
|
-
| Path | Contents |
|
|
594
|
-
| ------------------------------------------------- | -------------------------------------------------------------------------------- |
|
|
595
|
-
| `.github/agents/*.agent.md` | Agent definitions |
|
|
596
|
-
| `.github/skills/*/SKILL.md` | Activity and operational skills |
|
|
597
|
-
| `.github/instructions/*.instructions.md` | Always-loaded instructions |
|
|
598
|
-
| `.github/instructions/domain/` | Domain-specific instructions |
|
|
599
|
-
| `.github/prompts/*.prompt.md` | Prompt entry points |
|
|
600
|
-
| `.kiro/agents/*.md` | Agent definitions (installed with `--profile kiro`/`all`) |
|
|
601
|
-
| `.kiro/skills/*/SKILL.md` | Activity and operational skills (installed with `--profile kiro`/`all`) |
|
|
602
|
-
| `.kiro/steering/*.md` | Always-loaded/file-matched steering docs (installed with `--profile kiro`/`all`) |
|
|
603
|
-
| `.kiro/hooks/*.json` + `.kiro/hooks/scripts/*.sh` | Guard hook definition and script (installed with `--profile kiro`/`all`) |
|
|
604
|
-
| `.dev-tasks-version` | Installed version metadata |
|
|
353
|
+
## File Organization
|
|
605
354
|
|
|
606
|
-
|
|
355
|
+
| Directory | Contents |
|
|
356
|
+
| --------------------- | ------------------------------------------------------- |
|
|
357
|
+
| `/docs/` | Foundation docs — product-context, technical-guidelines |
|
|
358
|
+
| `/docs/requirements/` | PRDs produced by the refine skill |
|
|
359
|
+
| `/workstream/` | Active feature work — specs, stories, task lists |
|
|
360
|
+
| `bin/` | CLI entrypoints (`dev-tasks.ts`, `dt.ts`) |
|
|
361
|
+
| `core/` | Business logic library (extract, distribution) |
|
|
362
|
+
| `adapters/cli/` | CLI adapter — wraps core, formats stdout/JSON |
|
|
363
|
+
| `schemas/` | JSON Schemas for validation |
|
|
364
|
+
| `test/` | Unit and integration tests + fixtures |
|
|
365
|
+
| `.github/` | Copilot agents, skills, instructions, prompts |
|
|
366
|
+
| `.kiro/` | Kiro agents, skills, steering, hooks |
|
|
607
367
|
|
|
608
|
-
|
|
368
|
+
---
|
|
609
369
|
|
|
610
|
-
|
|
370
|
+
## memo-cli Integration (Optional)
|
|
611
371
|
|
|
612
|
-
|
|
372
|
+
When `memo-cli` is installed and configured, agents share context across sessions and repositories.
|
|
613
373
|
|
|
614
374
|
```bash
|
|
615
|
-
|
|
616
|
-
./dev-tasks.sh install v0.1.3
|
|
617
|
-
|
|
618
|
-
# Update with backup so you can roll back manually
|
|
619
|
-
./dev-tasks.sh update --backup
|
|
620
|
-
|
|
621
|
-
# Roll back: restore from backup
|
|
622
|
-
cp -r .dev-tasks-backup/<timestamp>/. ./
|
|
375
|
+
which memo && memo setup validate
|
|
623
376
|
```
|
|
624
377
|
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
`.dev-tasks-version` is written after every install/update:
|
|
378
|
+
If `memo` is installed but validation fails:
|
|
628
379
|
|
|
629
|
-
```
|
|
630
|
-
|
|
631
|
-
"version": "1.2.0",
|
|
632
|
-
"installed_at": "2026-04-20T12:00:00Z",
|
|
633
|
-
"script_version": "1.0.0",
|
|
634
|
-
"source": "https://github.com/llipe/dev-tasks"
|
|
635
|
-
}
|
|
380
|
+
```bash
|
|
381
|
+
memo setup init --repo <repo-name> --org <org-name> --domain <domain>
|
|
636
382
|
```
|
|
637
383
|
|
|
638
|
-
|
|
384
|
+
---
|
|
639
385
|
|
|
640
|
-
|
|
386
|
+
## Known Limitations
|
|
641
387
|
|
|
642
|
-
-
|
|
643
|
-
-
|
|
388
|
+
- **Route 2 (isolated framework boot) is interface-only** — only routes 1 and 3 are functional for OpenAPI extraction.
|
|
389
|
+
- **LLM inference is stubbed** — no real LLM provider is wired yet.
|
|
390
|
+
- **Only Node/TS provider** — other language stacks require additional extraction providers.
|
|
391
|
+
- **Zod extraction handles basic `z.object` patterns only** — complex compositions are not fully supported.
|
|
392
|
+
- **Only kafkajs patterns supported** — other messaging clients are not detected.
|
|
644
393
|
|
|
645
|
-
|
|
394
|
+
---
|
|
646
395
|
|
|
647
|
-
|
|
396
|
+
## Tips
|
|
648
397
|
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
398
|
+
- Use `step-gated` mode (default) to review each sub-task
|
|
399
|
+
- Use `pre-approved autonomous batch` mode when you trust the agent to run autonomously
|
|
400
|
+
- Use `planner-resume` when a multi-story orchestration is interrupted
|
|
401
|
+
- Run `housekeeping` after major feature branches to catch regressions
|
|
402
|
+
- Domain instructions are auto-applied based on `applyTo` patterns
|
|
654
403
|
|
|
655
|
-
|
|
404
|
+
---
|
|
656
405
|
|
|
657
|
-
|
|
658
|
-
2. Auto-generates a CHANGELOG.md entry from commit history and merged PR metadata.
|
|
659
|
-
3. Suggests an increment type based on Conventional Commit analysis.
|
|
660
|
-
4. Updates `package.json` version to the new semver value.
|
|
661
|
-
5. Commits both CHANGELOG.md and package.json (`chore(release): v<version>`).
|
|
662
|
-
6. Creates an annotated git tag.
|
|
663
|
-
7. Pushes the commit to `main` and the tag to `origin`.
|
|
664
|
-
8. The tag push triggers both CI workflows automatically.
|
|
406
|
+
## Contributing
|
|
665
407
|
|
|
666
|
-
|
|
408
|
+
### Prerequisites
|
|
667
409
|
|
|
668
|
-
-
|
|
669
|
-
-
|
|
410
|
+
- Node.js >= 20
|
|
411
|
+
- pnpm (via `corepack enable`)
|
|
412
|
+
- git >= 2.37
|
|
670
413
|
|
|
671
|
-
|
|
414
|
+
### Setup
|
|
672
415
|
|
|
673
416
|
```bash
|
|
674
|
-
|
|
417
|
+
git clone https://github.com/llipe/dev-tasks.git
|
|
418
|
+
cd dev-tasks
|
|
419
|
+
pnpm install
|
|
675
420
|
```
|
|
676
421
|
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
The npm publish workflow uses **Trusted Publishers (OIDC)** — no npm token secret is needed. Configure once on npmjs.com:
|
|
680
|
-
|
|
681
|
-
1. Go to npmjs.com → Packages → `@llipe.com/dev-tasks` → Settings → Trusted Publisher
|
|
682
|
-
2. Select **GitHub Actions** and fill in:
|
|
683
|
-
- Organization or user: `llipe`
|
|
684
|
-
- Repository: `dev-tasks`
|
|
685
|
-
- Workflow filename: `publish-npm.yml`
|
|
686
|
-
- Environment name: `npm`
|
|
687
|
-
- Allowed actions: npm publish
|
|
688
|
-
|
|
689
|
-
Also create a GitHub environment named `npm` in the repo (Settings → Environments → New environment → `npm`). No secrets needed.
|
|
690
|
-
|
|
691
|
-
#### Option: download assets directly from the Releases page
|
|
692
|
-
|
|
693
|
-
If you prefer manual installation, download the bundle and checksum from:
|
|
694
|
-
|
|
695
|
-
- https://github.com/llipe/dev-tasks/releases
|
|
696
|
-
|
|
697
|
-
Example for a specific version:
|
|
422
|
+
### Build
|
|
698
423
|
|
|
699
424
|
```bash
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
curl -fL -o "dev-tasks-bundle-${VERSION}.tar.gz" \
|
|
704
|
-
"${BASE_URL}/dev-tasks-bundle-${VERSION}.tar.gz"
|
|
705
|
-
curl -fL -o "dev-tasks-bundle-${VERSION}.tar.gz.sha256" \
|
|
706
|
-
"${BASE_URL}/dev-tasks-bundle-${VERSION}.tar.gz.sha256"
|
|
707
|
-
|
|
708
|
-
# Verify checksum
|
|
709
|
-
shasum -a 256 -c "dev-tasks-bundle-${VERSION}.tar.gz.sha256"
|
|
710
|
-
|
|
711
|
-
# Extract
|
|
712
|
-
tar -xzf "dev-tasks-bundle-${VERSION}.tar.gz"
|
|
425
|
+
pnpm run build # compile TypeScript to dist/
|
|
426
|
+
pnpm run typecheck # type-check without emitting
|
|
713
427
|
```
|
|
714
428
|
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
## `dt` — Multi-Repo Context CLI
|
|
718
|
-
|
|
719
|
-
`dt` is the runtime binary for the `@llipe.com/dev-tasks` npm package. It extracts repository metadata (schema, OpenAPI, AsyncAPI), derives a `component.json` manifest with provenance and confidence tracking, and (in later phases) builds a cross-repo catalog and resolves scoped context bundles for agent sessions.
|
|
720
|
-
|
|
721
|
-
### Installation
|
|
429
|
+
### Test
|
|
722
430
|
|
|
723
431
|
```bash
|
|
724
|
-
#
|
|
725
|
-
pnpm
|
|
726
|
-
|
|
727
|
-
# Verify
|
|
728
|
-
dt --version
|
|
729
|
-
dev-tasks --version
|
|
432
|
+
pnpm run test # all tests (vitest)
|
|
433
|
+
pnpm run test:unit # unit tests only
|
|
434
|
+
pnpm run test:integration # integration tests only
|
|
730
435
|
```
|
|
731
436
|
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
| Binary | Purpose |
|
|
735
|
-
| ----------- | --------------------------------------------------- |
|
|
736
|
-
| `dev-tasks` | Bootstrap: install, update, status, pin, doctor |
|
|
737
|
-
| `dt` | Runtime: extract, catalog, ctx, scope, init, verify |
|
|
738
|
-
|
|
739
|
-
### Commands
|
|
740
|
-
|
|
741
|
-
#### `dt extract` — Repository metadata extraction
|
|
437
|
+
### Lint and Format
|
|
742
438
|
|
|
743
439
|
```bash
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
dt extract schema [--db-url <url>]
|
|
749
|
-
|
|
750
|
-
# Extract OpenAPI spec (route 1: copy existing, route 3: AST inference)
|
|
751
|
-
dt extract openapi [--strategy auto|1|3]
|
|
752
|
-
|
|
753
|
-
# Extract AsyncAPI spec from Kafka topic patterns (kafkajs)
|
|
754
|
-
dt extract asyncapi
|
|
755
|
-
|
|
756
|
-
# Derive component.json with provenance and confidence
|
|
757
|
-
dt extract component [--interactive]
|
|
758
|
-
|
|
759
|
-
# Run full extraction pipeline (detect → schema → openapi → asyncapi → component → report)
|
|
760
|
-
dt extract all [--interactive] [--force]
|
|
440
|
+
pnpm run lint # ESLint (zero warnings)
|
|
441
|
+
pnpm run lint:fix # auto-fix lint issues
|
|
442
|
+
pnpm run format:check # Prettier check
|
|
443
|
+
pnpm run format # Prettier write
|
|
761
444
|
```
|
|
762
445
|
|
|
763
|
-
|
|
446
|
+
### Full validation (CI equivalent)
|
|
764
447
|
|
|
765
448
|
```bash
|
|
766
|
-
|
|
767
|
-
dev-tasks update [--force] # Reconcile with hash-based conflict detection
|
|
768
|
-
dev-tasks status # Compare installed/pinned/latest versions
|
|
769
|
-
dev-tasks pin <version> # Pin to a specific version
|
|
770
|
-
dev-tasks doctor # Check Node ≥20, git ≥2.37, cache writable
|
|
771
|
-
dev-tasks migrate # Migrate from legacy dev-tasks.sh
|
|
449
|
+
pnpm run validate # typecheck + lint + format:check + test
|
|
772
450
|
```
|
|
773
451
|
|
|
774
|
-
###
|
|
452
|
+
### Releasing a new version
|
|
775
453
|
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
| Flag | Description |
|
|
779
|
-
| -------------------- | ---------------------------- |
|
|
780
|
-
| `--json` | Machine-readable JSON output |
|
|
781
|
-
| `--meta-repo <path>` | Path or URL to the meta-repo |
|
|
782
|
-
| `-v` | Verbose diagnostics (stderr) |
|
|
783
|
-
|
|
784
|
-
### Exit codes
|
|
785
|
-
|
|
786
|
-
| Code | Meaning |
|
|
787
|
-
| ---- | ------------------------------------------------- |
|
|
788
|
-
| 0 | OK |
|
|
789
|
-
| 1 | Unexpected error |
|
|
790
|
-
| 2 | Incorrect usage |
|
|
791
|
-
| 13 | Incomplete extraction: required fields unresolved |
|
|
792
|
-
| 14 | Reconciliation conflict (edited fields) |
|
|
793
|
-
|
|
794
|
-
### Typical workflow
|
|
454
|
+
Releases are automated via git tags. Use the release script:
|
|
795
455
|
|
|
796
456
|
```bash
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
# 2. Review outputs
|
|
802
|
-
cat component.json # manifest with _provenance
|
|
803
|
-
cat extraction_report.json # coverage, confidence, unresolved items
|
|
804
|
-
|
|
805
|
-
# 3. Validate
|
|
806
|
-
dt validate-component # (Phase 2+) checks against JSON Schema
|
|
807
|
-
|
|
808
|
-
# 4. Commit and push
|
|
809
|
-
git add component.json contracts/ docs/schema.md extraction_report.json
|
|
810
|
-
git commit -m "feat: add component manifest via dt extract"
|
|
457
|
+
git checkout main
|
|
458
|
+
git pull origin main
|
|
459
|
+
./scripts/release.sh patch # or: minor / major
|
|
811
460
|
```
|
|
812
461
|
|
|
813
|
-
|
|
462
|
+
The script:
|
|
814
463
|
|
|
815
|
-
|
|
464
|
+
1. Validates pre-flight conditions (branch, clean tree, format check).
|
|
465
|
+
2. Auto-generates a CHANGELOG entry from commit history.
|
|
466
|
+
3. Updates `package.json` version.
|
|
467
|
+
4. Commits (`chore(release): v<version>`), creates an annotated tag, and pushes.
|
|
468
|
+
5. The tag push triggers CI workflows:
|
|
469
|
+
- `.github/workflows/release-bundle.yml` — builds the tarball and creates a GitHub Release
|
|
470
|
+
- `.github/workflows/publish-npm.yml` — publishes to npm as `@llipe.com/dev-tasks`
|
|
816
471
|
|
|
817
|
-
|
|
818
|
-
- `dt extract detect|schema|openapi|asyncapi|component|all`
|
|
819
|
-
- Hash-based reconciliation with conflict detection
|
|
820
|
-
- Legacy shell-script migration shim
|
|
472
|
+
After the workflows complete, verify:
|
|
821
473
|
|
|
822
|
-
|
|
474
|
+
```bash
|
|
475
|
+
npm view @llipe.com/dev-tasks version
|
|
476
|
+
```
|
|
823
477
|
|
|
824
|
-
|
|
478
|
+
### CI setup (npm Trusted Publishers)
|
|
825
479
|
|
|
826
|
-
|
|
480
|
+
The npm publish workflow uses OIDC — no npm token secret needed. Configure once on npmjs.com:
|
|
827
481
|
|
|
828
|
-
|
|
829
|
-
|
|
830
|
-
-
|
|
831
|
-
-
|
|
832
|
-
-
|
|
482
|
+
1. Go to npmjs.com → `@llipe.com/dev-tasks` → Settings → Trusted Publisher
|
|
483
|
+
2. Select GitHub Actions:
|
|
484
|
+
- Organization/user: `llipe`
|
|
485
|
+
- Repository: `dev-tasks`
|
|
486
|
+
- Workflow: `publish-npm.yml`
|
|
487
|
+
- Environment: `npm`
|
|
488
|
+
3. Create a GitHub environment named `npm` in the repo (Settings → Environments)
|
|
833
489
|
|
|
834
490
|
---
|
|
835
491
|
|