nitm-ai-dev-toolkit 3.0.23 → 5.0.0

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 (187) hide show
  1. package/CHANGELOG.md +44 -3
  2. package/README.md +93 -6
  3. package/bin/cli.js +155 -25
  4. package/bin/factory-archive.js +71 -0
  5. package/bin/factory-prune.js +79 -0
  6. package/bin/factory-watch.js +509 -0
  7. package/package.json +1 -1
  8. package/src/monorepo/.agents/skills/factory/SKILL.md +593 -0
  9. package/src/monorepo/.claude/agents/admin-portal.agent.md +1 -1
  10. package/src/monorepo/.claude/agents/api-specialist.agent.md +1 -1
  11. package/src/monorepo/.claude/agents/backend-architect.agent.md +1 -1
  12. package/src/monorepo/.claude/agents/documenter.agent.md +1 -1
  13. package/src/monorepo/.claude/agents/factory-approver.agent.md +12 -0
  14. package/src/monorepo/.claude/agents/factory-builder.agent.md +12 -0
  15. package/src/monorepo/.claude/agents/factory-reviewer-code.agent.md +12 -0
  16. package/src/monorepo/.claude/agents/factory-reviewer-security.agent.md +12 -0
  17. package/src/monorepo/.claude/agents/factory-reviewer-ui.agent.md +12 -0
  18. package/src/monorepo/.claude/agents/factory-reviewer-ux.agent.md +12 -0
  19. package/src/monorepo/.claude/agents/factory-spec-writer.agent.md +12 -0
  20. package/src/monorepo/.claude/agents/feature-builder.agent.md +1 -1
  21. package/src/monorepo/.claude/agents/frontend-developer.agent.md +1 -1
  22. package/src/monorepo/.claude/agents/green.agent.md +1 -1
  23. package/src/monorepo/.claude/agents/implementer.agent.md +1 -1
  24. package/src/monorepo/.claude/agents/planner.agent.md +1 -1
  25. package/src/monorepo/.claude/agents/red.agent.md +1 -1
  26. package/src/monorepo/.claude/agents/refactor.agent.md +1 -1
  27. package/src/monorepo/.claude/agents/researcher.agent.md +1 -1
  28. package/src/monorepo/.claude/agents/reviewer.agent.md +1 -1
  29. package/src/monorepo/.claude/agents/tdd.agent.md +1 -1
  30. package/src/monorepo/.claude/agents-snippets/factory-approver.md +72 -0
  31. package/src/monorepo/.claude/agents-snippets/factory-builder.md +101 -0
  32. package/src/monorepo/.claude/agents-snippets/factory-reviewer-code.md +57 -0
  33. package/src/monorepo/.claude/agents-snippets/factory-reviewer-security.md +48 -0
  34. package/src/monorepo/.claude/agents-snippets/factory-reviewer-ui.md +64 -0
  35. package/src/monorepo/.claude/agents-snippets/factory-reviewer-ux.md +64 -0
  36. package/src/monorepo/.claude/agents-snippets/factory-spec-writer.md +119 -0
  37. package/src/monorepo/.claude/agents-snippets/feature-builder.md +1 -1
  38. package/src/monorepo/.claude/commands/factory.md +24 -0
  39. package/src/monorepo/.claude/commands/ponytail-audit.md +4 -6
  40. package/src/monorepo/.claude/commands/ponytail-debt.md +3 -5
  41. package/src/monorepo/.claude/commands/ponytail-gain.md +2 -4
  42. package/src/monorepo/.claude/commands/ponytail-help.md +2 -4
  43. package/src/monorepo/.claude/commands/ponytail-review.md +3 -5
  44. package/src/monorepo/.claude/commands/ponytail.md +3 -5
  45. package/src/monorepo/.claude/prompt-snippets/assign-tasks.md +6 -2
  46. package/src/monorepo/.claude/prompt-snippets/bootstrap-patch.md +32 -17
  47. package/src/monorepo/.claude/prompt-snippets/bootstrap-upgrade.md +76 -51
  48. package/src/monorepo/.claude/prompt-snippets/bootstrap.md +57 -29
  49. package/src/monorepo/.claude/prompt-snippets/factory.md +20 -0
  50. package/src/monorepo/.claude/prompt-snippets/implement-feature.md +2 -2
  51. package/src/monorepo/.claude/prompt-snippets/tasks.md +49 -87
  52. package/src/monorepo/.claude/rules-snippets/documentation.md +8 -6
  53. package/src/monorepo/.cursor/agents/factory-approver.agent.md +11 -0
  54. package/src/monorepo/.cursor/agents/factory-builder.agent.md +11 -0
  55. package/src/monorepo/.cursor/agents/factory-reviewer-code.agent.md +11 -0
  56. package/src/monorepo/.cursor/agents/factory-reviewer-security.agent.md +11 -0
  57. package/src/monorepo/.cursor/agents/factory-reviewer-ui.agent.md +11 -0
  58. package/src/monorepo/.cursor/agents/factory-reviewer-ux.agent.md +11 -0
  59. package/src/monorepo/.cursor/agents/factory-spec-writer.agent.md +11 -0
  60. package/src/monorepo/.cursor/commands/factory.md +24 -0
  61. package/src/monorepo/.github/agents/factory-approver.agent.md +11 -0
  62. package/src/monorepo/.github/agents/factory-builder.agent.md +11 -0
  63. package/src/monorepo/.github/agents/factory-reviewer-code.agent.md +11 -0
  64. package/src/monorepo/.github/agents/factory-reviewer-security.agent.md +11 -0
  65. package/src/monorepo/.github/agents/factory-reviewer-ui.agent.md +11 -0
  66. package/src/monorepo/.github/agents/factory-reviewer-ux.agent.md +11 -0
  67. package/src/monorepo/.github/agents/factory-spec-writer.agent.md +11 -0
  68. package/src/monorepo/.github/prompts/factory.prompt.md +25 -0
  69. package/src/monorepo/.github/prompts/review-staged.prompt.md +1 -1
  70. package/src/monorepo/.opencode/agents/admin-portal.md +10 -4
  71. package/src/monorepo/.opencode/agents/api-specialist.md +10 -4
  72. package/src/monorepo/.opencode/agents/backend-architect.md +10 -4
  73. package/src/monorepo/.opencode/agents/documenter.md +10 -4
  74. package/src/monorepo/.opencode/agents/factory-approver.md +20 -0
  75. package/src/monorepo/.opencode/agents/factory-builder.md +20 -0
  76. package/src/monorepo/.opencode/agents/factory-reviewer-code.md +20 -0
  77. package/src/monorepo/.opencode/agents/factory-reviewer-security.md +20 -0
  78. package/src/monorepo/.opencode/agents/factory-reviewer-ui.md +20 -0
  79. package/src/monorepo/.opencode/agents/factory-reviewer-ux.md +20 -0
  80. package/src/monorepo/.opencode/agents/factory-spec-writer.md +20 -0
  81. package/src/monorepo/.opencode/agents/feature-builder.md +13 -5
  82. package/src/monorepo/.opencode/agents/frontend-developer.md +10 -4
  83. package/src/monorepo/.opencode/agents/green.md +10 -4
  84. package/src/monorepo/.opencode/agents/implementer.md +10 -4
  85. package/src/monorepo/.opencode/agents/planner.md +10 -4
  86. package/src/monorepo/.opencode/agents/red.md +10 -4
  87. package/src/monorepo/.opencode/agents/refactor.md +10 -4
  88. package/src/monorepo/.opencode/agents/researcher.md +10 -4
  89. package/src/monorepo/.opencode/agents/reviewer.md +10 -4
  90. package/src/monorepo/.opencode/agents/tdd.md +13 -5
  91. package/src/monorepo/.opencode/commands/factory.md +29 -0
  92. package/src/monorepo/.opencode/opencode.jsonc +8 -10
  93. package/src/monorepo/AGENTS.md +30 -1
  94. package/src/monorepo/CLAUDE.md +1 -1
  95. package/src/monorepo/README.md +20 -0
  96. package/src/monorepo/factory/README.md +194 -0
  97. package/src/monorepo/factory/_gitignore +5 -0
  98. package/src/repo/.agents/skills/factory/SKILL.md +593 -0
  99. package/src/repo/.claude/agents/admin-portal.agent.md +1 -1
  100. package/src/repo/.claude/agents/api-specialist.agent.md +1 -1
  101. package/src/repo/.claude/agents/backend-architect.agent.md +1 -1
  102. package/src/repo/.claude/agents/documenter.agent.md +2 -2
  103. package/src/repo/.claude/agents/factory-approver.agent.md +12 -0
  104. package/src/repo/.claude/agents/factory-builder.agent.md +12 -0
  105. package/src/repo/.claude/agents/factory-reviewer-code.agent.md +12 -0
  106. package/src/repo/.claude/agents/factory-reviewer-security.agent.md +12 -0
  107. package/src/repo/.claude/agents/factory-reviewer-ui.agent.md +12 -0
  108. package/src/repo/.claude/agents/factory-reviewer-ux.agent.md +12 -0
  109. package/src/repo/.claude/agents/factory-spec-writer.agent.md +12 -0
  110. package/src/repo/.claude/agents/feature-builder.agent.md +1 -1
  111. package/src/repo/.claude/agents/frontend-developer.agent.md +1 -1
  112. package/src/repo/.claude/agents/green.agent.md +1 -1
  113. package/src/repo/.claude/agents/implementer.agent.md +1 -1
  114. package/src/repo/.claude/agents/planner.agent.md +2 -2
  115. package/src/repo/.claude/agents/red.agent.md +1 -1
  116. package/src/repo/.claude/agents/refactor.agent.md +1 -1
  117. package/src/repo/.claude/agents/researcher.agent.md +2 -2
  118. package/src/repo/.claude/agents/reviewer.agent.md +2 -2
  119. package/src/repo/.claude/agents/tdd.agent.md +1 -1
  120. package/src/repo/.claude/agents-snippets/factory-approver.md +72 -0
  121. package/src/repo/.claude/agents-snippets/factory-builder.md +100 -0
  122. package/src/repo/.claude/agents-snippets/factory-reviewer-code.md +57 -0
  123. package/src/repo/.claude/agents-snippets/factory-reviewer-security.md +48 -0
  124. package/src/repo/.claude/agents-snippets/factory-reviewer-ui.md +64 -0
  125. package/src/repo/.claude/agents-snippets/factory-reviewer-ux.md +64 -0
  126. package/src/repo/.claude/agents-snippets/factory-spec-writer.md +117 -0
  127. package/src/repo/.claude/agents-snippets/feature-builder.md +1 -1
  128. package/src/repo/.claude/commands/factory.md +24 -0
  129. package/src/repo/.claude/commands/ponytail-audit.md +4 -6
  130. package/src/repo/.claude/commands/ponytail-debt.md +3 -5
  131. package/src/repo/.claude/commands/ponytail-gain.md +2 -4
  132. package/src/repo/.claude/commands/ponytail-help.md +2 -4
  133. package/src/repo/.claude/commands/ponytail-review.md +3 -5
  134. package/src/repo/.claude/commands/ponytail.md +3 -5
  135. package/src/repo/.claude/prompt-snippets/assign-tasks.md +6 -2
  136. package/src/repo/.claude/prompt-snippets/bootstrap-patch.md +32 -17
  137. package/src/repo/.claude/prompt-snippets/bootstrap-upgrade.md +87 -77
  138. package/src/repo/.claude/prompt-snippets/bootstrap.md +71 -74
  139. package/src/repo/.claude/prompt-snippets/factory.md +20 -0
  140. package/src/repo/.claude/prompt-snippets/implement-feature.md +2 -2
  141. package/src/repo/.claude/prompt-snippets/tasks.md +49 -112
  142. package/src/repo/.cursor/agents/factory-approver.agent.md +11 -0
  143. package/src/repo/.cursor/agents/factory-builder.agent.md +11 -0
  144. package/src/repo/.cursor/agents/factory-reviewer-code.agent.md +11 -0
  145. package/src/repo/.cursor/agents/factory-reviewer-security.agent.md +11 -0
  146. package/src/repo/.cursor/agents/factory-reviewer-ui.agent.md +11 -0
  147. package/src/repo/.cursor/agents/factory-reviewer-ux.agent.md +11 -0
  148. package/src/repo/.cursor/agents/factory-spec-writer.agent.md +11 -0
  149. package/src/repo/.cursor/commands/factory.md +24 -0
  150. package/src/repo/.github/agents/factory-approver.agent.md +11 -0
  151. package/src/repo/.github/agents/factory-builder.agent.md +11 -0
  152. package/src/repo/.github/agents/factory-reviewer-code.agent.md +11 -0
  153. package/src/repo/.github/agents/factory-reviewer-security.agent.md +11 -0
  154. package/src/repo/.github/agents/factory-reviewer-ui.agent.md +11 -0
  155. package/src/repo/.github/agents/factory-reviewer-ux.agent.md +11 -0
  156. package/src/repo/.github/agents/factory-spec-writer.agent.md +11 -0
  157. package/src/repo/.github/prompts/factory.prompt.md +25 -0
  158. package/src/repo/.opencode/agents/admin-portal.md +10 -4
  159. package/src/repo/.opencode/agents/api-specialist.md +10 -4
  160. package/src/repo/.opencode/agents/backend-architect.md +10 -4
  161. package/src/repo/.opencode/agents/documenter.md +10 -4
  162. package/src/repo/.opencode/agents/factory-approver.md +20 -0
  163. package/src/repo/.opencode/agents/factory-builder.md +20 -0
  164. package/src/repo/.opencode/agents/factory-reviewer-code.md +20 -0
  165. package/src/repo/.opencode/agents/factory-reviewer-security.md +20 -0
  166. package/src/repo/.opencode/agents/factory-reviewer-ui.md +20 -0
  167. package/src/repo/.opencode/agents/factory-reviewer-ux.md +20 -0
  168. package/src/repo/.opencode/agents/factory-spec-writer.md +20 -0
  169. package/src/repo/.opencode/agents/feature-builder.md +13 -5
  170. package/src/repo/.opencode/agents/frontend-developer.md +10 -4
  171. package/src/repo/.opencode/agents/green.md +10 -4
  172. package/src/repo/.opencode/agents/implementer.md +10 -4
  173. package/src/repo/.opencode/agents/planner.md +10 -4
  174. package/src/repo/.opencode/agents/red.md +10 -4
  175. package/src/repo/.opencode/agents/refactor.md +10 -4
  176. package/src/repo/.opencode/agents/researcher.md +10 -4
  177. package/src/repo/.opencode/agents/reviewer.md +10 -4
  178. package/src/repo/.opencode/agents/tdd.md +13 -5
  179. package/src/repo/.opencode/commands/factory.md +29 -0
  180. package/src/repo/.opencode/opencode.jsonc +8 -10
  181. package/src/repo/AGENTS.md +27 -1
  182. package/src/repo/CLAUDE.md +1 -1
  183. package/src/repo/README.md +20 -0
  184. package/src/repo/factory/README.md +194 -0
  185. package/src/repo/factory/_gitignore +5 -0
  186. package/src/monorepo/.opencode/plugins/ponytail.mjs +0 -93
  187. package/src/repo/.opencode/plugins/ponytail.mjs +0 -93
