rpi

Context Engineering Workflows

Structured, multi-phase workflows for Claude Code that separate research from solutioning. Two pipelines available:

• DW (Deep Work) — 6-phase pipeline with bias firewall: research questions → research → design discussion → outline → plan → implement
• RPI (Research-Plan-Implement) — Streamlined 3-phase pipeline: research → plan → implement

Both pipelines produce durable artifacts at ~/notes/context-engineering/<repo>/<slug>/ and dispatch fresh subagents per task with two-stage review (spec compliance → code quality).

Installation

Option 1: Raw Install (copy to ~/.claude/)

git clone [email protected]:ronsanzone/context-engineering-workflows.git ~/code/context-engineering-workflows
cd ~/code/context-engineering-workflows

# Install everything
./install.sh

# Or install one pipeline
./install.sh rpi    # RPI skills + shared agents
./install.sh dw     # DW skills + shared agents

Skills are copied to ~/.claude/skills/ and agents to ~/.claude/agents/. To update, pull and re-run ./install.sh.

Option 2: Claude Code Plugin Marketplace

# Add the marketplace (one-time)
/plugin marketplace add ronsanzone/context-engineering-workflows

# Install one or both pipelines
/plugin install rpi@context-engineering-workflows
/plugin install dw@context-engineering-workflows

To update, run /plugin marketplace update context-engineering-workflows, then reinstall.

Usage

RPI Pipeline

/rpi-research <slug> <research query>    # Investigate the codebase
/rpi-plan <slug>                         # Interactive plan creation (4 gates)
/rpi-implement <slug>                    # Execute the plan with subagents

DW Pipeline

/dw-01-research-questions <slug>         # Decompose task into research questions
/dw-02-research <slug>                   # Investigate (bias firewall — no prompt access)
/dw-03-design-discussion <slug>          # Explore design options
/dw-04-outline <slug>                    # Map decisions to file changes
/dw-05-plan <slug>                       # Detailed implementation plan + adversarial review
/dw-06-implement <slug>                  # Execute the plan

Each DW phase runs in a fresh conversation for context isolation.

Included Agents

Both pipelines use these specialized subagents:

Agent	Purpose
codebase-analyzer	Traces data flow, explains how code works, produces file:line-cited writeups
codebase-locator	Finds where code lives — returns categorized file inventories
codebase-pattern-finder	Finds similar implementations to model after — returns ready-to-copy snippets

Repo Structure

skills/                     # Source of truth — edit here
├── shared/setup.sh         # Artifact directory resolution (co-located into each skill at install)
├── deep-work/              # Pipeline overview (docs-only)
├── dw-*/                   # DW pipeline phases
└── rpi-*/                  # RPI pipeline phases

agents/                     # Source of truth — edit here
├── codebase-analyzer.md
├── codebase-locator.md
└── codebase-pattern-finder.md

plugins/                    # Generated — do not edit
├── dw/                     # Marketplace plugin for DW
└── rpi/                    # Marketplace plugin for RPI

scripts/sync-plugins.sh     # Regenerates plugins/ from source
install.sh                  # Raw install to ~/.claude/

Contributing

Edit files in skills/ and agents/ only. The plugins/ directory is generated by scripts/sync-plugins.sh and auto-staged by a pre-commit hook.

After cloning, configure the hook:

git config core.hooksPath .githooks