nitm-ai-dev-toolkit 3.0.23 → 5.0.0

package/src/monorepo/.claude/prompt-snippets/tasks.md

@@ -1,5 +1,7 @@
 You are helping to break down a feature into actionable tasks.
 
+`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.
+
 ## Your Task
 
 1. **Load context**:
@@ -7,102 +9,62 @@ You are helping to break down a feature into actionable tasks.
    - Read the plan in `apps/{{APP_NAME}}/docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/plan.md` (if exists)
    - Review `AGENTS.md` for project patterns
 
-2. **Break down into tasks** (aim for 3-7 total tasks):
-   - **Setup**: Dependencies, configuration, scaffolding (combine into 1 task)
-   - **Core**: Main implementation tasks (group by component/feature area)
-   - **Tests**: Unit and integration tests (1 task per component)
-   - **Polish**: Documentation, cleanup, optimization (combine into 1 task)
-
-3. **Task Consolidation Rules** (CRITICAL):
-   - **Group related work**: Combine tasks that touch the same files or feature area
-   - **Merge small tasks**: Tasks under 2 hours should be combined with related work
-   - **Limit total tasks**: Target 3-7 tasks total; never exceed 10 for any feature
-   - **Avoid over-granularity**: "Create model + migration + factory" = 1 task, not 3
-   - **Bundle by outcome**: Group by what gets delivered, not individual steps
-
-4. **Complexity-Based Task Sizing**:
-
-   | Complexity          | Task Count | Subtask Limit     |
-   | ------------------- | ---------- | ----------------- |
-   | Simple (< 4 hours)  | 2-3 tasks  | 0 subtasks        |
-   | Medium (4-16 hours) | 3-5 tasks  | 2-4 per task max  |
-   | Complex (16-40 hrs) | 5-8 tasks  | 3-6 per task max  |
-   | Large (40+ hours)   | 8-12 tasks | 5-10 per task max |
-
-5. **Task ordering rules**:
+2. **Break down into tasks** (aim for 3-7 total; never exceed 10):
+   - **Setup**: dependencies, configuration, scaffolding (combine into 1 task)
+   - **Core**: main implementation, grouped by component or feature area
+   - **Tests**: unit and integration tests (1 task per component)
+   - **Polish**: documentation, cleanup, optimization (combine into 1 task)
+
+3. **Consolidation rules** (CRITICAL):
+   - **Group related work**: combine tasks that touch the same files or feature area
+   - **Merge small tasks**: anything under 2 hours folds into related work
+   - **Bundle by outcome**: group by what gets delivered, not individual steps
+   - **Keep each task inside one app**. Cross-app work: shared package task first, then app tasks
+
+4. **Create the task list** at `apps/{{APP_NAME}}/docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/tasks.md`:
+
+   ```markdown
+   # Tasks: {{ISSUE_ID}}-{{FEATURE_NAME}}
+
+   - [ ] T1 Setup: dependencies and configuration
+   - [ ] T2 Models, services, and endpoints for sessions
+   - [ ] T3 Session tests [P]
+   - [ ] T4 Docs and cleanup
+   ```
+
+   Each task is one line:
+   - **Checkbox** `- [ ]`. Tick to `- [x]` once the task is implemented and reviewed.
+   - **ID** `T<n>`, sequential, in dependency order.
+   - **Description**: short and deliverable-focused (what ships, not how). No file lists, effort, or acceptance criteria.
+   - **`[P]`** only when the task can run in parallel (different files, no shared state). Omit otherwise.
+   - **` — <ticket key>`** appended after an em dash once a ticket exists. Written by `/assign-tasks`; never added before the ticket is created.
+   - **Sub-bullets** only when a task truly needs them (rare).
+
+5. **Task ordering**:
    - Setup before implementation
    - Tests before or alongside code (TDD)
    - Core features before integrations
-   - Mark parallelizable tasks with [P]
-
-6. **Create task list**:
-   - Output to `apps/{{APP_NAME}}/docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/tasks.md`
-   - Each task should be specific and actionable
-   - Include file paths where relevant
-
-## Task Template
-
-```markdown
-# Tasks: {{FEATURE_NAME}}
-
-**Complexity**: Simple | Medium | Complex
-**Estimated Total**: X hours
-**Task Count**: X tasks
-
-## T001: Setup & Configuration
-
-- Install dependencies and configure environment
-- Create file structure and scaffolding
-- **Files**: `package.json`, `{{CONFIG_DIR}}/*`
-
-## T002: Core Implementation - [Feature Area]
+   - Polish last
+   - Tasks touching the same files run sequentially and are never `[P]`
 