@@ -1,6 +1,8 @@
1
- # Generate Task Breakdown
1
+ # Generate Task Checklist
2
2
 
3
- Break down the implementation plan into executable tasks. This is the third step in the development lifecycle.
3
+ Break the implementation plan into a slim task checklist. This is the third step in the development lifecycle.
4
+
5
+ `tasks.md` is a checklist only. Acceptance criteria live in `spec.md`; approach, files, and effort live in `plan.md`. Do not repeat them here.
4
6
 
5
7
  ## Usage
6
8
 
@@ -9,138 +11,73 @@ Break down the implementation plan into executable tasks. This is the third step
9
11
  /tasks docs/features/user-authentication/tasks.md
10
12
  ```
11
13
 
12
- ## Task Consolidation Rules (CRITICAL)
14
+ ## When Not to Create tasks.md
13
15
 
14
- Before creating tasks, apply these consolidation principles:
16
+ Small work (1-2 steps) needs no `tasks.md`. Implement it directly.
15
17
 
16
- ### Target Task Counts
18
+ ## Consolidation Rules (CRITICAL)
17
19
 
18
- | Feature Complexity | Total Tasks | Max Subtasks/Task |
19
- | ------------------- | ----------- | ----------------- |
20
- | Simple (< 4 hours) | 2-3 | 0 |
21
- | Medium (4-16 hours) | 3-5 | 2-4 |
22
- | Complex (16-40 hrs) | 5-8 | 3-6 |
23
- | Large (40+ hours) | 8-12 | 5-10 |
20
+ ### Target Task Counts
24
21
 
25
- ### Consolidation Principles
22
+ | Feature Complexity | Total Tasks |
23
+ | ------------------- | ----------- |
24
+ | Simple (< 4 hours) | 2-3 |
25
+ | Medium (4-16 hours) | 3-5 |
26
+ | Complex (16-40 hrs) | 5-8 |
27
+ | Large (40+ hours) | 8-12 |
26
28
 
27
- - **Group by deliverable**: Combine work that ships together
28
- - **Merge related files**: Model + migration + factory = 1 task
29
- - **Bundle by layer**: All service layer work = 1 task (if related)
30
- - **Avoid micro-tasks**: Nothing under 1-2 hours as standalone
31
- - **Limit phases**: Combine Foundation + Implementation when small
29
+ ### Principles
32
30
 
33
- ### Before Finalizing, Ask:
31
+ - **Group by deliverable**: combine work that ships together (model + migration + factory = 1 task)
32
+ - **Bundle by layer or resource**: all service work for one area, all endpoints for one resource
33
+ - **Avoid micro-tasks**: nothing under 1-2 hours standalone
34
+ - **Limit phases**: combine Foundation + Implementation when small
34
35
 
35
- 1. Can any adjacent phases be combined?
36
- 2. Are there tasks under 2 hours that should be merged?
37
- 3. Would a developer naturally complete these together?
38
- 4. Does each task represent meaningful progress?
36
+ Before finalizing, ask: Can adjacent tasks merge? Would one developer naturally finish these together? Does each task show meaningful progress?
39
37
 
40
38
  ## Process
41
39
 
42
- 1. **Load Context**:
43
- - Read specification from `docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/spec.md`
44
- - Read plan from `docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/plan.md`
45
- - Review `AGENTS.md` for project patterns
46
-
47
- 2. **Generate Consolidated Task Breakdown**:
48
-
49
- Create `docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/tasks.md` with phases (combine where appropriate):
50
-
51
- ### Phase 1: Foundation & Setup (combine into 1 task)
52
- - Database schema changes, migrations, seeders
53
- - Type definitions and interfaces
54
- - Base models and validators
55
- - Configuration and dependencies
56
-
57
- ### Phase 2: Core Implementation (group by feature area)
58
- - Core functionality grouped by component
59
- - API endpoints or components (CRUD together)
60
- - Business logic and services
61
-
62
- ### Phase 3: Testing (1 task per major component)
63
- - Unit tests for component
64
- - Integration tests for feature
65
- - E2E tests (if applicable)
66
-
67
- ### Phase 4: Polish & Documentation (combine into 1 task)
68
- - Error handling improvements
69
- - Performance optimization
70
- - Documentation updates
40
+ 1. **Load context**: `docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/spec.md`, `plan.md`, and `AGENTS.md` (project patterns).
71
41
 
72
- 3. **Consolidated Task Format**:
42
+ 2. **Write `docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/tasks.md`** in the format below.
73
43
 
74
- ```markdown
75
- ### T001: [Consolidated Task Name]
44
+ 3. **Report**: tasks file path, task count, number of `[P]` tasks, and the consolidation note ("Combined X items into Y tasks"). Next step: `/implement-feature`, or `/assign-tasks` to create tickets.
76
45
 
