rrce-workflow 0.3.12 → 0.3.14

package/README.md

@@ -234,6 +234,18 @@ RAG is enabled by default in Express Setup. You can toggle it per-project in the
 
 ---
 
+## 🛠 AI Agent Effectiveness & Code Health
+
+We've optimized the codebase to be **highly navigatable for AI coding agents**:
+
+### Codebase Optimization (v0.3.13)
+- **Deduplication**: Consolidated install/uninstall logic and project sorting.
+- **Function Extraction**: Split monolithic functions (like `index_knowledge`) into manageable helpers.
+- **Improved Type Safety**: Replaced `any` types with structured interfaces (`TaskMeta`, `AgentInfo`).
+- **AI Agent Guide**: Added [AI Agent Architecture Guide](docs/AI_AGENT_GUIDE.md) to help coding assistants navigate the project.
+
+---
+
 ## Requirements
 
 -   **Node.js 18+**

package/agent-core/prompts/_base.md

@@ -9,7 +9,7 @@ Use values from the **System Context** table above. Never guess or construct pat
 - `RRCE_HOME` - Global RRCE installation directory
 
 ## Tool Preference Order
-1. **Semantic search** (`rrce_search_knowledge`, `rrce_search_code`) - finds concepts without exact matches
+1. **Semantic search** (`search_knowledge`, `search_code`) - finds concepts without exact matches
 2. **Direct read** (`read`) - for specific known files
 3. **Pattern search** (`glob`, `grep`) - last resort for exact strings or when RAG unavailable
 
@@ -25,6 +25,13 @@ If a `PRE-FETCHED CONTEXT` block exists in your prompt:
 ## Metadata Updates
 For `meta.json` changes, use `rrce_update_task()` - it auto-saves. Never use `write` for meta.json.
 
+## Checklist Sync (OpenCode)
+When working on a task with a checklist:
+1. Always read the current checklist from `meta.json`.
+2. Sync the checklist to OpenCode's Todo sidebar using `todowrite`.
+3. Format the checklist for `todowrite` as a structured list of sub-tasks relevant to your current phase.
+4. Update the sidebar whenever a sub-task status changes.
+
 ## Completion Signal
 When your phase completes, emit:
 ```

package/agent-core/prompts/doctor.md

@@ -34,7 +34,7 @@ You are the Project Doctor for RRCE-Workflow. Perform a health check on the code
 ### Step 1: Load Project Context
 
 ```
-Tool: rrce_get_project_context
+Tool: get_project_context
 Args: { "project": "{{WORKSPACE_NAME}}" }
 ```
 
@@ -72,7 +72,7 @@ Use `search_knowledge` to efficiently find problem areas. Run queries based on F
 
 **Query Execution:**
 ```
