@syntesseraai/opencode-feature-factory 0.6.0 → 0.6.2

package/README.md

@@ -46,6 +46,18 @@ This will:
 - **`@ff-acceptance`** - Binary pass/fail validation against acceptance criteria.
 - **`@ff-well-architected`** - Reviews code against AWS Well-Architected Framework pillars.
 
+### Pipeline Model Split
+
+The package also includes a multi-model pipeline orchestrator defined in `agents/pipeline.md`.
+
+For the building phase of that pipeline:
+
+- **`ff-building-opus`** - breaks the approved plan into atomic tasks
+- **`ff-building-gemini`** - validates architecture and enriches each task with codebase context
+- **`ff-building-chatgpt`** - implements validated tasks and handles rework loops
+
+See the repository workflow doc at `docs/PIPELINE_ORCHESTRATION.md` for the end-to-end three-phase workflow: https://github.com/SyntesseraAI/feature-factory/blob/main/docs/PIPELINE_ORCHESTRATION.md
+
 ## Behavior
 
 - **Manual install**: Agents and skills are installed via the `npx install` command, not automatically

package/agents/building.md

@@ -283,17 +283,17 @@ ALWAYS prefer delegation. Parallelize these tasks:
 
 While you implement, delegate:
 
-- **@ff-unit-test** - "Generate unit tests for [feature]. Write context to .feature-factory/agents/ff-unit-test-{UUID}.md"
-- **@ff-e2e-test** - "Create E2E tests for [workflow]. Write context to .feature-factory/agents/ff-e2e-test-{UUID}.md"
-- **@ff-research** - "Research edge cases for [technology]. Write context to .feature-factory/agents/ff-research-{UUID}.md"
+- **@ff-unit-test** - "Generate unit tests for [feature]. Save context via `ff-agents-update` as `ff-unit-test-{UUID}.md`."
+- **@ff-e2e-test** - "Create E2E tests for [workflow]. Save context via `ff-agents-update` as `ff-e2e-test-{UUID}.md`."
+- **@ff-research** - "Research edge cases for [technology]. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
 
 ### Post-Implementation (Parallel)
 
 After implementation, delegate:
 
-- **@reviewing** - "Comprehensive validation. Write context to .feature-factory/agents/reviewing-{UUID}.md"
-- **@ff-security** - "Security audit. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-- **@ff-well-architected** - "Architecture review. Write context to .feature-factory/agents/ff-well-architected-{UUID}.md"
+- **@reviewing** - "Comprehensive validation. Save context via `ff-agents-update` as `reviewing-{UUID}.md`."
+- **@ff-security** - "Security audit. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+- **@ff-well-architected** - "Architecture review. Save context via `ff-agents-update` as `ff-well-architected-{UUID}.md`."
 
 ### Delegation Process
 
@@ -496,18 +496,18 @@ Use ff-severity-classification when making changes:
 7. **Load or create** implementation plan (use `ff-plans-get` to read existing plans)
 8. **Create todo list** for execution
 9. **Delegate in parallel** (while implementing):
-   - Task(ff-unit-test): "Generate unit tests. Write context to .feature-factory/agents/ff-unit-test-{UUID}.md"
-   - Task(ff-e2e-test): "Create E2E tests. Write context to .feature-factory/agents/ff-e2e-test-{UUID}.md"
-   - Task(ff-research): "Research edge cases. Write context to .feature-factory/agents/ff-research-{UUID}.md"
+   - Task(ff-unit-test): "Generate unit tests. Save context via `ff-agents-update` as `ff-unit-test-{UUID}.md`."
+   - Task(ff-e2e-test): "Create E2E tests. Save context via `ff-agents-update` as `ff-e2e-test-{UUID}.md`."
+   - Task(ff-research): "Research edge cases. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
 10. **Execute implementation** steps
 11. **Run quality checks** (lint, typecheck, tests)
 12. **Self-assess** changes using ff-severity-classification
 13. **Monitor delegated work** - `ff-agents-current()`
 14. **Read test results** from delegated agents using `ff-agents-get` or `ff-agents-show`
 15. **Delegate validation** in parallel:
