@syntesseraai/opencode-feature-factory 0.6.0 → 0.6.1

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
@@ -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.
 
 ---
 
@@ -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-chatgpt-tasks-{UUID}.md`"
 ```
 
 ## Step 2.2: Architecture Validation
@@ -257,7 +271,7 @@ 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.
@@ -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-opus-{UUID}-T{N}.md` including:
 - What was implemented
 - Files modified
 - Tests added/updated
@@ -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
@@ -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-opus-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}

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.1",
   "type": "module",
   "description": "OpenCode plugin for Feature Factory agents - provides sub-agents and skills for validation, review, security, and architecture assessment",
   "license": "MIT",