-Tool: rrce_search_knowledge
+Tool: search_knowledge
 Args: { "query": "<query>", "project": "{{WORKSPACE_NAME}}" }
 ```
 

package/agent-core/prompts/documentation.md

@@ -2,7 +2,7 @@
 name: RRCE Documentation
 description: Produce project documentation aligned with the latest delivery.
 argument-hint: "DOC_TYPE=<type> [TASK_SLUG=<slug> | TARGET_PATH=<relative>] [RELEASE_REF=<tag/sha>]"
-tools: ['search_knowledge', 'get_project_context', 'list_projects', 'update_task', 'read', 'write', 'edit', 'bash', 'glob', 'grep', 'todoread', 'todowrite']
+tools: ['search_knowledge', 'get_project_context', 'list_projects', 'update_task']
 required-args:
   - name: DOC_TYPE
     prompt: "Enter the documentation type (e.g., api, architecture, runbook, changelog)"

package/agent-core/prompts/executor.md

@@ -2,7 +2,7 @@
 name: RRCE Executor
 description: Execute the planned tasks to deliver working code and tests. The ONLY agent authorized to modify source code.
 argument-hint: "TASK_SLUG=<slug> [BRANCH=<git ref>]"
-tools: ['search_knowledge', 'search_code', 'find_related_files', 'get_project_context', 'index_knowledge', 'update_task', 'read', 'write', 'edit', 'bash', 'glob', 'grep', 'todoread', 'todowrite']
+tools: ['search_knowledge', 'search_code', 'find_related_files', 'get_project_context', 'index_knowledge', 'update_task', 'read', 'write', 'edit', 'bash', 'glob', 'grep']
 required-args:
   - name: TASK_SLUG
     prompt: "Enter the task slug to execute"

package/agent-core/prompts/init.md

@@ -2,7 +2,7 @@
 name: RRCE Init
 description: Initialize project context and semantic search index by analyzing codebase structure, tech stack, and conventions.
 argument-hint: "[PROJECT_NAME=<name>]"
-tools: ['search_knowledge', 'index_knowledge', 'get_project_context', 'list_projects', 'read', 'write', 'bash', 'glob', 'grep']
+tools: ['search_knowledge', 'index_knowledge', 'get_project_context', 'list_projects']
 required-args: []
 optional-args:
   - name: PROJECT_NAME

package/agent-core/prompts/orchestrator.md

@@ -2,7 +2,7 @@
 name: RRCE
 description: Phase coordinator for RRCE workflow. Checks state, guides transitions. Uses slash commands for token efficiency.
 argument-hint: "[PHASE=<init|research|plan|execute|docs>] [TASK_SLUG=<slug>]"
-tools: ['search_knowledge', 'search_code', 'find_related_files', 'get_project_context', 'list_projects', 'list_agents', 'get_agent_prompt', 'list_tasks', 'get_task', 'create_task', 'update_task', 'delete_task', 'index_knowledge', 'resolve_path', 'read', 'write', 'edit', 'bash', 'glob', 'grep', 'task', 'webfetch', 'todoread', 'todowrite']
+tools: ['search_knowledge', 'search_code', 'find_related_files', 'get_project_context', 'list_projects', 'list_agents', 'get_agent_prompt', 'list_tasks', 'get_task', 'create_task', 'update_task', 'delete_task', 'index_knowledge', 'resolve_path', 'read', 'write', 'bash', 'task']
 mode: primary
 required-args: []
 optional-args:
@@ -83,9 +83,14 @@ Use `@rrce_executor` subagent only for:
 
 Otherwise: Use `/rrce_execute` for in-context execution.
 
-## Delegation Protocol (When Using Subagent)
+## Delegation Protocol (OpenCode Optimized)
 
-**CRITICAL: Use summarized context, not full search results.**
+**Slash commands run in-context and are ~60% more token-efficient than subagent delegation.**
+
+For isolated execution (e.g. `@rrce_executor`):
+1. **Mention**: Print `@rrce_executor TASK_SLUG=${TASK_SLUG}` in your message for user visibility.
+2. **Suggest**: Use OpenCode's interactive confirmation to trigger the handoff.
+3. **Summarize**: Provide a < 200 token context summary.
 
 ```javascript
 task({
@@ -107,6 +112,11 @@ Execute non-interactively. Return completion signal when done.`,
 
 **Hard rule:** Context summary should be < 200 tokens.
 
+Example handoff:
+> Task research complete. Proceeding to execution?
+> @rrce_executor TASK_SLUG=my-feature
+
+
 ## Retrieval Budget
 - Max **2 retrieval calls per turn**
 - Use `rrce_get_task` to check phase state

package/agent-core/prompts/planning_discussion.md

@@ -2,7 +2,7 @@
 name: RRCE Planning
 description: Transform research findings into an actionable execution plan through interactive task breakdown.
 argument-hint: "TASK_SLUG=<slug>"
-tools: ['search_knowledge', 'search_code', 'find_related_files', 'get_project_context', 'list_projects', 'update_task', 'read', 'glob', 'grep', 'write', 'todoread', 'todowrite']
+tools: ['search_knowledge', 'search_code', 'find_related_files', 'get_project_context', 'list_projects', 'update_task']
 required-args:
   - name: TASK_SLUG
     prompt: "Enter the task slug to create a plan for"

package/agent-core/prompts/research_discussion.md

@@ -2,7 +2,7 @@
 name: RRCE Research
 description: Interactive research and requirements clarification through constructive dialogue. Achieves 100% understanding before planning.
 argument-hint: REQUEST="<user prompt>" [TASK_SLUG=<slug>] [TITLE="<task title>"] [SOURCE=<url>]
-tools: ['search_knowledge', 'search_code', 'find_related_files', 'get_project_context', 'list_projects', 'create_task', 'update_task', 'read', 'glob', 'grep', 'write']
+tools: ['search_knowledge', 'search_code', 'find_related_files', 'get_project_context', 'list_projects', 'create_task', 'update_task']
 required-args:
   - name: TASK_SLUG
     prompt: "Enter a task slug (kebab-case identifier)"
@@ -27,7 +27,7 @@ You are the Research agent for RRCE-Workflow. Clarify requirements through focus
 
 ## Retrieval Budget
 - Max **2 retrieval calls per turn**
-- First turn: `rrce_search_knowledge` + `rrce_search_code` + `rrce_get_project_context`
+- First turn: `search_knowledge` + `search_code` + `get_project_context`
 - Subsequent turns: reference cached findings, avoid repeat searches
 
 ## Workflow

package/agent-core/prompts/sync.md

@@ -2,7 +2,7 @@
 name: RRCE Sync
 description: Reconcile project state with the RRCE knowledge base and update semantic index.
 argument-hint: "[SCOPE=<path|module>]"
-tools: ['search_knowledge', 'get_project_context', 'index_knowledge', 'list_projects', 'update_task', 'read', 'write', 'edit', 'bash', 'glob', 'grep']
+tools: ['search_knowledge', 'get_project_context', 'index_knowledge', 'list_projects', 'update_task']
 required-args: []
 optional-args:
   - name: SCOPE