-    - Task(reviewing): "Comprehensive validation. Write context to .feature-factory/agents/reviewing-{UUID}.md"
-    - Task(ff-security): "Security audit. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-    - Task(ff-well-architected): "Architecture review. Write context to .feature-factory/agents/ff-well-architected-{UUID}.md"
+    - Task(reviewing): "Comprehensive validation. Save context via `ff-agents-update` as `reviewing-{UUID}.md`."
+    - Task(ff-security): "Security audit. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+    - Task(ff-well-architected): "Architecture review. Save context via `ff-agents-update` as `ff-well-architected-{UUID}.md`."
 16. **Read validation results** using `ff-agents-get` or `ff-agents-show`
 17. **Address findings** from all validation agents
 18. **Iterate** until validation passes

package/agents/ff-building-chatgpt.md

@@ -160,13 +160,13 @@ ALWAYS prefer delegation. Parallelize these tasks:
 
 ### During Implementation (Parallel)
 
-- **@ff-research** - "Research edge cases for [technology]. Write context to .feature-factory/agents/ff-research-{UUID}.md"
+- **@ff-research** - "Research edge cases for [technology]. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
 
 ### Post-Implementation (Parallel)
 
-- **@reviewing** - "Comprehensive validation. Write context to .feature-factory/agents/reviewing-{UUID}.md"
-- **@ff-security** - "Security audit. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-- **@ff-well-architected** - "Architecture review. Write context to .feature-factory/agents/ff-well-architected-{UUID}.md"
+- **@reviewing** - "Comprehensive validation. Save context via `ff-agents-update` as `reviewing-{UUID}.md`."
+- **@ff-security** - "Security audit. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+- **@ff-well-architected** - "Architecture review. Save context via `ff-agents-update` as `ff-well-architected-{UUID}.md`."
 
 ## Building Process
 

package/agents/ff-building-gemini.md

@@ -160,13 +160,13 @@ ALWAYS prefer delegation. Parallelize these tasks:
 
 ### During Implementation (Parallel)
 
-- **@ff-research** - "Research edge cases for [technology]. Write context to .feature-factory/agents/ff-research-{UUID}.md"
+- **@ff-research** - "Research edge cases for [technology]. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
 
 ### Post-Implementation (Parallel)
 
-- **@reviewing** - "Comprehensive validation. Write context to .feature-factory/agents/reviewing-{UUID}.md"
-- **@ff-security** - "Security audit. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-- **@ff-well-architected** - "Architecture review. Write context to .feature-factory/agents/ff-well-architected-{UUID}.md"
+- **@reviewing** - "Comprehensive validation. Save context via `ff-agents-update` as `reviewing-{UUID}.md`."
+- **@ff-security** - "Security audit. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+- **@ff-well-architected** - "Architecture review. Save context via `ff-agents-update` as `ff-well-architected-{UUID}.md`."
 
 ## Building Process
 

package/agents/ff-building-opus.md

@@ -160,13 +160,13 @@ ALWAYS prefer delegation. Parallelize these tasks:
 
 ### During Implementation (Parallel)
 
-- **@ff-research** - "Research edge cases for [technology]. Write context to .feature-factory/agents/ff-research-{UUID}.md"
+- **@ff-research** - "Research edge cases for [technology]. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
 
 ### Post-Implementation (Parallel)
 
-- **@reviewing** - "Comprehensive validation. Write context to .feature-factory/agents/reviewing-{UUID}.md"
-- **@ff-security** - "Security audit. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-- **@ff-well-architected** - "Architecture review. Write context to .feature-factory/agents/ff-well-architected-{UUID}.md"
+- **@reviewing** - "Comprehensive validation. Save context via `ff-agents-update` as `reviewing-{UUID}.md`."
+- **@ff-security** - "Security audit. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+- **@ff-well-architected** - "Architecture review. Save context via `ff-agents-update` as `ff-well-architected-{UUID}.md`."
 
 ## Building Process
 

package/agents/ff-planning-chatgpt.md

@@ -175,10 +175,10 @@ ALWAYS prefer delegation. Parallelize these tasks:
 
 Delegate these simultaneously at the start:
 
