@llipe.com/dev-tasks 0.6.4 → 0.6.6

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.
Files changed (143) hide show
  1. package/.claude/agents/developer.md +294 -0
  2. package/.claude/agents/github-ops.md +407 -0
  3. package/.claude/agents/housekeeping.md +109 -0
  4. package/.claude/agents/technical-writer.md +390 -0
  5. package/.claude/agents/ux-engineer.md +184 -0
  6. package/.claude/agents/verifier.md +276 -0
  7. package/.claude/commands/developer.md +272 -0
  8. package/.claude/commands/github-ops.md +10 -0
  9. package/.claude/commands/housekeeping.md +10 -0
  10. package/.claude/commands/planner.md +506 -0
  11. package/.claude/commands/product-engineer.md +263 -0
  12. package/.claude/commands/technical-writer.md +10 -0
  13. package/.claude/commands/ux-engineer.md +10 -0
  14. package/.claude/commands/verifier-audit.md +10 -0
  15. package/.claude/commands/verifier-design.md +10 -0
  16. package/.claude/hooks/git-guard.sh +95 -0
  17. package/.claude/skills/activity-contract-test-design/SKILL.md +122 -0
  18. package/.claude/skills/activity-drift-reconciliation/SKILL.md +133 -0
  19. package/.claude/skills/activity-e2e-test-design/SKILL.md +124 -0
  20. package/.claude/skills/activity-edge-case-refinement/SKILL.md +146 -0
  21. package/.claude/skills/activity-generate-spec/SKILL.md +137 -0
  22. package/.claude/skills/activity-generate-stories/SKILL.md +243 -0
  23. package/.claude/skills/activity-init/SKILL.md +162 -0
  24. package/.claude/skills/activity-publish-github/SKILL.md +116 -0
  25. package/.claude/skills/activity-random-test-tactics/SKILL.md +181 -0
  26. package/.claude/skills/activity-refine/SKILL.md +236 -0
  27. package/.claude/skills/git-ops/SKILL.md +221 -0
  28. package/.claude/skills/implement/SKILL.md +129 -0
  29. package/.claude/skills/memo-cli-usage/REFERENCE.md +798 -0
  30. package/.claude/skills/memo-cli-usage/SKILL.md +144 -0
  31. package/.claude/skills/plan/SKILL.md +145 -0
  32. package/.claude/skills/webapp-mockup/SKILL.md +76 -0
  33. package/.claude/skills/webapp-mockup/scripts/scaffold-mockup.sh +469 -0
  34. package/.github/agents/developer.agent.md +293 -0
  35. package/.github/agents/github-ops.agent.md +416 -0
  36. package/.github/agents/housekeeping.agent.md +109 -0
  37. package/.github/agents/planner.agent.md +496 -0
  38. package/.github/agents/product-engineer.agent.md +262 -0
  39. package/.github/agents/technical-writer.agent.md +389 -0
  40. package/.github/agents/ux-engineer.agent.md +183 -0
  41. package/.github/agents/verifier.agent.md +275 -0
  42. package/.github/instructions/domain/nextjs-pages-components.instructions.md +375 -0
  43. package/.github/instructions/implement.instructions.md +128 -0
  44. package/.github/instructions/plan.instructions.md +144 -0
  45. package/.github/prompts/developer-execute.prompt.md +13 -0
  46. package/.github/prompts/github-ops.prompt.md +16 -0
  47. package/.github/prompts/housekeeping.prompt.md +16 -0
  48. package/.github/prompts/planner-resume.prompt.md +13 -0
  49. package/.github/prompts/planner.prompt.md +18 -0
  50. package/.github/prompts/product-engineer-feature.prompt.md +21 -0
  51. package/.github/prompts/product-engineer-init.prompt.md +16 -0
  52. package/.github/prompts/product-engineer-issue.prompt.md +19 -0
  53. package/.github/prompts/technical-writer.prompt.md +21 -0
  54. package/.github/prompts/ux-engineer.prompt.md +14 -0
  55. package/.github/prompts/verifier-audit.prompt.md +33 -0
  56. package/.github/prompts/verifier-design.prompt.md +28 -0
  57. package/.github/skills/activity-contract-test-design/SKILL.md +117 -0
  58. package/.github/skills/activity-drift-reconciliation/SKILL.md +128 -0
  59. package/.github/skills/activity-e2e-test-design/SKILL.md +119 -0
  60. package/.github/skills/activity-edge-case-refinement/SKILL.md +141 -0
  61. package/.github/skills/activity-generate-spec/SKILL.md +132 -0
  62. package/.github/skills/activity-generate-stories/SKILL.md +238 -0
  63. package/.github/skills/activity-init/SKILL.md +157 -0
  64. package/.github/skills/activity-publish-github/SKILL.md +111 -0
  65. package/.github/skills/activity-random-test-tactics/SKILL.md +176 -0
  66. package/.github/skills/activity-refine/SKILL.md +231 -0
  67. package/.github/skills/git-ops/SKILL.md +216 -0
  68. package/.github/skills/memo-cli-usage/REFERENCE.md +798 -0
  69. package/.github/skills/memo-cli-usage/SKILL.md +144 -0
  70. package/.github/skills/webapp-mockup/SKILL.md +71 -0
  71. package/.github/skills/webapp-mockup/scripts/scaffold-mockup.sh +469 -0
  72. package/.kiro/agents/developer.md +305 -0
  73. package/.kiro/agents/github-ops.md +428 -0
  74. package/.kiro/agents/housekeeping.md +122 -0
  75. package/.kiro/agents/planner.md +530 -0
  76. package/.kiro/agents/product-engineer.md +294 -0
  77. package/.kiro/agents/technical-writer.md +408 -0
  78. package/.kiro/agents/ux-engineer.md +200 -0
  79. package/.kiro/agents/verifier.md +275 -0
  80. package/.kiro/hooks/git-guard.json +16 -0
  81. package/.kiro/hooks/scripts/git-guard.sh +116 -0
  82. package/.kiro/skills/activity-contract-test-design/SKILL.md +122 -0
  83. package/.kiro/skills/activity-drift-reconciliation/SKILL.md +133 -0
  84. package/.kiro/skills/activity-e2e-test-design/SKILL.md +124 -0
  85. package/.kiro/skills/activity-edge-case-refinement/SKILL.md +146 -0
  86. package/.kiro/skills/activity-generate-spec/SKILL.md +137 -0
  87. package/.kiro/skills/activity-generate-stories/SKILL.md +243 -0
  88. package/.kiro/skills/activity-init/SKILL.md +162 -0
  89. package/.kiro/skills/activity-publish-github/SKILL.md +116 -0
  90. package/.kiro/skills/activity-random-test-tactics/SKILL.md +181 -0
  91. package/.kiro/skills/activity-refine/SKILL.md +236 -0
  92. package/.kiro/skills/git-ops/SKILL.md +221 -0
  93. package/.kiro/skills/memo-cli-usage/REFERENCE.md +798 -0
  94. package/.kiro/skills/memo-cli-usage/SKILL.md +144 -0
  95. package/.kiro/skills/webapp-mockup/SKILL.md +76 -0
  96. package/.kiro/steering/git-guard-notice.md +11 -0
  97. package/.kiro/steering/implement.md +129 -0
  98. package/.kiro/steering/nextjs-pages-components.md +376 -0
  99. package/.kiro/steering/plan.md +145 -0
  100. package/AGENTS.md +122 -0
  101. package/CHANGELOG.md +28 -2
  102. package/CLAUDE.md +94 -0
  103. package/README.md +6 -6
  104. package/dist/adapters/cli/extract-all.js +4 -4
  105. package/dist/adapters/cli/extract-component.d.ts +1 -1
  106. package/dist/adapters/cli/extract-component.js +4 -4
  107. package/dist/adapters/cli/parse-args.d.ts +1 -0
  108. package/dist/adapters/cli/parse-args.d.ts.map +1 -1
  109. package/dist/adapters/cli/parse-args.js +19 -8
  110. package/dist/adapters/cli/parse-args.js.map +1 -1
  111. package/dist/bin/dev-tasks.js +23 -9
  112. package/dist/bin/dev-tasks.js.map +1 -1
  113. package/dist/bin/dt.js +3 -3
  114. package/dist/core/distribution/index.d.ts +5 -3
  115. package/dist/core/distribution/index.d.ts.map +1 -1
  116. package/dist/core/distribution/index.js +3 -2
  117. package/dist/core/distribution/index.js.map +1 -1
  118. package/dist/core/distribution/install.d.ts +20 -8
  119. package/dist/core/distribution/install.d.ts.map +1 -1
  120. package/dist/core/distribution/install.js +76 -36
  121. package/dist/core/distribution/install.js.map +1 -1
  122. package/dist/core/distribution/manifest.d.ts +25 -2
  123. package/dist/core/distribution/manifest.d.ts.map +1 -1
  124. package/dist/core/distribution/manifest.js +29 -2
  125. package/dist/core/distribution/manifest.js.map +1 -1
  126. package/dist/core/distribution/migrate.d.ts +6 -3
  127. package/dist/core/distribution/migrate.d.ts.map +1 -1
  128. package/dist/core/distribution/migrate.js +21 -19
  129. package/dist/core/distribution/migrate.js.map +1 -1
  130. package/dist/core/distribution/profiles.d.ts +30 -0
  131. package/dist/core/distribution/profiles.d.ts.map +1 -0
  132. package/dist/core/distribution/profiles.js +57 -0
  133. package/dist/core/distribution/profiles.js.map +1 -0
  134. package/dist/core/distribution/update.d.ts +6 -4
  135. package/dist/core/distribution/update.d.ts.map +1 -1
  136. package/dist/core/distribution/update.js +22 -22
  137. package/dist/core/distribution/update.js.map +1 -1
  138. package/dist/core/extract/component.d.ts +9 -9
  139. package/dist/core/extract/component.js +5 -5
  140. package/dist/core/extract/report.d.ts +1 -1
  141. package/dist/core/extract/report.js +1 -1
  142. package/package.json +15 -2
  143. package/skills/.gitkeep +0 -0