77
- **Phase**: [Foundation/Implementation/Testing/Polish]
78
- **Estimated Effort**: [Hours - aim for 2-8 hours per task]
79
- **Parallel**: [Yes/No]
46
+ ## Task Line Format
80
47
 
81
- **Scope** (what this task covers):
48
+ ```markdown
49
+ # Tasks: {{ISSUE_ID}}-{{FEATURE_NAME}}
82
50
 
83
- - [Component/feature 1]
84
- - [Component/feature 2]
85
- - [Related component 3]
86
-
87
- **Files to Create/Modify**:
88
-
89
- - `{{SRC_DIR}}/path/to/file.{{FILE_EXTENSION}}`
90
- - `{{SRC_DIR}}/path/to/related.{{FILE_EXTENSION}}`
91
- - `{{TEST_DIR}}/path/to/test.{{FILE_EXTENSION}}`
92
-
93
- **Acceptance Criteria**:
94
-
95
- - [ ] All components implemented
96
- - [ ] Tests passing
97
- - [ ] No type/lint errors
98
-
99
- **Subtasks** (only if task > 8 hours):
100
-
101
- - [ ] Subtask 1
102
- - [ ] Subtask 2
103
- ```
104
-
105
- 4. **Task Ordering Rules**:
106
- - Setup before implementation
107
- - Tests before or alongside code (TDD)
108
- - Core before integration
109
- - Everything before polish
110
-
111
- 5. **Parallel Execution**:
112
- - Mark parallelizable tasks with `[P]`
113
- - Different feature areas = can be parallel
114
- - Same files = sequential
51
+ - [ ] T1 Schema + migration for sessions — PROJ-124
52
+ - [ ] T2 Login/logout endpoints [P]
53
+ - [ ] T3 Login form + error states [P]
54
+ ```
115
55
 
116
- 6. **Report Completion**:
117
- - Tasks file path
118
- - **Consolidated task count** (should be 3-7)
119
- - Estimated total effort
120
- - **Consolidation note**: "Combined X items into Y tasks"
121
- - Ready for `/implement` command
56
+ Each task is one line:
122
57
 
123
- ## Anti-Patterns to Avoid
58
+ - **Checkbox** `- [ ]`. Tick to `- [x]` once the task is implemented and reviewed.
59
+ - **ID** `T<n>`, sequential, in dependency order.
60
+ - **Description**: short and deliverable-focused (what ships, not how). No file lists, effort, or acceptance criteria.
61
+ - **`[P]`** only when the task can run in parallel (different files, no shared state). Omit otherwise.
62
+ - **` — <ticket key>`** appended after an em dash once a ticket exists. Written by `/assign-tasks`; never added before the ticket is created.
63
+ - **Sub-bullets** only when a task truly needs them (rare).
124
64
 
125
- ❌ **Don't create separate tasks for**:
65
+ Ordering: setup before implementation; tests before or alongside code (TDD); core before integration; polish last. Tasks that touch the same files run sequentially and are never `[P]`.
126
66
 
127
- - Each individual file
128
- - "Create X" then "Configure X" then "Test X"
129
- - Setup tasks under 1 hour
130
- - Each CRUD operation separately
67
+ ## Anti-Patterns
131
68
 
132
- ✅ **Do combine into single tasks**:
69
+ ❌ One task per file, per CRUD operation, or split into "Create X" / "Configure X" / "Test X"
70
+ ❌ Standalone setup tasks under 1 hour
133
71
 
134
- - All database work for an entity
135
- - All API endpoints for a resource
136
- - All configuration/setup work
137
- - Related service layer methods
72
+ ✅ All database work for an entity
73
+ ✅ All API endpoints for a resource
74
+ ✅ All configuration and setup for the feature
138
75
 
139
76
  ## Orchestrator Dispatch Guide
140
77
 
141
- When this task list is used by `/implement-feature` or `/implement`:
78
+ When this list is used by `/implement-feature` or `/implement`:
142
79
 
143
- - **Parallel [P] tasks**: Dispatch one subagent per `[P]` task concurrently using `dispatching-parallel-agents` skill
144
- - **Sequential tasks**: Execute in dependency order, one subagent per task using `subagent-driven-development` skill
145
- - **Domain routing**: Match each task to the appropriate specialist agent (Backend Architect, Frontend Developer, API Specialist, etc.)
146
- - **Review gate**: Every task must pass a Reviewer agent before being marked complete
80
+ - **`[P]` tasks**: dispatch one subagent per task concurrently, using `dispatching-parallel-agents`
81
+ - **Other tasks**: execute in dependency order, one subagent per task, using `subagent-driven-development`
82
+ - **Domain routing**: match each task to a specialist (Backend Architect, Frontend Developer, API Specialist, etc.)
83
+ - **Review gate**: every task passes a Reviewer before it is ticked `[x]`
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Decide whether a factory job is approved for merge or escalated to a human, checking history, final diff, a spot-checked criterion, a dry-run merge, and escalation triggers."
3
+ globs:
4
+ alwaysApply: agent
5
+ ---
6
+
7
+ # Factory Approver Agent
8
+
9
+ Decide whether a factory job is approved for merge or escalated to a human.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-approver.md](../../.claude/agents-snippets/factory-approver.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Build a factory job's feature inside its git worktree, following TDD, and log results in build.md."
3
+ globs:
4
+ alwaysApply: agent
5
+ ---
6
+
7
+ # Factory Builder Agent
8
+
9
+ Build a factory job's feature inside its git worktree, following TDD, and log results in build.md.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-builder.md](../../.claude/agents-snippets/factory-builder.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks."
3
+ globs:
4
+ alwaysApply: agent
5
+ ---
6
+
7
+ # Factory Reviewer (Code) Agent
8
+
9
+ Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-code.md](../../.claude/agents-snippets/factory-reviewer-code.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Audit a factory job's branch diff for security problems in a fresh context."
3
+ globs:
4
+ alwaysApply: agent
5
+ ---
6
+
7
+ # Factory Reviewer (Security) Agent
8
+
9
+ Audit a factory job's branch diff for security problems in a fresh context.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-security.md](../../.claude/agents-snippets/factory-reviewer-security.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services."
3
+ globs:
4
+ alwaysApply: agent
5
+ ---
6
+
7
+ # Factory Reviewer (UI) Agent
8
+
9
+ Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ui.md](../../.claude/agents-snippets/factory-reviewer-ui.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services."
3
+ globs:
4
+ alwaysApply: agent
5
+ ---
6
+
7
+ # Factory Reviewer (UX) Agent
8
+
9
+ Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ux.md](../../.claude/agents-snippets/factory-reviewer-ux.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Write a testable spec.md for a factory job from a feature request, after inspecting the real code."
3
+ globs:
4
+ alwaysApply: agent
5
+ ---
6
+
7
+ # Factory Spec Writer Agent
8
+
9
+ Write a testable spec.md for a factory job from a feature request, after inspecting the real code.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-spec-writer.md](../../.claude/agents-snippets/factory-spec-writer.md)
@@ -0,0 +1,24 @@
1
+ ---
2
+ description: "Run an opt-in factory job: intake, spec and plan gates, build in a worktree or in place, reviews, approval, local merge"
3
+ argument-hint: "[--in-place] <feature request> | start [--in-place] <request | KEY | slug | job-id> | approve <job-id> | rework <job-id> <note> | abandon <job-id> | status [--all] | watch [--all] | archive [--all] [--dry-run] | prune [--all] [--abandoned] [--dry-run]"
4
+ ---
5
+
6
+ # Factory
7
+
8
+ ## Agent Dispatch
9
+
10
+ > **Run in the main session.** The orchestrator dispatches these agents; they cannot dispatch others.
11
+
12
+ | Agent | When to use |
13
+ |-------|-------------|
14
+ | `factory-spec-writer` | Spec stage (`spec` mode) writes `spec.md`; plan stage (`plan` mode) writes `plan.md` and `tasks.md` |
15
+ | `factory-builder` | Build, repair, and rework: writes `build.md` in the job folder; its code goes in the build location |
16
+ | `factory-reviewer-code` | Review round, `code` lens |
17
+ | `factory-reviewer-security` | Review round, `security` lens |
18
+ | `factory-reviewer-ux` | Review round, `ux` lens (opt-in) |
19
+ | `factory-reviewer-ui` | Review round, `ui` lens (opt-in) |
20
+ | `factory-approver` | Approval gate: writes `decision.md` |
21
+
22
+ Dispatch each agent by its kebab-case name, as in the first column. Copilot may show a display name; pick the agent with that name.
23
+
24
+ **CRITICAL: READ:** [.claude/prompt-snippets/factory.md](../../.claude/prompt-snippets/factory.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: Factory Approver
3
+ description: "Decide whether a factory job is approved for merge or escalated to a human, checking history, final diff, a spot-checked criterion, a dry-run merge, and escalation triggers. Dispatched by the factory orchestrator."
4
+ tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
+ ---
6
+
7
+ # Factory Approver Agent
8
+
9
+ Decide whether a factory job is approved for merge or escalated to a human.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-approver.md](../../.claude/agents-snippets/factory-approver.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: Factory Builder
3
+ description: "Build a factory job's feature inside its git worktree, following TDD, and log results in build.md. Runs in build, repair, or rework mode. Dispatched by the factory orchestrator."
4
+ tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
+ ---
6
+
7
+ # Factory Builder Agent
8
+
9
+ Build a factory job's feature inside its git worktree, following TDD, and log results in build.md.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-builder.md](../../.claude/agents-snippets/factory-builder.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: Factory Reviewer Code
3
+ description: "Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks. Dispatched by the factory orchestrator."
4
+ tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
+ ---
6
+
7
+ # Factory Reviewer (Code) Agent
8
+
9
+ Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-code.md](../../.claude/agents-snippets/factory-reviewer-code.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: Factory Reviewer Security
3
+ description: "Audit a factory job's branch diff for security problems in a fresh context. Dispatched by the factory orchestrator."
4
+ tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
+ ---
6
+
7
+ # Factory Reviewer (Security) Agent
8
+
9
+ Audit a factory job's branch diff for security problems in a fresh context.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-security.md](../../.claude/agents-snippets/factory-reviewer-security.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: Factory Reviewer UI
3
+ description: "Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services. Dispatched by the factory orchestrator."
4
+ tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
+ ---
6
+
7
+ # Factory Reviewer (UI) Agent
8
+
9
+ Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ui.md](../../.claude/agents-snippets/factory-reviewer-ui.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: Factory Reviewer UX
3
+ description: "Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services. Dispatched by the factory orchestrator."
4
+ tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
+ ---
6
+
7
+ # Factory Reviewer (UX) Agent
8
+
9
+ Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ux.md](../../.claude/agents-snippets/factory-reviewer-ux.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: Factory Spec Writer
3
+ description: "Write a testable spec.md for a factory job from a feature request, after inspecting the real code. Dispatched by the factory orchestrator."
4
+ tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
+ ---
6
+
7
+ # Factory Spec Writer Agent
8
+
9
+ Write a testable spec.md for a factory job from a feature request, after inspecting the real code.
10
+
11
+ **CRITICAL: READ:** [.claude/agents-snippets/factory-spec-writer.md](../../.claude/agents-snippets/factory-spec-writer.md)
@@ -0,0 +1,25 @@
1
+ ---
2
+ description: "Run an opt-in factory job: intake, spec and plan gates, build in a worktree or in place, reviews, approval, local merge"
3
+ tools: ["agent", "edit", "search", "read", "runInTerminal", "terminalLastCommand"]
4
+ argument-hint: "[--in-place] <feature request> | start [--in-place] <request | KEY | slug | job-id> | approve <job-id> | rework <job-id> <note> | abandon <job-id> | status [--all] | watch [--all] | archive [--all] [--dry-run] | prune [--all] [--abandoned] [--dry-run]"
5
+ ---
6
+
7
+ # Factory
8
+
9
+ ## Agent Dispatch
10
+
11
+ > **Run in the main session.** The orchestrator dispatches these agents; they cannot dispatch others.
12
+
13
+ | Agent | When to use |
14
+ |-------|-------------|
15
+ | `factory-spec-writer` | Spec stage (`spec` mode) writes `spec.md`; plan stage (`plan` mode) writes `plan.md` and `tasks.md` |
16
+ | `factory-builder` | Build, repair, and rework: writes `build.md` in the job folder; its code goes in the build location |
17
+ | `factory-reviewer-code` | Review round, `code` lens |
18
+ | `factory-reviewer-security` | Review round, `security` lens |
19
+ | `factory-reviewer-ux` | Review round, `ux` lens (opt-in) |
20
+ | `factory-reviewer-ui` | Review round, `ui` lens (opt-in) |
21
+ | `factory-approver` | Approval gate: writes `decision.md` |
22
+
23
+ Dispatch each agent by its kebab-case name, as in the first column. Copilot may show a display name; pick the agent with that name.
24
+
25
+ **CRITICAL: READ:** [.claude/prompt-snippets/factory.md](../../.claude/prompt-snippets/factory.md).
@@ -1,10 +1,16 @@
1
1
  ---
2
2
  description: "Build administrator portals with RBAC, system dashboards, reporting, analytics, and operational tooling. Specializes in admin frameworks and monitoring ecosystem tools."
3
3
  mode: subagent
4
- temperature: 0.1
5
- permission:
6
- edit: allow
7
- bash: allow
4
+ request:
5
+ body:
6
+ temperature: 0.1
7
+ permissions:
8
+ - action: edit
9
+ resource: "*"
10
+ effect: allow
11
+ - action: shell
12
+ resource: "*"
13
+ effect: allow
8
14
  ---
9
15
 
10
16
  # Admin Portal Specialist
@@ -1,10 +1,16 @@
1
1
  ---
2
2
  description: "Design and implement API architecture, documentation, and developer experience. Use for REST design, GraphQL, OpenAPI specs, SDK generation, API versioning, and integration patterns."
3
3
  mode: subagent
4
- temperature: 0.1
5
- permission:
6
- edit: allow
7
- bash: allow
4
+ request:
5
+ body:
6
+ temperature: 0.1
7
+ permissions:
8
+ - action: edit
9
+ resource: "*"
10
+ effect: allow
11
+ - action: shell
12
+ resource: "*"
13
+ effect: allow
8
14
  ---
9
15
 
10
16
  # API Specialist
@@ -1,10 +1,16 @@
1
1
  ---
2
2
  description: "Design APIs, databases, and server-side architecture. Use for scalable backend systems, data modeling, caching strategies, system design, and infrastructure decisions."
3
3
  mode: subagent
4
- temperature: 0.1
5
- permission:
6
- edit: allow
7
- bash: allow
4
+ request:
5
+ body:
6
+ temperature: 0.1
7
+ permissions:
8
+ - action: edit
9
+ resource: "*"
10
+ effect: allow
11
+ - action: shell
12
+ resource: "*"
13
+ effect: allow
8
14
  ---
9
15
 
10
16
  # Backend Architect
@@ -1,10 +1,16 @@
1
1
  ---
2
2
  description: "Analyze codebases and create comprehensive documentation. Use for AGENTS.md, README files, API docs, architecture documentation, and onboarding guides."
3
3
  mode: subagent
4
- temperature: 0.1
5
- permission:
6
- edit: allow
7
- bash: allow
4
+ request:
5
+ body:
6
+ temperature: 0.1
7
+ permissions:
8
+ - action: edit
9
+ resource: "*"
10
+ effect: allow
11
+ - action: shell
12
+ resource: "*"
13
+ effect: allow
8
14
  ---
9
15
 
10
16
  # Documenter
@@ -0,0 +1,20 @@
1
+ ---
2
+ description: "Decide whether a factory job is approved for merge or escalated to a human, checking history, final diff, a spot-checked criterion, a dry-run merge, and escalation triggers. Dispatched by the factory orchestrator."
3
+ mode: subagent
4
+ request:
5
+ body:
6
+ temperature: 0.1
7
+ permissions:
8
+ - action: edit
9
+ resource: "*"
10
+ effect: allow
11
+ - action: shell
12
+ resource: "*"
13
+ effect: allow
14
+ ---
15
+
16
+ # Factory Approver Agent
17
+
18
+ Decide whether a factory job is approved for merge or escalated to a human.
19
+
20
+ @.claude/agents-snippets/factory-approver.md
@@ -0,0 +1,20 @@
1
+ ---
2
+ description: "Build a factory job's feature inside its git worktree, following TDD, and log results in build.md. Runs in build, repair, or rework mode. Dispatched by the factory orchestrator."
3
+ mode: subagent
4
+ request:
5
+ body:
6
+ temperature: 0.1
7
+ permissions:
8
+ - action: edit
9
+ resource: "*"
10
+ effect: allow
11
+ - action: shell
12
+ resource: "*"
13
+ effect: allow
14
+ ---
15
+
16
+ # Factory Builder Agent
17
+
18
+ Build a factory job's feature inside its git worktree, following TDD, and log results in build.md.
19
+
20
+ @.claude/agents-snippets/factory-builder.md
@@ -0,0 +1,20 @@
1
+ ---
2
+ description: "Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks. Dispatched by the factory orchestrator."
3
+ mode: subagent
4
+ request:
5
+ body:
6
+ temperature: 0.1
7
+ permissions:
8
+ - action: edit
9
+ resource: "*"
10
+ effect: allow
11
+ - action: shell
12
+ resource: "*"
13
+ effect: allow
14
+ ---
15
+
16
+ # Factory Reviewer (Code) Agent
17
+
18
+ Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks.
19
+
20
+ @.claude/agents-snippets/factory-reviewer-code.md
@@ -0,0 +1,20 @@
1
+ ---
2
+ description: "Audit a factory job's branch diff for security problems in a fresh context. Dispatched by the factory orchestrator."
3
+ mode: subagent
4
+ request:
5
+ body:
6
+ temperature: 0.1
7
+ permissions:
8
+ - action: edit
9
+ resource: "*"
10
+ effect: allow
11
+ - action: shell
12
+ resource: "*"
13
+ effect: allow
14
+ ---
15
+
16
+ # Factory Reviewer (Security) Agent
17
+
18
+ Audit a factory job's branch diff for security problems in a fresh context.
19
+
20
+ @.claude/agents-snippets/factory-reviewer-security.md
@@ -0,0 +1,20 @@
1
+ ---
2
+ description: "Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services. Dispatched by the factory orchestrator."
3
+ mode: subagent
4
+ request:
5
+ body:
6
+ temperature: 0.1
7
+ permissions:
8
+ - action: edit
9
+ resource: "*"
10
+ effect: allow
11
+ - action: shell
12
+ resource: "*"
13
+ effect: allow
14
+ ---
15
+
16
+ # Factory Reviewer (UI) Agent
17
+
18
+ Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services.
19
+
20
+ @.claude/agents-snippets/factory-reviewer-ui.md
@@ -0,0 +1,20 @@
1
+ ---
2
+ description: "Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services. Dispatched by the factory orchestrator."
3
+ mode: subagent
4
+ request:
5
+ body:
6
+ temperature: 0.1
7
+ permissions:
8
+ - action: edit
9
+ resource: "*"
10
+ effect: allow
11
+ - action: shell
12
+ resource: "*"
13
+ effect: allow
14
+ ---
15
+
16
+ # Factory Reviewer (UX) Agent
17
+
18
+ Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services.
19
+
20
+ @.claude/agents-snippets/factory-reviewer-ux.md