-- **@ff-research** - "Research best practices for [technology]. Write context to .feature-factory/agents/ff-research-{UUID}.md"
-- **@ff-acceptance** - "Validate acceptance criteria. Write context to .feature-factory/agents/ff-acceptance-{UUID}.md"
-- **@ff-security** - "Threat model for [feature]. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-- **@explore** - "Explore codebase for similar patterns. Write context to .feature-factory/agents/explore-{UUID}.md"
+- **@ff-research** - "Research best practices for [technology]. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
+- **@ff-acceptance** - "Validate acceptance criteria. Save context via `ff-agents-update` as `ff-acceptance-{UUID}.md`."
+- **@ff-security** - "Threat model for [feature]. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+- **@explore** - "Explore codebase for similar patterns. Save context via `ff-agents-update` as `explore-{UUID}.md`."
 
 ### Delegation Process
 
@@ -299,10 +299,10 @@ Use ff-report-templates skill for Mini Plan format:
 6. **Load required skills** (ff-delegation, ff-mini-plan, ff-todo-management, ff-report-templates)
 7. **Document context** - Use `ff-agents-update` tool to create `.feature-factory/agents/ff-planning-chatgpt-{UUID}.md`
 8. **Delegate in parallel**:
-   - Task(ff-research): "Research [technology] best practices. Write context to .feature-factory/agents/ff-research-{UUID}.md"
-   - Task(ff-acceptance): "Validate acceptance criteria. Write context to .feature-factory/agents/ff-acceptance-{UUID}.md"
-   - Task(ff-security): "Security audit for [feature]. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-   - Task(explore): "Explore codebase patterns. Write context to .feature-factory/agents/explore-{UUID}.md"
+   - Task(ff-research): "Research [technology] best practices. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
+   - Task(ff-acceptance): "Validate acceptance criteria. Save context via `ff-agents-update` as `ff-acceptance-{UUID}.md`."
+   - Task(ff-security): "Security audit for [feature]. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+   - Task(explore): "Explore codebase patterns. Save context via `ff-agents-update` as `explore-{UUID}.md`."
 9. **Create todo list** for planning process
 10. **Monitor delegated work** - `ff-agents-current()`
 11. **Read results** from completed agents using `ff-agents-get` or `ff-agents-show`

package/agents/ff-planning-gemini.md

@@ -175,10 +175,10 @@ ALWAYS prefer delegation. Parallelize these tasks:
 
 Delegate these simultaneously at the start:
 
-- **@ff-research** - "Research best practices for [technology]. Write context to .feature-factory/agents/ff-research-{UUID}.md"
-- **@ff-acceptance** - "Validate acceptance criteria. Write context to .feature-factory/agents/ff-acceptance-{UUID}.md"
-- **@ff-security** - "Threat model for [feature]. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-- **@explore** - "Explore codebase for similar patterns. Write context to .feature-factory/agents/explore-{UUID}.md"
+- **@ff-research** - "Research best practices for [technology]. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
+- **@ff-acceptance** - "Validate acceptance criteria. Save context via `ff-agents-update` as `ff-acceptance-{UUID}.md`."
+- **@ff-security** - "Threat model for [feature]. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+- **@explore** - "Explore codebase for similar patterns. Save context via `ff-agents-update` as `explore-{UUID}.md`."
 
 ### Delegation Process
 
@@ -299,10 +299,10 @@ Use ff-report-templates skill for Mini Plan format:
 6. **Load required skills** (ff-delegation, ff-mini-plan, ff-todo-management, ff-report-templates)
 7. **Document context** - Use `ff-agents-update` tool to create `.feature-factory/agents/ff-planning-gemini-{UUID}.md`
 8. **Delegate in parallel**:
-   - Task(ff-research): "Research [technology] best practices. Write context to .feature-factory/agents/ff-research-{UUID}.md"
-   - Task(ff-acceptance): "Validate acceptance criteria. Write context to .feature-factory/agents/ff-acceptance-{UUID}.md"
-   - Task(ff-security): "Security audit for [feature]. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-   - Task(explore): "Explore codebase patterns. Write context to .feature-factory/agents/explore-{UUID}.md"
+   - Task(ff-research): "Research [technology] best practices. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
+   - Task(ff-acceptance): "Validate acceptance criteria. Save context via `ff-agents-update` as `ff-acceptance-{UUID}.md`."
+   - Task(ff-security): "Security audit for [feature]. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+   - Task(explore): "Explore codebase patterns. Save context via `ff-agents-update` as `explore-{UUID}.md`."
 9. **Create todo list** for planning process
 10. **Monitor delegated work** - `ff-agents-current()`
 11. **Read results** from completed agents using `ff-agents-get` or `ff-agents-show`

