dsmolchanov-rpa

RPA - Research, Plan, Act

A collection of Claude Code slash commands for structured software development workflows. These commands help you systematically research codebases, create implementation plans, and execute them with proper verification.

Philosophy

The RPA workflow encourages a methodical approach to software development:

1. Research - Understand the codebase before making changes
2. Plan - Create detailed, phased implementation plans with clear success criteria
3. Act - Implement the plan with continuous verification

This approach reduces errors, improves code quality, and creates documentation that helps with future maintenance.

Commands Overview

Command	Description
/research_codebase	Document and explain the codebase as it exists
/create_plan	Create detailed implementation plans through interactive iteration
/implement_plan	Execute approved plans with verification at each phase
/iterate_plan	Update existing plans based on feedback
/enhance_plan	Synthesize multiple opinions into plan improvements
/enhance_research	Improve research documents with additional findings
/validate_plan	Verify that a plan was correctly implemented
/create_handoff	Create handoff documents to transfer work between sessions
/resume_handoff	Resume work from a handoff document
/tech_debt_sweep	Scan codebase for technical debt and generate paydown plan
/tech_debt_trends	Analyze technical debt trends over time
/aidlc_start	Initialize or resume the AI-DLC compatibility workflow
/aidlc_inception	Execute approved inception stages and generate canonical artifacts
/aidlc_bolt	Execute one construction unit in the AI-DLC workflow
/aidlc_build_test	Run the global Build and Test stage
/aidlc_operations	Generate experimental operations artifacts
/aidlc_feedback	Capture experimental retrospective feedback

Installation

Quick Install (Recommended)

Copy commands, agents, and scripts to your global Claude configuration:

# Create directories if they don't exist
mkdir -p ~/.claude/commands
mkdir -p ~/.claude/agents
mkdir -p ~/.claude/scripts
mkdir -p ~/.claude/hooks

# Copy commands
cp commands/*.md ~/.claude/commands/

# Copy agents (enables parallel sub-agents)
cp agents/*.md ~/.claude/agents/

# Optional: copy the compatibility bootstrap if using AI-DLC workflows
cp CLAUDE.md ~/.claude/CLAUDE-rpa-aidlc.md

# Copy and make scripts executable
cp scripts/*.sh ~/.claude/scripts/
chmod +x ~/.claude/scripts/*.sh

# Optional: Copy hooks for deterministic quality gates
cp hooks/*.json ~/.claude/hooks/

Plugin Install (Alternative)

Install as a Claude Code plugin (adds rpa: prefix to commands):

git clone https://github.com/dsmolchanov/rpa.git
claude plugin install --plugin-dir ./rpa

Verify Installation

After installation, start Claude Code and check that commands are available:

# In Claude Code, these commands should now be available
/research_codebase
/create_plan
/implement_plan
/aidlc_start

Directory Structure

After installation, your ~/.claude/ directory should look like:

~/.claude/
├── commands/
│   ├── research_codebase.md
│   ├── create_plan.md
│   ├── implement_plan.md
│   ├── aidlc_start.md
│   ├── aidlc_inception.md
│   ├── aidlc_bolt.md
│   ├── aidlc_build_test.md
│   ├── aidlc_operations.md
│   ├── aidlc_feedback.md
│   ├── iterate_plan.md
│   ├── enhance_plan.md
│   ├── enhance_research.md
│   ├── validate_plan.md
│   ├── create_handoff.md
│   ├── resume_handoff.md
│   ├── tech_debt_sweep.md     # NEW
│   └── tech_debt_trends.md    # NEW
├── agents/                     # NEW SECTION
│   ├── code-analyzer.md
│   ├── codebase-analyzer.md
│   ├── codebase-locator.md
│   ├── codebase-pattern-finder.md
│   ├── file-analyzer.md
│   ├── parallel-worker.md
│   ├── test-runner.md
│   ├── thoughts-analyzer.md
│   ├── thoughts-locator.md
│   ├── web-search-researcher.md
│   ├── dependency-auditor.md   # NEW
│   ├── debt-scanner.md         # NEW
│   ├── architecture-guard.md   # NEW
│   ├── docs-auditor.md         # NEW
│   ├── config-auditor.md       # NEW
│   ├── uow-decomposer.md       # NEW
│   ├── steering-rules-checker.md # NEW
│   ├── quality-gate-runner.md  # NEW
│   ├── operations-planner.md   # NEW
│   └── feedback-collector.md   # NEW
├── scripts/
│   └── spec_metadata.sh
└── hooks/                      # NEW SECTION
    └── tech-debt-hooks.md

Project Setup

For each project using the legacy RPA workflow, create a thoughts/ directory structure:

mkdir -p thoughts/shared/{research,plans,implementations,handoffs,debt}