-- Implement [feature part] including models, services, and controllers
-- **Files**: `{{SRC_DIR}}/models/*`, `{{SRC_DIR}}/services/*`
-- **Subtasks** (only if complex):
-  - Model and database layer
-  - Business logic and services
-  - API/Controller layer
-
-## T003 [P]: Testing
-
-- Add unit and integration tests for all components
-- **Files**: `{{TEST_DIR}}/*`
-
-## T004: Polish & Documentation
-
-- Update documentation, error handling, and cleanup
-- **Files**: `README.md`, `docs/*`
-```
+6. **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.
 
 ## Anti-Patterns to Avoid
 
-❌ **Don't create separate tasks for**:
-
-- Each individual file in a feature
-- "Create X" then "Configure X" then "Test X" (combine them)
-- Minor changes that take < 30 minutes
-- Obvious steps like "commit code" or "run linter"
-
-✅ **Do combine into single tasks**:
-
-- All model/migration/factory work for an entity
-- Related API endpoints that share logic
-- All configuration and environment setup
-- Documentation updates across multiple files
-
-## Notes
+❌ One task per file in a feature
+❌ "Create X" then "Configure X" then "Test X"
+❌ Minor changes under 30 minutes, or obvious steps like "commit code" or "run linter"
 
-- [P] indicates tasks that can run in parallel
-- Tasks affecting the same file should be sequential
-- Each task should be completable independently
-- **Quality over quantity**: Fewer, well-defined tasks beat many granular ones
+✅ All model, migration, and factory work for an entity
+✅ Related API endpoints that share logic
+✅ All configuration and environment setup
+✅ Documentation updates across multiple files
 
 ## Orchestrator Dispatch Guide
 
-When this task list is used by `/implement-feature` or `/implement`:
+When this list is used by `/implement-feature` or `/implement`:
 
-- **Parallel [P] tasks**: Dispatch one subagent per `[P]` task concurrently using `dispatching-parallel-agents` skill
-- **Sequential tasks**: Execute in dependency order, one subagent per task using `subagent-driven-development` skill
-- **Domain routing**: Match each task to the appropriate specialist agent (Backend Architect, Frontend Developer, API Specialist, etc.)
-- **Review gate**: Every task must pass a Reviewer agent before being marked complete
+- **`[P]` tasks**: dispatch one subagent per task concurrently, using `dispatching-parallel-agents`
+- **Other tasks**: execute in dependency order, one subagent per task, using `subagent-driven-development`
+- **Domain routing**: match each task to a specialist (Backend Architect, Frontend Developer, API Specialist, etc.)
+- **Review gate**: every task passes a Reviewer before it is ticked `[x]`

package/src/monorepo/.claude/rules-snippets/documentation.md

@@ -8,13 +8,15 @@ This monorepo uses a **distributed documentation strategy** where app-specific d
 
 **App-specific documentation** must live in respective app folders:
 
-- **{{APP_1}} Features** → `apps/{{APP_1}}/docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/`
-- **{{APP_2}} Features** → `apps/{{APP_2}}/docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/`
+- **{{APP_1}} Features** → `apps/{{APP_1}}/docs/features/<feature>/`
+- **{{APP_2}} Features** → `apps/{{APP_2}}/docs/features/<feature>/`
 - **{{APP_1}} Fixes** → `apps/{{APP_1}}/docs/fixes/`
 - **{{APP_2}} Fixes** → `apps/{{APP_2}}/docs/fixes/`
 - **Shared Package Features** → `packages/{{PACKAGE_NAME}}/docs/features/`
 - **Shared Package Fixes** → `packages/{{PACKAGE_NAME}}/docs/fixes/`
 
+**Factory features are root-scoped.** The factory pipeline runs from the monorepo root, so features it runs live at root `docs/features/<feature>/` (for example `docs/features/PROJ-1234-onboarding/`). Other features stay in their app or package folder as listed above. `<feature>` is the per-run feature folder name: `<KEY>-<slug>`, or `<slug>` when there is no ticket.
+
 **Root `docs/` folder** is ONLY for monorepo-wide documentation:
 
 - Architecture decisions affecting multiple apps (`docs/architecture/`)
@@ -81,12 +83,12 @@ If the monorepo includes a documentation app (e.g., Docus, Nuxt Content, Docusau
 
 Each app maintains its own feature documentation:
 
-**Location:** `apps/{{APP_NAME}}/docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/`
+**Location:** `apps/{{APP_NAME}}/docs/features/<feature>/`
 
 **Required Files:**
 
 ```
