@syntesseraai/opencode-feature-factory 0.2.28 → 0.2.30

package/agents/planning.md

@@ -16,10 +16,6 @@ permission:
   task:
     'ff-*': allow
     explore: allow
-  write:
-    '.feature-factory/agents/*': allow
-  edit:
-    '.feature-factory/agents/*': allow
 ---
 
 You are a planning specialist for Feature Factory. Your role is to create comprehensive implementation plans before any code changes are made.
@@ -34,7 +30,7 @@ At the start of EVERY planning task:
 4. **Load the ff-todo-management skill** and create a todo list for the planning process
 5. **Load the ff-learning skill** to capture planning insights and patterns
 6. **Load the ff-report-templates skill** for standardized output formatting
-7. **Document your context** - Write to `.feature-factory/agents/planning-{UUID}.md`
+7. **Document your context** - Use `ff-agent-context-create` tool to create `.feature-factory/agents/planning-{UUID}.md`
 
 ## Core Responsibilities
 
@@ -193,7 +189,7 @@ Recommend escalation to full architectural planning when:
 
 1. **Generate UUID** - Create unique ID for this planning instance
 2. **Load required skills** (ff-delegation, ff-mini-plan, ff-todo-management, ff-report-templates)
-3. **Document context** - Write to `.feature-factory/agents/planning-{UUID}.md`
+3. **Document context** - Use `ff-agent-context-create` tool to create `.feature-factory/agents/planning-{UUID}.md`
 4. **Delegate in parallel**:
    - Task(ff-research): "Research [technology] best practices"
    - Task(ff-acceptance): "Validate acceptance criteria"
@@ -240,12 +236,12 @@ Before completing your planning task:
    ```markdown
    After completing planning:
 
-   1. Generate UUID: `uuidgen`
-   2. Create memory file: `.feature-factory/memories/semantic/architecture-{uuid}.md`
-   3. Include frontmatter with:
-      - title: "Architecture Decision: [Decision Name]"
-      - description: "Rationale for choosing [approach] over [alternatives]"
-      - memory_type: "semantic"
-      - tags: ["architecture", "decision", "{technology}"]
-      - importance: 0.8
+   Use ff-learning-store tool:
+
+   - title: "Architecture Decision: [Decision Name]"
+   - description: "Rationale for choosing [approach] over [alternatives]"
+   - memoryType: "semantic"
+   - tags: ["architecture", "decision", "{technology}"]
+   - importance: 0.8
+   - content: "Detailed explanation of the decision..."
    ```

package/agents/reviewing.md

@@ -5,7 +5,7 @@ temperature: 0.1
 color: '#f59e0b'
 tools:
   read: true
-  write: true
+  write: false
   edit: false
   bash: false
   skill: true
@@ -16,8 +16,6 @@ permission:
   task:
     'ff-*': allow
     building: allow
-  write:
-    '.feature-factory/agents/*': allow
 ---
 
 You are a reviewing/validation specialist for Feature Factory. Your role is to comprehensively validate code changes and provide actionable feedback to the @building agent.
@@ -241,11 +239,11 @@ When combining results from multiple agents:
 
 1. **Generate UUID** - Create unique ID for this reviewing instance
 2. **Load required skills** (ff-delegation, ff-todo-management, ff-report-templates, ff-severity-classification)
-3. **Document context** - Write to `.feature-factory/agents/reviewing-{UUID}.md`
+3. **Document context** - Use `ff-agent-context-create` tool to create `.feature-factory/agents/reviewing-{UUID}.md`
 4. **Create review todo list**
 5. **Mark "Launch validation"** as in_progress
 6. **Invoke @ff-validate agent** (runs 4 sub-agents in parallel)
-7. **Track child agents** - Add their UUIDs to your `delegated_to` list
+7. **Track child agents** - Use `ff-agent-context-update` tool to add their UUIDs to your `delegated_to` list
 8. **Monitor progress** - `ff-agents-current()`
 9. **Wait for results**, mark todo complete
 10. **Mark "Aggregate results"** as in_progress
@@ -334,12 +332,12 @@ Before completing your review task:
    ```markdown
    After completing review:
 
-   1. Generate UUID: `uuidgen`
-   2. Create memory file: `.feature-factory/memories/semantic/review-patterns-{uuid}.md`
-   3. Include frontmatter with:
-      - title: "Review Pattern: [Common Issue Type]"
-      - description: "Common pattern of [issue] found in [context]"
-      - memory_type: "semantic"
-      - tags: ["review", "pattern", "{issue-type}", "{technology}"]
-      - importance: 0.7
+   Use ff-learning-store tool:
+
+   - title: "Review Pattern: [Common Issue Type]"
+   - description: "Common pattern of [issue] found in [context]"
+   - memoryType: "semantic"
+   - tags: ["review", "pattern", "{issue-type}", "{technology}"]
+   - importance: 0.7
+   - content: "Detailed explanation of the pattern and solution..."
    ```