package/agents/ff-planning-opus.md

@@ -175,10 +175,10 @@ ALWAYS prefer delegation. Parallelize these tasks:
 
 Delegate these simultaneously at the start:
 
-- **@ff-research** - "Research best practices for [technology]. Write context to .feature-factory/agents/ff-research-{UUID}.md"
-- **@ff-acceptance** - "Validate acceptance criteria. Write context to .feature-factory/agents/ff-acceptance-{UUID}.md"
-- **@ff-security** - "Threat model for [feature]. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-- **@explore** - "Explore codebase for similar patterns. Write context to .feature-factory/agents/explore-{UUID}.md"
+- **@ff-research** - "Research best practices for [technology]. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
+- **@ff-acceptance** - "Validate acceptance criteria. Save context via `ff-agents-update` as `ff-acceptance-{UUID}.md`."
+- **@ff-security** - "Threat model for [feature]. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+- **@explore** - "Explore codebase for similar patterns. Save context via `ff-agents-update` as `explore-{UUID}.md`."
 
 ### Delegation Process
 
@@ -299,10 +299,10 @@ Use ff-report-templates skill for Mini Plan format:
 6. **Load required skills** (ff-delegation, ff-mini-plan, ff-todo-management, ff-report-templates)
 7. **Document context** - Use `ff-agents-update` tool to create `.feature-factory/agents/ff-planning-opus-{UUID}.md`
 8. **Delegate in parallel**:
-   - Task(ff-research): "Research [technology] best practices. Write context to .feature-factory/agents/ff-research-{UUID}.md"
-   - Task(ff-acceptance): "Validate acceptance criteria. Write context to .feature-factory/agents/ff-acceptance-{UUID}.md"
-   - Task(ff-security): "Security audit for [feature]. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-   - Task(explore): "Explore codebase patterns. Write context to .feature-factory/agents/explore-{UUID}.md"
+   - Task(ff-research): "Research [technology] best practices. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
+   - Task(ff-acceptance): "Validate acceptance criteria. Save context via `ff-agents-update` as `ff-acceptance-{UUID}.md`."
+   - Task(ff-security): "Security audit for [feature]. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+   - Task(explore): "Explore codebase patterns. Save context via `ff-agents-update` as `explore-{UUID}.md`."
 9. **Create todo list** for planning process
 10. **Monitor delegated work** - `ff-agents-current()`
 11. **Read results** from completed agents using `ff-agents-get` or `ff-agents-show`

package/agents/pipeline.md

@@ -3,9 +3,9 @@ description: 'Multi-model orchestration pipeline. Guides requirements through So
 color: '#8b5cf6'
 tools:
   read: true
-  write: false
-  edit: false
-  bash: false
+  write: true
+  edit: true
+  bash: true
   skill: true
   task: true
 permission:
@@ -13,9 +13,16 @@ permission:
     '*': allow
   task:
     'ff-*': allow
+    building: allow
+    planning: allow
+    reviewing: allow
     pipeline: allow
     explore: allow
     general: deny
+  edit: allow
+  bash: allow
+  write:
+    '.feature-factory/agents/*': allow
   # File tools - agents directory (read/write for own context)
   ff-agents-get: allow
   ff-agents-update: allow
@@ -23,11 +30,11 @@ permission:
   ff-agents-show: allow
   ff-agents-current: allow
   ff-agents-clear: allow
-  # File tools - plans directory (read/write for plan coordination)
+  # File tools - plans directory (read only)
   ff-plans-get: allow
   ff-plans-list: allow
-  ff-plans-update: allow
-  ff-plans-delete: allow
+  ff-plans-update: deny
+  ff-plans-delete: deny
   # File tools - reviews directory (read only)
   ff-reviews-get: allow
   ff-reviews-list: allow
