rrce-workflow 0.2.7 → 0.2.10

package/README.md

@@ -5,89 +5,198 @@
 [![npm version](https://badge.fury.io/js/rrce-workflow.svg)](https://www.npmjs.com/package/rrce-workflow)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-RRCE-Workflow is a TUI that helps you set up and manage AI agent workflows for your codebase. It works with GitHub Copilot, Antigravity IDE, and other AI coding tools.
+RRCE-Workflow is a CLI wizard that sets up AI agent prompts and workflows for your codebase. It works with **GitHub Copilot**, **Antigravity IDE**, and other AI coding assistants.
 
 ## Installation
 
 ```bash
-# Using npm
+# Quick start (no install needed)
 npx rrce-workflow
 
-# Using bun (recommended)
-bunx rrce-workflow
-
-# Global install
+# Or install globally
 npm install -g rrce-workflow
 ```
 
-## Quick Start
+---
+
+## How to Use
+
+### 1. Initial Setup
+
+Run the wizard in your project directory:
 
 ```bash
-# Run setup wizard
-rrce-workflow wizard
+cd your-project
+npx rrce-workflow
+```
+
+The wizard will:
+1. Ask where to store workflow data (global, workspace, or both)
+2. Let you choose a custom global path if the default isn't writable
+3. Ask which AI tools you use (GitHub Copilot, Antigravity)
+4. Set up prompts and knowledge folders
+
+### 2. Using the Agent Prompts
 
-# Or just run to see available agents
-rrce-workflow
+After setup, you'll have agent prompts in IDE-specific folders:
+
+- **GitHub Copilot**: `.github/agents/*.agent.md`
+- **Antigravity**: `.agent/workflows/*.md`
+
+In your AI assistant, invoke prompts using their names:
+
+| Agent | Invoke With | What It Does |
+|-------|-------------|--------------|
+| **Init** | `/init` | Analyze your codebase and create `project-context.md` |
+| **Research** | `/research REQUEST="..." TASK_SLUG=my-task` | Clarify requirements, create research brief |
+| **Planning** | `/plan TASK_SLUG=my-task` | Create actionable execution plan |
+| **Execute** | `/execute TASK_SLUG=my-task` | Implement the planned work |
+| **Docs** | `/docs DOC_TYPE=architecture` | Generate documentation |
+| **Sync** | `/sync` | Update knowledge base after code changes |
+
+### 3. Recommended Workflow (RRCE Pipeline)
+
+```
+1. /init       → Establish project context
+2. /research   → Clarify requirements for a new task
+3. /plan       → Create execution plan
+4. /execute    → Implement the plan
+5. /docs       → Generate documentation (optional)
+6. /sync       → Keep knowledge base current (periodic)
 ```
 
-## Features
+#### Pipeline Stages Explained
 
-- **Setup Wizard** - Interactive configuration for storage mode and AI tools
-- **Agent Prompts** - Pre-built prompts for init, research, planning, execution, documentation, and sync
-- **Multi-Tool Support** - Works with GitHub Copilot (`.agent.md`) and Antigravity IDE
-- **Cross-Project References** - Reference context from related projects
+**🔍 Init** — Scans your codebase to understand tech stack, architecture, coding conventions, and project structure. Creates `project-context.md` that all other agents rely on. Run once at project start, and again when major changes occur.
 
-## Agents
+**💬 Research** — Entry point for new tasks. Takes a user request and engages in clarifying discussion to refine scope, surface risks, and identify gaps. Produces a research brief for the Planning agent.
 
-| Agent | Command | Description |
-|-------|---------|-------------|
-| **Init** | `/init` | Initialize or update project context |
-| **Research** | `/research` | Clarify requirements and create research brief |
-| **Planning** | `/plan` | Transform requirements into execution plan |
-| **Executor** | `/execute` | Implement the planned tasks |
-| **Documentation** | `/docs` | Generate project documentation |
-| **Sync** | `/sync` | Reconcile codebase with knowledge base |
+**📋 Planning** — Transforms the research brief into an ordered, actionable execution plan. Breaks work into tasks with dependencies, acceptance criteria, and testing strategy. Ensures the Executor has clear guidance.
 
-## Configuration
+**⚡ Execute** — Implements the planned work. Writes code, adds tests, runs verifications. Updates task metadata and logs execution notes for auditability.
 
-After running the wizard, a `.rrce-workflow.yaml` is created in your project:
+**📄 Docs** — Synthesizes the completed work into documentation. Can generate API docs, architecture overviews, runbooks, or changelogs based on `DOC_TYPE`.
 
-```yaml
-version: 1
+**🔄 Sync** — Maintenance agent that reconciles the knowledge base with actual code. Run periodically to catch drift and keep documentation accurate.
 
+---
+
+## How It Works
+
+### Path Resolution
+
+All agents read `.rrce-workflow/config.yaml` to resolve paths:
+
+```yaml
 storage:
-  mode: global  # or: workspace, both
+  mode: workspace        # or: global, both
+  globalPath: "~/.rrce-workflow"  # optional custom path
 
 project:
   name: "my-project"
 ```
 
-### Storage Modes
+Agents resolve `{{RRCE_DATA}}` based on storage mode:
+- `workspace` → `.rrce-workflow/`
+- `global` → `~/.rrce-workflow/workspaces/my-project/`
+- `both` → `.rrce-workflow/` (primary, synced to global)
 
-| Mode | Location | Use Case |
-|------|----------|----------|
-| `global` | `~/.rrce-workflow/workspaces/<name>/` | Non-intrusive, cross-project access |
-| `workspace` | `.rrce-workflow/` | Portable with repo, team sharing |
-| `both` | Both locations (synced) | Redundancy + cross-project access |
+### Cross-Project References
 
-When `both` is selected, data is stored in **both** locations simultaneously:
-- Primary (for reads): `<workspace>/.rrce-workflow/`
-- Secondary (auto-synced): `~/.rrce-workflow/workspaces/<name>/`
+When using `global` or `both` mode, you can reference other projects:
 
-Each storage location contains:
 ```
-<storage-path>/
-├── knowledge/      # Project context and domain knowledge
-├── prompts/        # Agent prompt files
-├── refs/           # External references
-├── tasks/          # Task artifacts and metadata
-└── templates/      # Output templates
+~/.rrce-workflow/workspaces/other-project/knowledge/project-context.md
+```
+
+This enables a frontend app to reference its backend API's knowledge!
+
+---
+
+## Folder Structure
+
+After setup, your project will have:
+
+```
+your-project/
+├── .rrce-workflow/           # Data storage
+│   ├── config.yaml           # Configuration
+│   ├── knowledge/            # Project context
+│   ├── refs/                 # External references
+│   ├── tasks/                # Task artifacts by slug
+│   └── templates/            # Output templates
+├── .github/agents/           # GitHub Copilot prompts
+│   └── *.agent.md
+└── .agent/workflows/         # Antigravity prompts
+    └── *.md
+```
+
+---
+
+## Wizard Options
+
+When you run the wizard on an already-configured project, you'll see:
+
+| Option | Description |
+|--------|-------------|
+| **Link other project knowledge** | Reference knowledge from other projects in global storage |
+| **Sync to global storage** | Copy workspace data to global (enables cross-project access) |
+| **Update from package** | Get latest prompts and templates |
+
+---
+
+## Storage Mode Comparison
+
+| Mode | Location | Best For |
+|------|----------|----------|
+| `global` | `~/.rrce-workflow/workspaces/<name>/` | Clean workspace, cross-project references |
+| `workspace` | `.rrce-workflow/` | Team sharing, portable with repo |
+| `both` | Both locations (synced) | Full redundancy + cross-project access |
+
+---
+
+## Custom Global Path
+
+If the default `~/.rrce-workflow` isn't writable (common with `npx` in enterprise environments), the wizard lets you choose a custom location:
+
+```yaml
+storage:
+  mode: global
+  globalPath: "/path/to/custom/rrce-workflow"
 ```
 
+---
+
 ## Requirements
 
-- Node.js 18+ or Bun 1.0+
-- Git (for user detection)
+- **Node.js 18+**
+- **Git** (for user detection)
+
+---
+
+## Troubleshooting
+
+### "Permission denied" when setting up
+
+If you can't write to `~/.rrce-workflow`, the wizard will prompt you to choose a custom path. You can also set it manually:
+
+```bash
+export RRCE_HOME=/path/to/writable/location
+npx rrce-workflow
+```
+
+### Agents can't find data files
+
+Make sure the agent reads `.rrce-workflow/config.yaml` first. All prompts include a mandatory first step to resolve paths from the config.
+
+### Updating prompts after package update
+
+```bash
+npx rrce-workflow
+# Select "Update from package"
+```
+
+---
 
 ## License
 

package/agent-core/prompts/documentation.md

@@ -20,6 +20,14 @@ auto-identity:
 
 You are the Documentation Lead for the project. Operate like a senior engineering manager responsible for synthesizing knowledge and preparing smooth handovers.
 
+**⚠️ FIRST STEP (MANDATORY)**
+Before doing ANY work, read `.rrce-workflow/config.yaml` and resolve these variables:
+```
+RRCE_HOME = config.storage.globalPath OR "~/.rrce-workflow"
+RRCE_DATA = (config.storage.mode == "workspace" or "both") ? ".rrce-workflow/" : "${RRCE_HOME}/workspaces/${config.project.name}/"
+```
+Use these resolved paths for ALL subsequent file operations.
+
 Pipeline Position
 - **Optional**: Documentation can be run at any point, but is most valuable after Execution.
 - **Best After**: Executor phase complete (if documenting a specific task).
@@ -48,17 +56,13 @@ Non-Negotiables
 6. Close the loop in `meta.json` when working within a task by setting `agents.documentation.status`, refreshing `checklist`, and updating overall `status`.
 
 Path Resolution
-- Storage mode: Determined by `config.yaml → `storage.mode`` → global config → default (`global`)
-  - `global`: Data in `~/.rrce-workflow/workspaces/<workspace-name>/`
-  - `workspace`: Data in `<workspace>/.rrce-workflow/`
-  - `both`: **Dual storage** - data stored in BOTH locations simultaneously
-    - Primary (for reads): `<workspace>/.rrce-workflow/`
-    - Secondary (auto-synced): `~/.rrce-workflow/workspaces/<workspace-name>/`
-    - When writing, always write to `{{RRCE_DATA}}` - the system ensures both locations stay in sync
-- Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` - **To resolve:** read `.rrce-workflow/config.yaml` → `storage.globalPath`, or default `~/.rrce-workflow`
-- Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
-- Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
+**Config file**: `.rrce-workflow/config.yaml` - Read this first.
+
+**How to resolve `{{RRCE_DATA}}`**:
+1. Read `config.yaml` → get `storage.mode` and `project.name`
+2. Resolve: `workspace` → `.rrce-workflow/` | `global` → `{{RRCE_HOME}}/workspaces/<name>/` | `both` → `.rrce-workflow/`
+
+**How to resolve `{{RRCE_HOME}}`**: `config.yaml` → `storage.globalPath` or default `~/.rrce-workflow`
 
 Cross-Project References
 - Reference another project's context: `{{RRCE_HOME}}/workspaces/<other-project>/knowledge/`

package/agent-core/prompts/executor.md

@@ -16,6 +16,14 @@ auto-identity:
 
 You are the Executor for the project. Operate like a senior individual contributor who ships clean, well-tested code aligned with the orchestrated plan.
 
+**⚠️ FIRST STEP (MANDATORY)**
+Before doing ANY work, read `.rrce-workflow/config.yaml` and resolve these variables:
+```
+RRCE_HOME = config.storage.globalPath OR "~/.rrce-workflow"
+RRCE_DATA = (config.storage.mode == "workspace" or "both") ? ".rrce-workflow/" : "${RRCE_HOME}/workspaces/${config.project.name}/"
+```
+Use these resolved paths for ALL subsequent file operations.
+
 Pipeline Position
 - **Requires**: Planning phase must be complete before execution can begin.
 - **Next Step**: After execution is complete, optionally hand off to `/docs` (Documentation agent).
@@ -52,14 +60,13 @@ Non-Negotiables
 6. Update `meta.json` as you proceed so statuses stay accurate.
 
 Path Resolution
-- **Config file**: `.rrce-workflow/config.yaml` (read this first to resolve paths)
-- Storage mode: Determined by `config.yaml` → `storage.mode` (default: `global`)
-  - `global`: Data in `{{RRCE_HOME}}/workspaces/<workspace-name>/`
-  - `workspace`: Data in `<workspace>/.rrce-workflow/`
-  - `both`: Dual storage - data in BOTH locations
-- Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` - **To resolve:** read `config.yaml` → `storage.globalPath`, or default `~/.rrce-workflow`
-- Workspace name: `{{WORKSPACE_NAME}}` (from `config.yaml` → `project.name`)
+**Config file**: `.rrce-workflow/config.yaml` - Read this first.
+
+**How to resolve `{{RRCE_DATA}}`**:
+1. Read `config.yaml` → get `storage.mode` and `project.name`
+2. Resolve: `workspace` → `.rrce-workflow/` | `global` → `{{RRCE_HOME}}/workspaces/<name>/` | `both` → `.rrce-workflow/`
+
+**How to resolve `{{RRCE_HOME}}`**: `config.yaml` → `storage.globalPath` or default `~/.rrce-workflow`
 
 Cross-Project References
 - Reference another project's context: `{{RRCE_HOME}}/workspaces/<other-project>/knowledge/`

package/agent-core/prompts/init.md

@@ -15,6 +15,14 @@ auto-identity:
 
 You are the Project Initializer for RRCE-Workflow. Operate like a senior architect performing a comprehensive codebase audit to establish foundational context for all downstream agents.
 
+**⚠️ FIRST STEP (MANDATORY)**
+Before doing ANY work, read `.rrce-workflow/config.yaml` (if it exists) and resolve these variables:
+```
+RRCE_HOME = config.storage.globalPath OR "~/.rrce-workflow"
+RRCE_DATA = (config.storage.mode == "workspace" or "both") ? ".rrce-workflow/" : "${RRCE_HOME}/workspaces/${config.project.name}/"
+```
+If config doesn't exist yet (new project), use defaults: `RRCE_HOME=~/.rrce-workflow`, `RRCE_DATA=.rrce-workflow/`
+
 Pipeline Position
 - **Entry Point**: Init can be run at any time to establish or update project context.
 - **Correlation**: Init and Planning work together to maintain project context. Planning may trigger Init updates when significant changes are planned.
@@ -34,18 +42,24 @@ Non-Negotiables
 6. Keep output actionable and scannable; use structured sections.
 
 Path Resolution
-- **Config file**: `.rrce-workflow/config.yaml` (read this first to resolve paths)
-- Storage mode: Determined by `config.yaml` → `storage.mode` (default: `global`)
-  - `global`: Data stored in `{{RRCE_HOME}}/workspaces/<workspace-name>/`
-  - `workspace`: Data stored in `<workspace>/.rrce-workflow/`
-  - `both`: **Dual storage** - data in BOTH locations
-- Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` - **To resolve:**
-  1. Read `.rrce-workflow/config.yaml`
-  2. If `storage.globalPath` exists, use that value
-  3. Otherwise, default to `~/.rrce-workflow`
-- Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
-- Workspace name: `{{WORKSPACE_NAME}}` (from `config.yaml` → `project.name` or directory name)
+**Config file**: `.rrce-workflow/config.yaml` - Read this first to resolve all paths.
+
+**How to resolve `{{RRCE_DATA}}`** (primary data path):
+1. Read `.rrce-workflow/config.yaml`
+2. Get `storage.mode` (default: `global`) and `project.name`
+3. Resolve based on mode:
+   - `workspace` → `<workspace>/.rrce-workflow/`
+   - `global` → `{{RRCE_HOME}}/workspaces/<project.name>/`
+   - `both` → `<workspace>/.rrce-workflow/` (primary), synced to global
+
+**How to resolve `{{RRCE_HOME}}`** (global home):
+1. Read `.rrce-workflow/config.yaml`
+2. If `storage.globalPath` exists, use that value
+3. Otherwise, default to `~/.rrce-workflow`
+
+**Other variables:**
+- `{{WORKSPACE_ROOT}}` = Current workspace directory
+- `{{WORKSPACE_NAME}}` = `config.yaml` → `project.name`
 
 Cross-Project References
 - To reference another project's context: `{{RRCE_HOME}}/workspaces/<other-project-name>/knowledge/`

package/agent-core/prompts/planning_orchestrator.md

@@ -13,6 +13,14 @@ auto-identity:
 
 You are the Planning & Task Orchestrator for the project. Operate like an engineering manager with deep scoped knowledge of this codebase.
 
+**⚠️ FIRST STEP (MANDATORY)**
+Before doing ANY work, read `.rrce-workflow/config.yaml` and resolve these variables:
+```
+RRCE_HOME = config.storage.globalPath OR "~/.rrce-workflow"
+RRCE_DATA = (config.storage.mode == "workspace" or "both") ? ".rrce-workflow/" : "${RRCE_HOME}/workspaces/${config.project.name}/"
+```
+Use these resolved paths for ALL subsequent file operations.
+
 Pipeline Position
 - **Requires**: Research phase must be complete before planning can begin.
 - **Correlation**: Planning works with Init to maintain project context. If planning reveals significant architectural changes, recommend running `/init` to update project context.
@@ -44,17 +52,13 @@ Non-Negotiables
 6. Keep the written plan under 500 lines and reference supporting materials explicitly.
 
 Path Resolution
-- Storage mode: Determined by `config.yaml → `storage.mode`` → global config → default (`global`)
-  - `global`: Data in `~/.rrce-workflow/workspaces/<workspace-name>/`
-  - `workspace`: Data in `<workspace>/.rrce-workflow/`
-  - `both`: **Dual storage** - data stored in BOTH locations simultaneously
-    - Primary (for reads): `<workspace>/.rrce-workflow/`
-    - Secondary (auto-synced): `~/.rrce-workflow/workspaces/<workspace-name>/`
-    - When writing, always write to `{{RRCE_DATA}}` - the system ensures both locations stay in sync
-- Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` - **To resolve:** read `.rrce-workflow/config.yaml` → `storage.globalPath`, or default `~/.rrce-workflow`
-- Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
-- Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
+**Config file**: `.rrce-workflow/config.yaml` - Read this first.
+
+**How to resolve `{{RRCE_DATA}}`**:
+1. Read `config.yaml` → get `storage.mode` and `project.name`
+2. Resolve: `workspace` → `.rrce-workflow/` | `global` → `{{RRCE_HOME}}/workspaces/<name>/` | `both` → `.rrce-workflow/`
+
+**How to resolve `{{RRCE_HOME}}`**: `config.yaml` → `storage.globalPath` or default `~/.rrce-workflow`
 
 Cross-Project References
 - Reference another project's context: `{{RRCE_HOME}}/workspaces/<other-project>/knowledge/`

package/agent-core/prompts/research_discussion.md

@@ -20,6 +20,14 @@ auto-identity:
 
 You are the Research & Discussion Lead for the project. Operate like a staff-level tech lead who owns broad project awareness.
 
+**⚠️ FIRST STEP (MANDATORY)**
+Before doing ANY work, read `.rrce-workflow/config.yaml` and resolve these variables:
+```
+RRCE_HOME = config.storage.globalPath OR "~/.rrce-workflow"
+RRCE_DATA = (config.storage.mode == "workspace" or "both") ? ".rrce-workflow/" : "${RRCE_HOME}/workspaces/${config.project.name}/"
+```
+Use these resolved paths for ALL subsequent file operations.
+
 Pipeline Position
 - **Entry Point**: Research can be the first agent invoked for a new task.
 - **Recommendation**: If `{{RRCE_DATA}}/knowledge/project-context.md` does not exist, recommend running `/init` first for best results, but you may proceed with research if the user prefers.
@@ -38,17 +46,13 @@ Non-Negotiables
 6. Keep the final brief under 500 lines and reference concrete sources whenever possible.
 
 Path Resolution
-- Storage mode: Determined by `config.yaml → `storage.mode`` → global config → default (`global`)
-  - `global`: Data in `~/.rrce-workflow/workspaces/<workspace-name>/`
-  - `workspace`: Data in `<workspace>/.rrce-workflow/`
-  - `both`: **Dual storage** - data stored in BOTH locations simultaneously
-    - Primary (for reads): `<workspace>/.rrce-workflow/`
-    - Secondary (auto-synced): `~/.rrce-workflow/workspaces/<workspace-name>/`
-    - When writing, always write to `{{RRCE_DATA}}` - the system ensures both locations stay in sync
-- Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` - **To resolve:** read `.rrce-workflow/config.yaml` → `storage.globalPath`, or default `~/.rrce-workflow`
-- Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
-- Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
+**Config file**: `.rrce-workflow/config.yaml` - Read this first.
+
+**How to resolve `{{RRCE_DATA}}`**:
+1. Read `config.yaml` → get `storage.mode` and `project.name`
+2. Resolve: `workspace` → `.rrce-workflow/` | `global` → `{{RRCE_HOME}}/workspaces/<name>/` | `both` → `.rrce-workflow/`
+
+**How to resolve `{{RRCE_HOME}}`**: `config.yaml` → `storage.globalPath` or default `~/.rrce-workflow`
 
 Cross-Project References
 - Reference another project's context: `{{RRCE_HOME}}/workspaces/<other-project>/knowledge/`

package/agent-core/prompts/sync.md

@@ -14,6 +14,14 @@ auto-identity:
 
 You are the Knowledge Sync Lead. Act like a senior architect charged with keeping the RRCE knowledge cache authoritative and current.
 
+**⚠️ FIRST STEP (MANDATORY)**
+Before doing ANY work, read `.rrce-workflow/config.yaml` and resolve these variables:
+```
+RRCE_HOME = config.storage.globalPath OR "~/.rrce-workflow"
+RRCE_DATA = (config.storage.mode == "workspace" or "both") ? ".rrce-workflow/" : "${RRCE_HOME}/workspaces/${config.project.name}/"
+```
+Use these resolved paths for ALL subsequent file operations.
+
 Pipeline Position
 - **Maintenance Agent**: Sync runs periodically or after significant codebase changes to keep knowledge current.
 - **Requires**: Init must have been run at least once (project-context.md must exist).
@@ -38,17 +46,13 @@ Non-Negotiables
 5. Record gaps or follow-up items in a checklist inside the file you touched so future runs can close them.
 
 Path Resolution
-- Storage mode: Determined by `config.yaml → `storage.mode`` → global config → default (`global`)
-  - `global`: Data in `~/.rrce-workflow/workspaces/<workspace-name>/`
-  - `workspace`: Data in `<workspace>/.rrce-workflow/`
-  - `both`: **Dual storage** - data stored in BOTH locations simultaneously
-    - Primary (for reads): `<workspace>/.rrce-workflow/`
-    - Secondary (auto-synced): `~/.rrce-workflow/workspaces/<workspace-name>/`
-    - When writing, always write to `{{RRCE_DATA}}` - the system ensures both locations stay in sync
-- Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` - **To resolve:** read `.rrce-workflow/config.yaml` → `storage.globalPath`, or default `~/.rrce-workflow`
-- Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
-- Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
+**Config file**: `.rrce-workflow/config.yaml` - Read this first.
+
+**How to resolve `{{RRCE_DATA}}`**:
+1. Read `config.yaml` → get `storage.mode` and `project.name`
+2. Resolve: `workspace` → `.rrce-workflow/` | `global` → `{{RRCE_HOME}}/workspaces/<name>/` | `both` → `.rrce-workflow/`
+
+**How to resolve `{{RRCE_HOME}}`**: `config.yaml` → `storage.globalPath` or default `~/.rrce-workflow`
 
 Cross-Project References
 - Reference another project's context: `{{RRCE_HOME}}/workspaces/<other-project>/knowledge/`

package/agent-core/templates/documentation_output.md

@@ -1,6 +1,6 @@
 <!--
   RRCE Template Variables:
-  - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow.yaml)
+  - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow/config.yaml)
       - global: {{RRCE_HOME}}/workspaces/<workspace-name>/
       - workspace: <workspace>/.rrce-workflow/
       - both: <workspace>/.rrce-workflow/ (primary, auto-synced to global)

package/agent-core/templates/executor_output.md

@@ -1,6 +1,6 @@
 <!--
   RRCE Template Variables:
-  - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow.yaml)
+  - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow/config.yaml)
       - global: {{RRCE_HOME}}/workspaces/<workspace-name>/
       - workspace: <workspace>/.rrce-workflow/
       - both: <workspace>/.rrce-workflow/ (primary, auto-synced to global)

package/agent-core/templates/init_output.md

@@ -1,6 +1,6 @@
 <!--
   RRCE Template Variables:
-  - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow.yaml)
+  - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow/config.yaml)
       - global: {{RRCE_HOME}}/workspaces/<workspace-name>/
       - workspace: <workspace>/.rrce-workflow/
       - both: <workspace>/.rrce-workflow/ (primary, auto-synced to global)

package/agent-core/templates/planning_output.md

@@ -1,6 +1,6 @@
 <!--
   RRCE Template Variables:
-  - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow.yaml)
+  - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow/config.yaml)
       - global: {{RRCE_HOME}}/workspaces/<workspace-name>/
       - workspace: <workspace>/.rrce-workflow/
       - both: <workspace>/.rrce-workflow/ (primary, auto-synced to global)

package/agent-core/templates/research_output.md

@@ -1,6 +1,6 @@
 <!--
   RRCE Template Variables:
-  - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow.yaml)
+  - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow/config.yaml)
       - global: {{RRCE_HOME}}/workspaces/<workspace-name>/
       - workspace: <workspace>/.rrce-workflow/
       - both: <workspace>/.rrce-workflow/ (primary, auto-synced to global)

package/bin/rrce-workflow.js

@@ -1,2 +1,9 @@
-#!/usr/bin/env bun
-import "../src/index.ts";
+#!/usr/bin/env node
+import { register } from 'node:module';
+import { pathToFileURL } from 'node:url';
+
+// Register tsx for TypeScript support
+register('tsx/esm', pathToFileURL('./'));
+
+// Import and run the main module
+import('../src/index.ts');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rrce-workflow",
-  "version": "0.2.7",
+  "version": "0.2.10",
   "description": "RRCE-Workflow TUI - Agentic code workflow generator for AI-assisted development",
   "author": "RRCE Team",
   "license": "MIT",
@@ -35,22 +35,24 @@
     "bin"
   ],
   "scripts": {
-    "dev": "bun run src/index.ts",
-    "wizard": "bun run src/index.ts wizard",
-    "select": "bun run src/index.ts select",
-    "start": "bun run src/index.ts"
+    "dev": "npx tsx src/index.ts",
+    "wizard": "npx tsx src/index.ts wizard",
+    "select": "npx tsx src/index.ts select",
+    "start": "npx tsx src/index.ts"
   },
   "engines": {
-    "node": ">=18",
-    "bun": ">=1.0"
+    "node": ">=18"
   },
   "dependencies": {
+    "@clack/core": "^0.5.0",
     "@clack/prompts": "^0.11.0",
     "gray-matter": "^4.0.3",
     "picocolors": "^1.1.1",
+    "tsx": "^4.21.0",
     "zod": "^4.2.1"
   },
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3"
   }
 }