package/package.json

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

package/skills/ff-learning/SKILL.md

@@ -132,7 +132,25 @@ context: # Optional: Additional context
 
 ## Tools
 
-### Tool 1: Store Learning
+The ff-learning skill provides three tools for agents to interact with the memory system. These tools are especially important for **read-only agents** (like @planning and @reviewing) that cannot directly write files.
+
+### Using the Tools
+
+**For read-only agents:** Use the tool calls directly:
+
+```markdown
+Store a learning using ff-learning-store tool:
+
+- title: "OAuth Implementation Pattern"
+- description: "Successfully implemented OAuth with NextAuth.js"
+- memoryType: "semantic"
+- tags: ["oauth", "nextauth", "authentication"]
+- importance: 0.8
+```
+
+**For agents with write permissions:** Can use either tools or direct file operations.
+
+### Tool 1: Store Learning (ff-learning-store)
 
 **Purpose:** Create a new memory file with proper frontmatter
 
@@ -254,6 +272,104 @@ After finding a relevant memory:
 4. Apply learnings to current task
 ```
 
+## Additional Tools for Read-Only Agents
+
+Since @planning and @reviewing agents are read-only (cannot write/edit files), the following tools are provided for essential file operations:
+
+### Tool 4: Create Plan (ff-plan-create)
+
+**Purpose:** Create a new implementation plan file in `.feature-factory/plans/`
+
+**When to use:**
+
+- At the end of planning sessions to document the plan
+- When creating architecture or migration plans
+- To document research findings as structured plans
+
+**Input parameters:**
+
+- `title` (string, required): Title of the plan
+- `description` (string, required): What the plan covers
+- `content` (string, required): Full markdown content
+- `planType` (enum, required): implementation, architecture, migration, or research
+- `relatedIssues` (array, optional): Related issue IDs
+- `estimatedEffort` (string, optional): Time estimate
+
+**Example:**
+
+```markdown
+Create plan using ff-plan-create:
+
+- title: "OAuth Implementation Plan"
+- description: "Plan for implementing OAuth authentication"
+- content: "## Phase 1: Setup..."
+- planType: "implementation"
+- estimatedEffort: "2-3 hours"
+```
+
+### Tool 5: Create Agent Context (ff-agent-context-create)
+
+**Purpose:** Create a new agent context file in `.feature-factory/agents/`
+
+**When to use:**
+
+- At the start of EVERY agent task to document context
+- When delegating work to track parent-child relationships
+- To maintain agent state and progress
+
+**Input parameters:**
+
+- `id` (string, required): UUID for this agent instance
+- `agent` (string, required): Agent type (planning, building, etc.)
+- `title` (string, required): Task title
+- `description` (string, required): Task description
+- `status` (enum, optional): in-progress, completed, delegated, failed
+- `parent` (string, optional): Parent agent UUID
+- `delegatedTo` (array, optional): Child agent UUIDs
+- `notes` (string, optional): Additional notes
+
+**Example:**
+
+```markdown
+Create agent context using ff-agent-context-create:
+
+- id: "550e8400-e29b-41d4-a716-446655440000"
+- agent: "planning"
+- title: "Implement OAuth"
+- description: "Plan OAuth implementation for customer portal"
+- status: "in-progress"
+```
+
+### Tool 6: Update Agent Context (ff-agent-context-update)
+
+**Purpose:** Update an existing agent context file
+
+**When to use:**
+
+- When status changes (e.g., completed, delegated)
+- When adding delegated child agents
+- When appending progress updates or notes
+
+**Input parameters:**
+
+- `agentId` (string, required): Agent UUID to update
+- `agent` (string, required): Agent type
+- `status` (enum, optional): New status
+- `addDelegatedTo` (string, optional): Add child agent UUID
+- `notes` (string, optional): Notes to append
+- `progressUpdate` (string, optional): Progress line to add
+
+**Example:**
+
+```markdown
+Update agent context using ff-agent-context-update:
+
+- agentId: "550e8400-e29b-41d4-a716-446655440000"
+- agent: "planning"
+- status: "completed"
+- notes: "Planning finished successfully"
+```
+
 ## Usage by Agent Type
 
 ### Planning Agent