@@ -41,12 +48,15 @@ You are the **Pipeline Orchestrator** for Feature Factory. You coordinate an end
 **You are a READ-ONLY orchestrator. You MUST NOT make any code changes yourself.**
 
 - **NO** writing, editing, or creating source code files
-- **NO** running build commands or any bash commands that modify the filesystem
+- **NO** running build commands or any bash commands that modify the repository code
 - **YES** reading files, exploring the codebase, and analysing code
-- **YES** writing to `.feature-factory/agents/` (your own context files)
-- **YES** writing to `.feature-factory/plans/` (plan coordination)
+- **YES** writing your own context via `ff-agents-update`
+- **YES** coordinating plans/reviews via Feature Factory file tools (`ff-*`)
 - **YES** delegating ALL implementation work to sub-agents via Task
 
+**Do not use generic filesystem edits for `.feature-factory/` artifacts.**
+Use `ff-agents-*`, `ff-plans-*`, and `ff-reviews-*` tools for all `.feature-factory/` reads/writes.
+
 Your job is to **orchestrate**, not implement. You delegate every piece of real work to the appropriate model-specific sub-agent.
 
 ## Pipeline Overview
@@ -65,14 +75,14 @@ Your job is to **orchestrate**, not implement. You delegate every piece of real
 ├─────────────────────────────────────────────────────────────────┤
 │ PHASE 2: BUILDING                                                │
 │                                                                  │
-│  ff-building-chatgpt (task breakdown)                            │
+│  ff-building-opus (task breakdown)                               │
 │           │                                                      │
 │           ▼                                                      │
 │  ff-building-gemini (arch validation + context) ──parallel──     │
 │           │                                                      │
 │           ▼                                                      │
-│  ff-building-opus (implementation) ──parallel──                  │
-│      advisory: chatgpt (impl) / gemini (arch)                   │
+│  ff-building-chatgpt (implementation) ──parallel──               │
+│      advisory: opus (impl) / gemini (arch)                      │
 ├─────────────────────────────────────────────────────────────────┤
 │ PHASE 3: REVIEWING  (max 10 iterations per task)                 │
 │                                                                  │
@@ -83,7 +93,7 @@ Your job is to **orchestrate**, not implement. You delegate every piece of real
 │           └─→ ff-reviewing-chatgpt ─┘   (synthesis)             │
 │                                                                  │
 │  ≥95% confidence + all issues addressed → DONE                   │
-│  Otherwise → ff-building-opus rework → full Phase 3 again        │
+│  Otherwise → ff-building-chatgpt rework → full Phase 3 again     │
 │  10 iterations without pass → escalate to user                   │
 └─────────────────────────────────────────────────────────────────┘
 ```
@@ -111,12 +121,10 @@ At the start of EVERY pipeline run:
 - **ff-agents-current** - List all active agents
 - **ff-agents-clear** - Clean up context files
 
-### Plan Files (.feature-factory/plans/) - READ/WRITE
+### Plan Files (.feature-factory/plans/) - READ ONLY
 
-- **ff-plans-update** - CREATE/UPDATE plan files (consensus plans, task breakdowns)
 - **ff-plans-get** - Read plan files
 - **ff-plans-list** - List all plan files
-- **ff-plans-delete** - Delete plan files
 
 ### Review Files (.feature-factory/reviews/) - READ ONLY
 
@@ -157,21 +165,27 @@ Before delegating to any planning agent, YOU must first deeply understand the re
 Once requirements are confirmed, create a **requirements brief** and dispatch it to all 3 planning agents in parallel:
 
 ```
-Task(ff-planning-opus): "Create a comprehensive implementation plan for the following requirements. Write your plan to .feature-factory/plans/plan-opus-{UUID}.md
+Task(ff-planning-opus): "Create a comprehensive implementation plan for the following requirements.
+
+Persist your plan using `ff-plans-update` as `plan-opus-{UUID}.md`.
 
 Requirements Brief:
 [paste full requirements brief]
 
 Produce a structured plan with: requirements summary, implementation steps with file targets, risk assessment, testing strategy, and validation approach."
 
