rrce-workflow 0.3.18 → 0.3.20

package/README.md

@@ -11,7 +11,7 @@ RRCE-Workflow transforms your AI coding assistant (GitHub Copilot, OpenCode, Cla
 - **Global Knowledge Base**: Centralized context management across all your projects (`~/.rrce-workflow/`).
 - **MCP Hub**: A Model Context Protocol server exposing tools, resources, and prompts to any MCP-compatible client.
 - **Semantic Search (RAG)**: Local, privacy-first vector indexing powered by `@xenova/transformers` for deep codebase understanding.
-- **Structured Agent Pipelines**: 7 specialized agents (Init, Research, Planning, Executor, Docs, Sync, Doctor) for end-to-end development workflows.
+- **Structured Agent Pipelines**: 5 specialized agents (Init, Design, Develop, Docs, Sync, Doctor) for end-to-end development workflows.
 - **Task Management**: Built-in CRUD operations for tracking high-level tasks via MCP tools.
 
 ---

package/agent-core/prompts/_base.md

@@ -8,6 +8,11 @@ Use values from the **System Context** table above. Never guess or construct pat
 - `WORKSPACE_ROOT` - Project source code location
 - `RRCE_HOME` - Global RRCE installation directory
 
+**If System Context is missing or incorrect:**
+1. Call `rrce_resolve_path(project: "PROJECT_NAME")` to get authoritative paths
+2. If resolution fails, call `rrce_list_projects()` to see available projects
+3. If both fail, ask the user for clarification before proceeding
+
 ## Tool Preference Order
 1. **Context bundling** (`rrce_get_context_bundle`) - single call aggregates project context + knowledge + code
 2. **Semantic search** (`rrce_search_knowledge`, `rrce_search_code`) - finds concepts without exact matches
@@ -95,9 +100,10 @@ For active task visibility in the MCP TUI:
 This enables real-time progress display in the Overview tab.
 
 ## Workspace Constraints
-- Most agents are **read-only** on `WORKSPACE_ROOT`
-- Only **Develop** agent may modify source code
+- All agents have read and write access to files as needed
+- Agents should respect task scope and avoid unnecessary modifications
 - All agents may write to their designated `RRCE_DATA` paths
+- Develop agent focuses on execution of planned changes in source code
 
 ---
 

package/agent-core/prompts/design.md

@@ -2,7 +2,7 @@
 name: RRCE Design
 description: Research requirements and create execution plan in a single interactive session. Combines clarification and task breakdown.
 argument-hint: TASK_SLUG=<slug> REQUEST="<user prompt>" [TITLE="<task title>"]
-tools: ['rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_search_tasks', 'rrce_find_related_files', 'rrce_get_project_context', 'rrce_validate_phase', 'rrce_list_projects', 'rrce_create_task', 'rrce_update_task', 'websearch', 'codesearch', 'write']
+tools: ['rrce_resolve_path', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_search_tasks', 'rrce_find_related_files', 'rrce_get_project_context', 'rrce_validate_phase', 'rrce_list_projects', 'rrce_create_task', 'rrce_update_task', 'rrce_start_session', 'rrce_end_session', 'rrce_update_agent_todos', 'websearch', 'codesearch', 'read', 'write', 'glob', 'grep']
 required-args:
   - name: TASK_SLUG
     prompt: "Enter a task slug (kebab-case identifier)"
@@ -427,6 +427,7 @@ Then tell user: "Design complete! To develop: `/rrce_develop {{TASK_SLUG}}` or a
 
 ## Constraints
 
-- **READ-ONLY workspace**: Write only to `{{RRCE_DATA}}/tasks/{{TASK_SLUG}}/`
+- Agents have read and write access to workspace as needed
+- Focus on design and planning artifacts
 - If user asks for code changes: "Code changes happen in the Develop phase. Let's finish design first."
 

package/agent-core/prompts/develop.md

@@ -2,7 +2,7 @@
 name: RRCE Develop
 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: ['rrce_prefetch_task_context', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_find_related_files', 'rrce_get_project_context', 'rrce_validate_phase', 'rrce_index_knowledge', 'rrce_update_task', 'rrce_start_session', 'rrce_end_session', 'rrce_update_agent_todos', 'read', 'write', 'edit', 'bash', 'glob', 'grep']
+tools: ['rrce_resolve_path', 'rrce_prefetch_task_context', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_find_related_files', 'rrce_get_project_context', 'rrce_validate_phase', 'rrce_index_knowledge', 'rrce_update_task', 'rrce_start_session', 'rrce_end_session', 'rrce_update_agent_todos', 'read', 'write', 'edit', 'bash', 'glob', 'grep']
 required-args:
   - name: TASK_SLUG
     prompt: "Enter the task slug to execute"
@@ -215,10 +215,10 @@ Optional: "Ready for documentation? `/rrce_docs {{TASK_SLUG}}`"
 
 ## Authority
 
-**You are the ONLY agent that can:**
-- Modify `{{WORKSPACE_ROOT}}` files
-- Use `edit` and `write` on source code
-- Run `bash` commands
+**You are the primary execution agent for:**
+- Implementing planned tasks in `{{WORKSPACE_ROOT}}`
+- Making code changes based on approved plans
+- Running `bash` commands and validation tests
 
-**All other agents are read-only.**
+All agents have read and write access, but Develop focuses on execution of planned changes.
 

package/agent-core/prompts/doctor.md

@@ -2,7 +2,7 @@
 name: RRCE Doctor
 description: Analyze codebase health using semantic search; identify issues and recommend improvement tasks.
 argument-hint: "[PROJECT_NAME=<name>] [FOCUS_AREA=<area>]"
-tools: ['rrce_search_knowledge', 'rrce_get_project_context', 'rrce_index_knowledge', 'rrce_list_projects', 'rrce_create_task']
+tools: ['rrce_resolve_path', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_get_project_context', 'rrce_index_knowledge', 'rrce_list_projects', 'rrce_create_task', 'read', 'write', 'glob', 'grep']
 required-args: []
 optional-args:
   - name: PROJECT_NAME
@@ -22,7 +22,6 @@ You are the Project Doctor for RRCE-Workflow. Perform a health check on the code
 - **Standalone Agent**: Can be invoked at any time, independent of research/plan/execute pipeline
 - **No Prerequisites**: Does not require prior phases (benefits from `project-context.md` if available)
 - **Output**: Structured diagnosis with ready-to-use task definitions
-- **Read-Only**: Analyzes but does NOT modify source code
 
 ## Mission
 - Analyze the codebase for health issues, technical debt, and improvement opportunities

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: ['rrce_search_knowledge', 'rrce_get_project_context', 'rrce_list_projects', 'rrce_update_task']
+tools: ['rrce_resolve_path', 'rrce_prefetch_task_context', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_get_project_context', 'rrce_list_projects', 'rrce_update_task', 'read', 'write', 'glob', 'grep']
 required-args:
   - name: DOC_TYPE
     prompt: "Enter the documentation type (e.g., api, architecture, runbook, changelog)"

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: ['rrce_search_knowledge', 'rrce_index_knowledge', 'rrce_get_project_context', 'rrce_list_projects']
+tools: ['rrce_resolve_path', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_index_knowledge', 'rrce_get_project_context', 'rrce_list_projects', 'rrce_start_session', 'rrce_end_session', 'read', 'write', 'glob', 'grep']
 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|design|develop|docs>] [TASK_SLUG=<slug>]"
-tools: ['rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_search_tasks', 'rrce_validate_phase', 'rrce_find_related_files', 'rrce_get_project_context', 'rrce_list_projects', 'rrce_list_agents', 'rrce_get_agent_prompt', 'rrce_list_tasks', 'rrce_get_task', 'rrce_create_task', 'rrce_update_task', 'rrce_delete_task', 'rrce_index_knowledge', 'rrce_resolve_path', 'read', 'write', 'bash', 'task']
+tools: ['rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_search_tasks', 'rrce_validate_phase', 'rrce_find_related_files', 'rrce_get_project_context', 'rrce_list_projects', 'rrce_list_agents', 'rrce_get_agent_prompt', 'rrce_list_tasks', 'rrce_get_task', 'rrce_create_task', 'rrce_update_task', 'rrce_delete_task', 'rrce_index_knowledge', 'rrce_resolve_path', 'read', 'write', 'bash', 'edit', 'task', 'glob', 'grep']
 mode: primary
 required-args: []
 optional-args:

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: ['rrce_search_knowledge', 'rrce_get_project_context', 'rrce_index_knowledge', 'rrce_list_projects', 'rrce_update_task']
+tools: ['rrce_resolve_path', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_get_project_context', 'rrce_index_knowledge', 'rrce_list_projects', 'rrce_update_task', 'read', 'write', 'glob', 'grep']
 required-args: []
 optional-args:
   - name: SCOPE