@@ -0,0 +1,129 @@
1
+ ---
2
+ name: implement
3
+ description: "Execute a task list step-by-step with strict sequencing, branch/PR discipline, GitHub Issue sync, and user approval gates. Single source of truth for implementation. Use when implementing from a tasks-*.md file."
4
+ ---
5
+
6
+ # Activity: Implement Task List
7
+
8
+ > **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).
9
+
10
+ ## Goal
11
+
12
+ Execute a task list step-by-step with strict sequencing, proper branching, PR workflow, GitHub Issue synchronization, and user approval gates.
13
+
14
+ This is the **single source of truth** for execution rules. All agents and workflows that perform implementation **MUST** follow these rules.
15
+
16
+ ## Context
17
+
18
+ This activity assumes:
19
+
20
+ - A task list file exists in `/workstream/tasks-*.md`.
21
+ - The corresponding GitHub Issue exists and includes a checklist.
22
+ - GitHub is the source of truth for execution status.
23
+
24
+ ## Package Manager and Command Standards
25
+
26
+ - For JavaScript/TypeScript repositories, you **MUST** prefer `pnpm` over `npm` for dependency and script commands.
27
+ - You **MAY** use `npm` only when `pnpm` is unavailable or the project is explicitly npm-locked.
28
+ - For JS/TS repositories, quality and test execution **MUST** use canonical `package.json` script names where available: `lint`, `format:check`, `typecheck`, `test`, `audit`, and `validate`.
29
+
30
+ ---
31
+
32
+ ## Before Starting Work
33
+
34
+ 1. You **MUST** confirm the GitHub Issue is open.
35
+ 2. You **MUST** create a new branch from the latest default branch by delegating branch naming and creation to `github-ops` whenever possible.
36
+ - Branch format: `issue/<issue-number>-<short-description>` or `story/<id>-<short-description>`
37
+ 3. You **MUST** open a **draft Pull Request** by delegating to `github-ops` whenever possible.
38
+ - Base branch is the default branch unless an orchestrating caller explicitly provides a base-branch override.
39
+ - PR title **MUST** follow Conventional Commits (e.g., `feat: implement issue 37`).
40
+ - PR description **MUST** include `Closes #<issue-number>`.
41
+ 4. You **MUST** ensure the task list in the GitHub Issue matches the local `/workstream/tasks-*.md` file.
42
+
43
+ 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.
44
+
45
+ ---
46
+
47
+ ## During Implementation
48
+
49
+ ### Step-by-Step Execution
50
+
51
+ - You **MUST** execute **one sub-task at a time**.
52
+ - You **MUST NOT** start the next sub-task until the user grants permission (says "yes" or "y").
53
+ - After completing each sub-task, you **MUST** immediately:
54
+ 1. Mark it `[x]` in the local task file.
55
+ 2. Mark it `[x]` in the GitHub Issue checklist.
56
+ 3. Stop and wait for user approval before proceeding.
57
+
58
+ ### Parent Task Completion
59
+
60
+ - When **all** sub-tasks under a parent task are `[x]`, you **MUST** also mark the **parent task** as `[x]`.
61
+
62
+ ### Task List Maintenance
63
+
64
+ - You **MUST** regularly update the task list file after finishing significant work.
65
+ - You **MUST** add newly discovered tasks as they emerge.
66
+ - You **MUST** keep the "Relevant Files" section accurate and up to date with every file created or modified.
67
+ - You **MUST** keep the local task list and the GitHub Issue checklist aligned at all times.
68
+ - If drift is detected between local and GitHub, you **MUST** reconcile immediately and report the reconciliation.
69
+ - If schema/data-model changes are in scope, migration artifacts **MUST** be tracked in the task list unless an explicit opt-out rationale is documented.
70
+
71
+ ### Progress Updates
72
+
73
+ - You **SHOULD** add brief issue or PR comments for major milestones or meaningful changes.
74
+ - You **SHOULD** route issue/PR comment updates through `github-ops` whenever possible.
75
+
76
+ ---
77
+
78
+ ## Before Closing a Story/Issue
79
+
80
+ 1. All acceptance criteria **MUST** be verified.
81
+ 2. All tests listed in the checklist **MUST** be completed and passing.
82
+ 3. The following quality gates **MUST** be completed and passing before completion:
83
+ - `test`
84
+ - `lint`
85
+ - `format:check`
86
+ - `typecheck`
87
+ - `audit`
88
+ 4. For schema/data-model changes, migration handling **MUST** satisfy all of the following:
89
+ - migration artifact created (unless documented opt-out)
90
+ - rollback/impact notes captured
91
+ - explicit user confirmation obtained before any migration apply command
92
+ - apply step executed only after user confirmation
93
+ - post-apply verification recorded
94
+ 5. `technical-writer` validation **MUST** include a drift/stale-doc check report, and completion **MUST NOT** proceed while unresolved drift remains.
95
+ 6. A `verifier` audit in `audit` mode **MUST** have run against the delivered implementation, with its human-readable summary posted to the issue/PR. This gate is mandatory and non-skippable — it **MUST NOT** be skipped regardless of drift findings, and drift findings reported by this audit **MUST NOT** block completion. This condition is satisfied once the audit has run and been posted; any resulting drift is handled by `product-engineer`'s `activity-drift-reconciliation` flow after this gate, not before it.
96
+ 7. The PR **MUST** be converted from draft to ready for review.
97
+ 8. The PR **MUST** be approved by the appropriate reviewer per the merge authority policy in `github-ops`:
98
+ - PRs targeting an **integration branch**: `planner` reviews and approves.
99
+ - PRs targeting **`main`**: the **user** reviews and approves.
100
+ 9. The PR **MUST** be merged by the authorized party (planner for integration branches, user for `main`).
101
+ 10. You **MUST NOT** close the GitHub Issue until the PR is approved **AND** merged.
102
+ 11. You **MUST NOT** close the issue while the PR is still in draft or pending review.
103
+ 12. You **MUST** notify the user when the PR is ready for review — explicitly inform them so they can review and merge.
104
+
105
+ ---
106
+
107
+ ## GitHub Execution Rules Summary
108
+
109
+ | Phase | Rule |
110
+ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
111
+ | **Before coding** | Confirm issue open → Create branch (`github-ops`) → Open draft PR (`github-ops`) → Sync checklists |
112
+ | **During coding** | One sub-task at a time → Mark `[x]` locally + GitHub → Wait for approval |
113
+ | **Before closing** | All ACs verified → Quality gates pass (test/lint/format/typecheck/audit) → migration confirmation/apply/verify (when applicable) → docs drift check clear → verifier audit run + summary posted (non-blocking on drift) → PR ready → Approved → Merged → Then close issue |
114
+
115
+ ---
116
+
117
+ ## Output
118
+
119
+ - Keep all changes and status updates in GitHub and `/workstream/tasks-*.md`.
120
+ - You **MUST** check which sub-task is next before starting work.
121
+ - After implementing a sub-task, you **MUST** update the file and then pause for user approval.
122
+
123
+ ## Final Instructions
124
+
125
+ 1. You **MUST** always respect the task list execution order.
126
+ 2. You **MUST** keep the GitHub Issue updated with checklist and progress comments.
127
+ 3. You **MUST** ensure branch, PR, and issue naming follow `github-ops` conventions.
128
+ 4. You **MUST** stop after each sub-task and request user approval.
129
+ 5. You **MUST NOT** close a GitHub Issue without confirming the PR has been reviewed, approved, and merged.