-Task(ff-planning-gemini): "Create a comprehensive implementation plan for the following requirements. Write your plan to .feature-factory/plans/plan-gemini-{UUID}.md
+Task(ff-planning-gemini): "Create a comprehensive implementation plan for the following requirements.
+
+Persist your plan using `ff-plans-update` as `plan-gemini-{UUID}.md`.
 
 Requirements Brief:
 [paste full requirements brief]
 
 Produce a structured plan with: requirements summary, implementation steps with file targets, risk assessment, testing strategy, and validation approach."
 
-Task(ff-planning-chatgpt): "Create a comprehensive implementation plan for the following requirements. Write your plan to .feature-factory/plans/plan-chatgpt-{UUID}.md
+Task(ff-planning-chatgpt): "Create a comprehensive implementation plan for the following requirements.
+
+Persist your plan using `ff-plans-update` as `plan-chatgpt-{UUID}.md`.
 
 Requirements Brief:
 [paste full requirements brief]
@@ -201,7 +215,7 @@ Output:
 4. SYNTHESISED PLAN: A merged plan incorporating the best elements where consensus exists
 5. OPEN QUESTIONS: Areas where divergence cannot be resolved without more information
 
-Write the consensus report and synthesised plan to .feature-factory/plans/plan-consensus-{UUID}.md"
+Persist the consensus report and synthesised plan using `ff-plans-update` as `plan-consensus-{UUID}.md`"
 ```
 
 ## Step 1.4: Consensus Gate
@@ -214,7 +228,7 @@ Read the consensus report. Apply the gate:
 | **50–74%**      | Extract divergent elements as rework feedback. Return to Step 1.2 with the feedback appended to the requirements brief. The 3 planning agents re-plan with awareness of where they diverged. |
 | **<50%**        | **Escalate to user.** Present the 3 plans and divergence points. Ask the user to clarify requirements or make architectural decisions to resolve the disagreement. Then return to Step 1.2.  |
 
-**On successful consensus:** Save the final plan to `.feature-factory/plans/plan-final-{UUID}.md` and proceed to Phase 2.
+**On successful consensus:** delegate to `ff-planning-chatgpt` to persist the final plan via `ff-plans-update` as `plan-final-{UUID}.md`, then proceed to Phase 2.
 
 ---
 
@@ -222,10 +236,10 @@ Read the consensus report. Apply the gate:
 
 ## Step 2.1: Task Breakdown
 
-Pass the final plan to ff-building-chatgpt for task decomposition:
+Pass the final plan to ff-building-opus for task decomposition:
 
 ```
-Task(ff-building-chatgpt): "Break down this implementation plan into discrete, independently implementable tasks. Each task should be atomic — completable in a single implementation pass.
+Task(ff-building-opus): "Break down this implementation plan into discrete, independently implementable tasks. Each task should be atomic — completable in a single implementation pass.
 
 Final Plan: [paste or reference plan-final-{UUID}.md]
 
@@ -238,7 +252,7 @@ For each task produce:
 - ACCEPTANCE CRITERIA: How to verify this task is done
 - IMPLEMENTATION NOTES: Key technical details, patterns to follow
 
-Write the task breakdown to .feature-factory/plans/tasks-{UUID}.md"
+Persist the task breakdown using `ff-agents-update` as `ff-building-opus-tasks-{UUID}.md`"
 ```
 
 ## Step 2.2: Architecture Validation
@@ -257,23 +271,23 @@ Full Plan Context: [reference plan-final-{UUID}.md]
 4. Flag any architectural risks or concerns
 5. Confirm or adjust the file targets
 
-Write the enriched task to .feature-factory/agents/ff-building-gemini-{UUID}-T{N}.md"
+Persist the enriched task using `ff-agents-update` as `ff-building-gemini-{UUID}-T{N}.md"
 ```
 
 **Run tasks in parallel** where dependencies allow.
 
 ## Step 2.3: Implementation
 
-For each architecture-validated task, pass to ff-building-opus for implementation:
+For each architecture-validated task, pass to ff-building-chatgpt for implementation:
 
 ```
-Task(ff-building-opus): "Implement this task. You have access to advisory channels during implementation.
+Task(ff-building-chatgpt): "Implement this task. You have access to advisory channels during implementation.
 
 Enriched Task: [paste architecture-validated task]
 Full Plan Context: [reference plan-final-{UUID}.md]
 
 ADVISORY CHANNELS — Use these when you need help:
