RPI Workflow Skill

This skill helps agents and operators navigate the Research → Plan → Implement (RPI) pattern for systematic software development.

Usage

Invoke this skill when:

• •Starting a new RPI project - Need templates and structure for research/plan artifacts.
• •Transitioning between phases - Ensuring proper handoff criteria are met.
• •Validating artifacts - Checking research.md against FAR criteria or plan.md against FACTS criteria.
• •Understanding phase constraints - Learning what's allowed/forbidden in each phase.

Phase-Specific Guidance

Research Phase:

• •Produce .rpi/projects/<project-id>/research.md following the template.
• •Maintain read-only posture—no solution proposals.
• •Cite all sources inline (e.g., source.md — Section 2).
• •Validate against FAR: Factual, Actionable, Relevant.

Plan Phase:

• •Produce .rpi/projects/<project-id>/plan.md following the template.
• •Reference facts from research.md—no unsupported assumptions.
• •Decompose into atomic tasks with pass/fail verification.
• •Validate against FACTS: Feasible, Atomic, Clear, Testable, Scoped.

Implement Phase:

• •Execute tasks from plan.md sequentially.
• •Mark tasks complete only after verification passes.
• •Halt and recurse to Plan if task is impossible.
• •Create .rpi/projects/<project-id>/SIGNOFF when all tasks complete.

Scripts

RPI Project Scaffolder

Location: .agents/skills/rpi-workflow/scripts/rpi-new.sh

Creates a new RPI project directory structure with sequential prefix numbering.

Usage:

bash .agents/skills/rpi-workflow/scripts/rpi-new.sh "Project Title"

What it does:

• •Validates .rpi/ directory exists in repository root
• •Calculates next sequential prefix (e.g., 0004) by scanning existing directories
• •Creates .rpi/projects/NNNN-project-slug/research.md with standard template
• •Generates URL-friendly slug from project title

Dependencies:

• •Bash shell (standard on macOS/Linux)
• •No Node.js or package manager dependencies

Example:

# Creates .rpi/projects/0004-authentication-refactor/research.md
bash .agents/skills/rpi-workflow/scripts/rpi-new.sh "Authentication Refactor"

Resources

• •Plan Template - Boilerplate structure for plan.md files.
• •Prompt Examples - Sample prompts for phase transitions.
• •Validation Guide - How to check FAR and FACTS criteria.

Technical Notes

This skill works with:

• •Instructions/governance: AGENTS.md (role definitions and handoff rules)
• •Optional directory-scoped governance: .rpi/AGENTS.md

All artifacts are repository-backed and validated by CI (.github/workflows/rpi-validate.yml).