-apps/{{APP_1}}/docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/
+apps/{{APP_1}}/docs/features/<feature>/
 ├── spec.md       # Functional specification
 ├── plan.md       # Implementation plan
 └── [optional]    # Code examples, component diagrams
@@ -160,8 +162,8 @@ Before running `git commit`, verify ALL items that apply to your change:
 
 **All changes:**
 
-- [ ] **Features**: `docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/spec.md` exists and reflects the current implementation
-- [ ] **Features**: `docs/features/{{ISSUE_ID}}-{{FEATURE_NAME}}/plan.md` is updated if scope changed
+- [ ] **Features**: `docs/features/<feature>/spec.md` exists and reflects the current implementation
+- [ ] **Features**: `docs/features/<feature>/plan.md` is updated if scope changed
 - [ ] **Fixes**: Entry added to `apps/{{APP_NAME}}/docs/fixes/{{YYYY-MM}}.md` (or complex fix folder created)
 - [ ] **Breaking changes**: `CHANGELOG.md` updated
 - [ ] **Architectural decisions**: ADR created in `docs/architecture/` if a significant choice was made

package/src/monorepo/.cursor/agents/factory-approver.agent.md

@@ -0,0 +1,11 @@
+---
+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."
+globs:
+alwaysApply: agent
+---
+
+# Factory Approver Agent
+
+Decide whether a factory job is approved for merge or escalated to a human.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-approver.md](../../.claude/agents-snippets/factory-approver.md)

package/src/monorepo/.cursor/agents/factory-builder.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Build a factory job's feature inside its git worktree, following TDD, and log results in build.md."
+globs:
+alwaysApply: agent
+---
+
+# Factory Builder Agent
+
+Build a factory job's feature inside its git worktree, following TDD, and log results in build.md.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-builder.md](../../.claude/agents-snippets/factory-builder.md)

package/src/monorepo/.cursor/agents/factory-reviewer-code.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks."
+globs:
+alwaysApply: agent
+---
+
+# Factory Reviewer (Code) Agent
+
+Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-code.md](../../.claude/agents-snippets/factory-reviewer-code.md)

package/src/monorepo/.cursor/agents/factory-reviewer-security.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Audit a factory job's branch diff for security problems in a fresh context."
+globs:
+alwaysApply: agent
+---
+
+# Factory Reviewer (Security) Agent
+
+Audit a factory job's branch diff for security problems in a fresh context.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-security.md](../../.claude/agents-snippets/factory-reviewer-security.md)

package/src/monorepo/.cursor/agents/factory-reviewer-ui.agent.md

@@ -0,0 +1,11 @@
+---
+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."
+globs:
+alwaysApply: agent
+---
+
+# Factory Reviewer (UI) Agent
+
+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.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ui.md](../../.claude/agents-snippets/factory-reviewer-ui.md)

package/src/monorepo/.cursor/agents/factory-reviewer-ux.agent.md

@@ -0,0 +1,11 @@
+---
+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."
+globs:
+alwaysApply: agent
+---
+
+# Factory Reviewer (UX) Agent
+
+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.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ux.md](../../.claude/agents-snippets/factory-reviewer-ux.md)

package/src/monorepo/.cursor/agents/factory-spec-writer.agent.md

@@ -0,0 +1,11 @@
+---
+description: "Write a testable spec.md for a factory job from a feature request, after inspecting the real code."
+globs:
+alwaysApply: agent
+---
+
+# Factory Spec Writer Agent
+
+Write a testable spec.md for a factory job from a feature request, after inspecting the real code.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-spec-writer.md](../../.claude/agents-snippets/factory-spec-writer.md)

package/src/monorepo/.cursor/commands/factory.md

@@ -0,0 +1,24 @@
+---
+description: "Run an opt-in factory job: intake, spec and plan gates, build in a worktree or in place, reviews, approval, local merge"
+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]"
+---
+
+# Factory
+
+## Agent Dispatch
+
+> **Run in the main session.** The orchestrator dispatches these agents; they cannot dispatch others.
+
+| Agent | When to use |
+|-------|-------------|
+| `factory-spec-writer` | Spec stage (`spec` mode) writes `spec.md`; plan stage (`plan` mode) writes `plan.md` and `tasks.md` |
+| `factory-builder` | Build, repair, and rework: writes `build.md` in the job folder; its code goes in the build location |
+| `factory-reviewer-code` | Review round, `code` lens |
+| `factory-reviewer-security` | Review round, `security` lens |
+| `factory-reviewer-ux` | Review round, `ux` lens (opt-in) |
+| `factory-reviewer-ui` | Review round, `ui` lens (opt-in) |
+| `factory-approver` | Approval gate: writes `decision.md` |
+
+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.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/factory.md](../../.claude/prompt-snippets/factory.md)