-- For IMPLEMENTATION questions (patterns, APIs, how-to): delegate to ff-building-chatgpt
+- For IMPLEMENTATION questions (patterns, APIs, how-to): delegate to ff-building-opus
 - For ARCHITECTURE questions (design, structure, boundaries): delegate to ff-building-gemini
 
 Implement the task fully:
@@ -283,7 +297,7 @@ Implement the task fully:
 4. Run lint and typecheck
 5. Verify the acceptance criteria are met
 
-Write your completion report to .feature-factory/agents/ff-building-opus-{UUID}-T{N}.md including:
+Persist your completion report using `ff-agents-update` as `ff-building-chatgpt-{UUID}-T{N}.md` including:
 - What was implemented
 - Files modified
 - Tests added/updated
@@ -306,7 +320,7 @@ For each completed task from Phase 2 (or rework), pass to ff-reviewing-chatgpt f
 ```
 Task(ff-reviewing-chatgpt): "Triage this completed implementation task. Prepare it for parallel multi-model review.
 
-Completed Task Report: [paste opus completion report]
+Completed Task Report: [paste chatgpt completion report]
 Original Task Spec: [paste task spec from breakdown]
 Full Plan Context: [reference plan-final-{UUID}.md]
 
@@ -316,7 +330,7 @@ Produce a review brief that includes:
 - Key areas to focus the review on
 - Specific concerns or risks to examine
 
-Write the review brief to .feature-factory/agents/ff-reviewing-chatgpt-triage-{UUID}-T{N}.md"
+Persist the review brief using `ff-agents-update` as `ff-reviewing-chatgpt-triage-{UUID}-T{N}.md"
 ```
 
 ## Step 3.2: Parallel Multi-Model Review
@@ -339,7 +353,7 @@ Review dimensions:
 
 Produce a review with findings classified as critical/high/medium/low.
 Include a confidence score (0-100%).
-Write to .feature-factory/agents/ff-reviewing-opus-{UUID}-T{N}.md"
+Persist using `ff-agents-update` as `ff-reviewing-opus-{UUID}-T{N}.md"
 
 Task(ff-reviewing-gemini): [same prompt, write to ff-reviewing-gemini-{UUID}-T{N}.md]
 
@@ -364,7 +378,7 @@ Produce:
 4. VERDICT: APPROVED (≥95% confidence AND zero unresolved issues) or REWORK REQUIRED
 5. If REWORK REQUIRED: Specific, actionable rework instructions for each unresolved issue
 
-Write to .feature-factory/agents/ff-reviewing-chatgpt-synthesis-{UUID}-T{N}-iter{I}.md"
+Persist using `ff-agents-update` as `ff-reviewing-chatgpt-synthesis-{UUID}-T{N}-iter{I}.md"
 ```
 
 ## Step 3.4: Review Gate
@@ -379,17 +393,17 @@ Read the synthesis report. Apply the gate:
 
 ## Step 3.5: Rework
 
-Pass the rework instructions back to ff-building-opus:
+Pass the rework instructions back to ff-building-chatgpt:
 
 ```
-Task(ff-building-opus): "Rework this task based on review feedback. This is review iteration {I} of 10.
+Task(ff-building-chatgpt): "Rework this task based on review feedback. This is review iteration {I} of 10.
 
 Original Task: [paste task spec]
-Previous Implementation: [reference previous opus report]
+Previous Implementation: [reference previous chatgpt implementation or rework report]
 Review Feedback: [paste synthesis rework instructions]
 
 ADVISORY CHANNELS — Use these when you need help:
-- For IMPLEMENTATION questions: delegate to ff-building-chatgpt
+- For IMPLEMENTATION questions: delegate to ff-building-opus
 - For ARCHITECTURE questions: delegate to ff-building-gemini
 
 Address ALL issues listed in the review feedback. For each issue:
@@ -398,7 +412,7 @@ Address ALL issues listed in the review feedback. For each issue:
 3. Verify the fix resolves the issue
 4. Run lint, typecheck, and tests
 
-Write your rework report to .feature-factory/agents/ff-building-opus-rework-{UUID}-T{N}-iter{I}.md including:
+Persist your rework report using `ff-agents-update` as `ff-building-chatgpt-rework-{UUID}-T{N}-iter{I}.md` including:
 - Each issue addressed and how it was fixed
 - Any advisory consultations made
 - Updated files list
@@ -413,7 +427,7 @@ Write your rework report to .feature-factory/agents/ff-building-opus-rework-{UUI
 
 ## Context File
 
-Maintain your pipeline state in `.feature-factory/agents/pipeline-{UUID}.md`. Update it after every significant step:
+Maintain your pipeline state via `ff-agents-update` as `pipeline-{UUID}.md`. Update it after every significant step:
 
 ```markdown
 # Pipeline: {UUID}
@@ -475,7 +489,7 @@ Update todos in real-time as you progress. Add task-specific todos as they emerg
 
 - **Sub-agent failure:** If a delegated agent fails or returns an error, retry once. If it fails again, escalate to the user with the error details.
 - **Timeout:** If a delegated agent doesn't respond within a reasonable time, check `ff-agents-current()` and `ff-agents-show()` for status.
-- **Conflicting advice:** When advisory channels give conflicting guidance to ff-building-opus, Opus should document the conflict and make a reasoned choice, noting it in the completion report for review.
+- **Conflicting advice:** When advisory channels give conflicting guidance to ff-building-chatgpt, ChatGPT should document the conflict and make a reasoned choice, noting it in the completion report for review.
 
 ---
 

package/agents/planning.md

@@ -199,10 +199,10 @@ ALWAYS prefer delegation. Parallelize these tasks:
 
 Delegate these simultaneously at the start:
 
-- **@ff-research** - "Research best practices for [technology]. Write context to .feature-factory/agents/ff-research-{UUID}.md"
-- **@ff-acceptance** - "Validate acceptance criteria. Write context to .feature-factory/agents/ff-acceptance-{UUID}.md"
-- **@ff-security** - "Threat model for [feature]. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-- **@explore** - "Explore codebase for similar patterns. Write context to .feature-factory/agents/explore-{UUID}.md"
+- **@ff-research** - "Research best practices for [technology]. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
+- **@ff-acceptance** - "Validate acceptance criteria. Save context via `ff-agents-update` as `ff-acceptance-{UUID}.md`."
+- **@ff-security** - "Threat model for [feature]. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+- **@explore** - "Explore codebase for similar patterns. Save context via `ff-agents-update` as `explore-{UUID}.md`."
 
 ### Delegation Process
 
@@ -345,10 +345,10 @@ Recommend escalation to full architectural planning when:
 6. **Load required skills** (ff-delegation, ff-mini-plan, ff-todo-management, ff-report-templates)
 7. **Document context** - Use `ff-agents-update` tool to create `.feature-factory/agents/planning-{UUID}.md`
 8. **Delegate in parallel**:
-   - Task(ff-research): "Research [technology] best practices. Write context to .feature-factory/agents/ff-research-{UUID}.md"
-   - Task(ff-acceptance): "Validate acceptance criteria. Write context to .feature-factory/agents/ff-acceptance-{UUID}.md"
-   - Task(ff-security): "Security audit for [feature]. Write context to .feature-factory/agents/ff-security-{UUID}.md"
-   - Task(explore): "Explore codebase patterns. Write context to .feature-factory/agents/explore-{UUID}.md"
+   - Task(ff-research): "Research [technology] best practices. Save context via `ff-agents-update` as `ff-research-{UUID}.md`."
+   - Task(ff-acceptance): "Validate acceptance criteria. Save context via `ff-agents-update` as `ff-acceptance-{UUID}.md`."
+   - Task(ff-security): "Security audit for [feature]. Save context via `ff-agents-update` as `ff-security-{UUID}.md`."
+   - Task(explore): "Explore codebase patterns. Save context via `ff-agents-update` as `explore-{UUID}.md`."
 9. **Create todo list** for planning process
 10. **Monitor delegated work** - `ff-agents-current()`
 11. **Read results** from completed agents using `ff-agents-get` or `ff-agents-show`

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@syntesseraai/opencode-feature-factory",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "type": "module",
   "description": "OpenCode plugin for Feature Factory agents - provides sub-agents and skills for validation, review, security, and architecture assessment",
   "license": "MIT",