package/src/monorepo/.github/agents/factory-approver.agent.md

@@ -0,0 +1,11 @@
+---
+name: Factory Approver
+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."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Factory Approver Agent
+
+Decide whether a factory job is approved for merge or escalated to a human.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-approver.md](../../.claude/agents-snippets/factory-approver.md)

package/src/monorepo/.github/agents/factory-builder.agent.md

@@ -0,0 +1,11 @@
+---
+name: Factory Builder
+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."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Factory Builder Agent
+
+Build a factory job's feature inside its git worktree, following TDD, and log results in build.md.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-builder.md](../../.claude/agents-snippets/factory-builder.md)

package/src/monorepo/.github/agents/factory-reviewer-code.agent.md

@@ -0,0 +1,11 @@
+---
+name: Factory Reviewer Code
+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."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Factory Reviewer (Code) Agent
+
+Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-code.md](../../.claude/agents-snippets/factory-reviewer-code.md)

package/src/monorepo/.github/agents/factory-reviewer-security.agent.md

@@ -0,0 +1,11 @@
+---
+name: Factory Reviewer Security
+description: "Audit a factory job's branch diff for security problems in a fresh context. Dispatched by the factory orchestrator."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Factory Reviewer (Security) Agent
+
+Audit a factory job's branch diff for security problems in a fresh context.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-security.md](../../.claude/agents-snippets/factory-reviewer-security.md)

package/src/monorepo/.github/agents/factory-reviewer-ui.agent.md

@@ -0,0 +1,11 @@
+---
+name: Factory Reviewer UI
+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."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Factory Reviewer (UI) Agent
+
+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.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ui.md](../../.claude/agents-snippets/factory-reviewer-ui.md)

package/src/monorepo/.github/agents/factory-reviewer-ux.agent.md

@@ -0,0 +1,11 @@
+---
+name: Factory Reviewer UX
+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."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Factory Reviewer (UX) Agent
+
+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.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ux.md](../../.claude/agents-snippets/factory-reviewer-ux.md)

package/src/monorepo/.github/agents/factory-spec-writer.agent.md

@@ -0,0 +1,11 @@
+---
+name: Factory Spec Writer
+description: "Write a testable spec.md for a factory job from a feature request, after inspecting the real code. Dispatched by the factory orchestrator."
+tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
+---
+
+# Factory Spec Writer Agent
+
+Write a testable spec.md for a factory job from a feature request, after inspecting the real code.
+
+**CRITICAL: READ:** [.claude/agents-snippets/factory-spec-writer.md](../../.claude/agents-snippets/factory-spec-writer.md)

package/src/monorepo/.github/prompts/factory.prompt.md

@@ -0,0 +1,25 @@
+---
+description: "Run an opt-in factory job: intake, spec and plan gates, build in a worktree or in place, reviews, approval, local merge"
+tools: ["agent", "edit", "search", "read", "runInTerminal", "terminalLastCommand"]
+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]"
+---
+
+# Factory
+
+## Agent Dispatch
+
+> **Run in the main session.** The orchestrator dispatches these agents; they cannot dispatch others.
+
+| Agent | When to use |
+|-------|-------------|
+| `factory-spec-writer` | Spec stage (`spec` mode) writes `spec.md`; plan stage (`plan` mode) writes `plan.md` and `tasks.md` |
+| `factory-builder` | Build, repair, and rework: writes `build.md` in the job folder; its code goes in the build location |
+| `factory-reviewer-code` | Review round, `code` lens |
+| `factory-reviewer-security` | Review round, `security` lens |
+| `factory-reviewer-ux` | Review round, `ux` lens (opt-in) |
+| `factory-reviewer-ui` | Review round, `ui` lens (opt-in) |
+| `factory-approver` | Approval gate: writes `decision.md` |
+
+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.
+
+**CRITICAL: READ:** [.claude/prompt-snippets/factory.md](../../.claude/prompt-snippets/factory.md).

package/src/monorepo/.github/prompts/review-staged.prompt.md

@@ -1,5 +1,5 @@
 ---
-description: Review currently staged files before committing
+description: Review staged files with detailed code review
 tools: ["read", "search"]
 argument-hint: "no arguments required"
 ---

package/src/monorepo/.opencode/agents/admin-portal.md

@@ -1,10 +1,16 @@
 ---
 description: "Build administrator portals with RBAC, system dashboards, reporting, analytics, and operational tooling. Specializes in admin frameworks and monitoring ecosystem tools."
 mode: subagent
-temperature: 0.1
-permission:
-  edit: allow
-  bash: allow
+request:
+  body:
+    temperature: 0.1
+permissions:
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: shell
+    resource: "*"
+    effect: allow
 ---
 
 # Admin Portal Specialist

package/src/monorepo/.opencode/agents/api-specialist.md

@@ -1,10 +1,16 @@
 ---
 description: "Design and implement API architecture, documentation, and developer experience. Use for REST design, GraphQL, OpenAPI specs, SDK generation, API versioning, and integration patterns."
 mode: subagent
-temperature: 0.1
-permission:
-  edit: allow
-  bash: allow
+request:
+  body:
+    temperature: 0.1
+permissions:
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: shell
+    resource: "*"
+    effect: allow
 ---
 
 # API Specialist

package/src/monorepo/.opencode/agents/backend-architect.md

@@ -1,10 +1,16 @@
 ---
 description: "Design APIs, databases, and server-side architecture. Use for scalable backend systems, data modeling, caching strategies, system design, and infrastructure decisions."
 mode: subagent
-temperature: 0.1
-permission:
-  edit: allow
-  bash: allow
+request:
+  body:
+    temperature: 0.1
+permissions:
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: shell
+    resource: "*"
+    effect: allow
 ---
 
 # Backend Architect

package/src/monorepo/.opencode/agents/documenter.md

@@ -1,10 +1,16 @@
 ---
 description: "Analyze codebases and create comprehensive documentation. Use for AGENTS.md, README files, API docs, architecture documentation, and onboarding guides."
 mode: subagent
-temperature: 0.1
-permission:
-  edit: allow
-  bash: allow
+request:
+  body:
+    temperature: 0.1
+permissions:
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: shell
+    resource: "*"
+    effect: allow
 ---
 
 # Documenter

package/src/monorepo/.opencode/agents/factory-approver.md

@@ -0,0 +1,20 @@
+---
+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."
+mode: subagent
+request:
+  body:
+    temperature: 0.1
+permissions:
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: shell
+    resource: "*"
+    effect: allow
+---
+
+# Factory Approver Agent
+
+Decide whether a factory job is approved for merge or escalated to a human.
+
+@.claude/agents-snippets/factory-approver.md

package/src/monorepo/.opencode/agents/factory-builder.md

@@ -0,0 +1,20 @@
+---
+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."
+mode: subagent
+request:
+  body:
+    temperature: 0.1
+permissions:
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: shell
+    resource: "*"
+    effect: allow
+---
+
+# Factory Builder Agent
+
+Build a factory job's feature inside its git worktree, following TDD, and log results in build.md.
+
+@.claude/agents-snippets/factory-builder.md

package/src/monorepo/.opencode/agents/factory-reviewer-code.md

@@ -0,0 +1,20 @@
+---
+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."
+mode: subagent
+request:
+  body:
+    temperature: 0.1
+permissions:
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: shell
+    resource: "*"
+    effect: allow
+---
+
+# Factory Reviewer (Code) Agent
+
+Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks.
+
+@.claude/agents-snippets/factory-reviewer-code.md

package/src/monorepo/.opencode/agents/factory-reviewer-security.md

@@ -0,0 +1,20 @@
+---
+description: "Audit a factory job's branch diff for security problems in a fresh context. Dispatched by the factory orchestrator."
+mode: subagent
+request:
+  body:
+    temperature: 0.1
+permissions:
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: shell
+    resource: "*"
+    effect: allow
+---
+
+# Factory Reviewer (Security) Agent
+
+Audit a factory job's branch diff for security problems in a fresh context.
+
+@.claude/agents-snippets/factory-reviewer-security.md

package/src/monorepo/.opencode/agents/factory-reviewer-ui.md

@@ -0,0 +1,20 @@
+---
+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."
+mode: subagent
+request:
+  body:
+    temperature: 0.1
+permissions:
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: shell
+    resource: "*"
+    effect: allow
+---
+
+# Factory Reviewer (UI) Agent
+
+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.
+
+@.claude/agents-snippets/factory-reviewer-ui.md