rpi-kit 1.4.1 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +9 -6
- package/.claude-plugin/plugin.json +4 -4
- package/AGENTS.md +2004 -109
- package/CHANGELOG.md +83 -0
- package/README.md +116 -169
- package/agents/atlas.md +61 -0
- package/agents/clara.md +49 -0
- package/agents/forge.md +38 -0
- package/agents/hawk.md +54 -0
- package/agents/luna.md +50 -0
- package/agents/mestre.md +61 -0
- package/agents/nexus.md +63 -0
- package/agents/pixel.md +48 -0
- package/agents/quill.md +40 -0
- package/agents/razor.md +41 -0
- package/agents/sage.md +52 -0
- package/agents/scout.md +49 -0
- package/agents/shield.md +51 -0
- package/bin/cli.js +27 -10
- package/bin/onboarding.js +46 -28
- package/commands/rpi/archive.md +149 -0
- package/commands/rpi/docs.md +106 -168
- package/commands/rpi/implement.md +163 -401
- package/commands/rpi/init.md +150 -67
- package/commands/rpi/learn.md +114 -0
- package/commands/rpi/new.md +85 -155
- package/commands/rpi/onboarding.md +157 -336
- package/commands/rpi/party.md +212 -0
- package/commands/rpi/plan.md +241 -205
- package/commands/rpi/research.md +162 -104
- package/commands/rpi/review.md +350 -104
- package/commands/rpi/rpi.md +125 -0
- package/commands/rpi/simplify.md +156 -93
- package/commands/rpi/status.md +91 -114
- package/package.json +3 -3
- package/skills/rpi-agents/SKILL.md +63 -39
- package/skills/rpi-workflow/SKILL.md +160 -186
- package/agents/code-reviewer.md +0 -40
- package/agents/code-simplifier.md +0 -35
- package/agents/cto-advisor.md +0 -51
- package/agents/doc-synthesizer.md +0 -53
- package/agents/doc-writer.md +0 -36
- package/agents/explore-codebase.md +0 -50
- package/agents/plan-executor.md +0 -48
- package/agents/product-manager.md +0 -52
- package/agents/requirement-parser.md +0 -42
- package/agents/senior-engineer.md +0 -52
- package/agents/test-engineer.md +0 -28
- package/agents/ux-designer.md +0 -47
- package/codex.md +0 -72
- package/commands/rpi/add-todo.md +0 -83
- package/commands/rpi/set-profile.md +0 -124
- package/commands/rpi/test.md +0 -198
|
@@ -1,59 +1,83 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: rpi-agents
|
|
3
|
-
description: This skill should be used when the user asks about
|
|
4
|
-
version: 1.0.1
|
|
5
|
-
license: MIT
|
|
3
|
+
description: This skill should be used when the user asks about RPIKit agents, their roles, or behavior.
|
|
6
4
|
---
|
|
7
5
|
|
|
8
|
-
#
|
|
6
|
+
# RPIKit Agents
|
|
9
7
|
|
|
10
|
-
|
|
8
|
+
## Overview
|
|
11
9
|
|
|
12
|
-
|
|
10
|
+
RPIKit v2 uses 13 named agents with rich personas. Each agent has a distinct personality that shapes how it approaches problems, ensuring diverse perspectives across the development pipeline.
|
|
13
11
|
|
|
14
|
-
|
|
15
|
-
2. **Name unknowns.** If you're uncertain, say what you don't know. Never fill gaps with assumptions.
|
|
16
|
-
3. **Be concrete.** Anti-pattern: "This could improve performance." Instead: "Batching the 3 API calls reduces round-trips from 3 to 1."
|
|
17
|
-
4. **Stay in scope.** Only analyze what's relevant to the feature. Don't audit the entire codebase.
|
|
18
|
-
5. **Structured output.** Use the section format specified for your role. Include your verdict per section.
|
|
12
|
+
## Agent Reference
|
|
19
13
|
|
|
20
|
-
|
|
14
|
+
| Name | Role | Phase | Persona |
|
|
15
|
+
|------|------|-------|---------|
|
|
16
|
+
| Luna | Analyst | Request | Curious, asks uncomfortable questions |
|
|
17
|
+
| Atlas | Codebase Explorer | Research | Methodical, evidence-based |
|
|
18
|
+
| Scout | External Investigator | Research | Skeptical, checks everything |
|
|
19
|
+
| Nexus | Synthesizer/Facilitator | Cross-phase | Diplomatic but decisive |
|
|
20
|
+
| Mestre | Architect | Plan | Pragmatic, hates over-engineering |
|
|
21
|
+
| Clara | Product Manager | Plan | Value-driven, cuts scope |
|
|
22
|
+
| Pixel | UX Designer | Plan (conditional) | Empathetic, user-first |
|
|
23
|
+
| Forge | Executor | Implement | Disciplined, follows plan |
|
|
24
|
+
| Sage | Tester | Implement + Review | Paranoid about edge cases |
|
|
25
|
+
| Razor | Simplifier | Simplify | Minimalist, loves deletion |
|
|
26
|
+
| Hawk | Adversarial Reviewer | Review | Forced to find problems |
|
|
27
|
+
| Shield | Security Sentinel | Review | Professionally paranoid |
|
|
28
|
+
| Quill | Technical Writer | Docs | Clear, concise, WHY not WHAT |
|
|
21
29
|
|
|
22
|
-
|
|
30
|
+
## Agents by Phase
|
|
23
31
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
32
|
+
- **Request:** Luna
|
|
33
|
+
- **Research:** Atlas + Scout -> Nexus (synthesis)
|
|
34
|
+
- **Plan:** Mestre + Clara + Pixel (conditional) -> Nexus (validation)
|
|
35
|
+
- **Implement:** Forge + Sage (if TDD enabled)
|
|
36
|
+
- **Simplify:** Razor
|
|
37
|
+
- **Review:** Hawk + Shield + Sage (parallel) -> Nexus (synthesis)
|
|
38
|
+
- **Docs:** Quill
|
|
39
|
+
- **Party Mode:** Nexus (facilitator) + 3-5 relevant agents
|
|
40
|
+
- **Archive:** Nexus (merge delta into specs)
|
|
27
41
|
|
|
28
|
-
|
|
42
|
+
## Conditional Agents
|
|
29
43
|
|
|
30
|
-
|
|
31
|
-
|
|
44
|
+
**Pixel** only activates when frontend work is detected. Controlled by `.rpi.yaml`:
|
|
45
|
+
|
|
46
|
+
```yaml
|
|
47
|
+
ux_agent: auto # auto | always | never
|
|
32
48
|
```
|
|
33
49
|
|
|
34
|
-
|
|
50
|
+
- `auto` -- Pixel activates when the feature involves UI/frontend components
|
|
51
|
+
- `always` -- Pixel always participates in planning
|
|
52
|
+
- `never` -- Pixel is never activated
|
|
53
|
+
|
|
54
|
+
## Party Mode Agent Selection
|
|
55
|
+
|
|
56
|
+
Nexus selects agents based on the topic:
|
|
57
|
+
|
|
58
|
+
- **Technical topics** -> Mestre + Atlas + Scout
|
|
59
|
+
- **Product topics** -> Clara + Luna + Pixel
|
|
60
|
+
- **Security topics** -> Shield + Hawk + Mestre
|
|
61
|
+
- **Mixed topics** -> Mestre + Clara + Atlas + Shield
|
|
62
|
+
|
|
63
|
+
The number of agents defaults to `party_default_agents` in `.rpi.yaml` (default: 4).
|
|
35
64
|
|
|
36
|
-
##
|
|
65
|
+
## Review Dynamics
|
|
37
66
|
|
|
38
|
-
|
|
67
|
+
Review runs three agents in parallel for independent perspectives:
|
|
39
68
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
| doc-synthesizer | Merge research outputs into RESEARCH.md | Research |
|
|
48
|
-
| explore-codebase | Scan codebase for patterns and context | Research |
|
|
49
|
-
| test-engineer | Write failing tests before implementation (TDD) | Implement (TDD), Test |
|
|
50
|
-
| plan-executor | Implement tasks from PLAN.md surgically | Implement |
|
|
51
|
-
| code-simplifier | Check reuse, quality, efficiency and fix | Implement |
|
|
52
|
-
| code-reviewer | Review implementation against plan | Implement, Review |
|
|
53
|
-
| doc-writer | Generate documentation from artifacts | Docs |
|
|
69
|
+
1. **Hawk** -- adversarial code review (quality, patterns, architecture)
|
|
70
|
+
- Uses 5 perspectives: dev, ops, user, security, business
|
|
71
|
+
- Forced to find problems (zero findings triggers re-analysis)
|
|
72
|
+
- Classifies findings: P1 (blocks) | P2 (should fix) | P3 (nice-to-have)
|
|
73
|
+
2. **Shield** -- security audit (OWASP Top 10, secrets, injection, auth bypass)
|
|
74
|
+
3. **Sage** -- test coverage (untested modules, uncovered paths, missing tests)
|
|
75
|
+
4. **Nexus** -- synthesizes findings into final verdict: PASS | PASS with concerns | FAIL
|
|
54
76
|
|
|
55
|
-
|
|
77
|
+
## Knowledge Compounding
|
|
56
78
|
|
|
57
|
-
|
|
79
|
+
When review agents find problems and the dev fixes them:
|
|
58
80
|
|
|
59
|
-
|
|
81
|
+
1. The solution is auto-saved to `rpi/solutions/{category}/`
|
|
82
|
+
2. Categories are auto-detected: performance, security, database, testing, architecture, patterns, decisions
|
|
83
|
+
3. Scout checks solutions/ in future research phases, preventing repeated mistakes
|
|
@@ -1,245 +1,219 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: rpi-workflow
|
|
3
|
-
description: This skill should be used when the user wants to develop a feature systematically, asks "how do I start a new feature", "walk me through the workflow",
|
|
4
|
-
version: 0.2.0
|
|
5
|
-
license: MIT
|
|
3
|
+
description: This skill should be used when the user wants to develop a feature systematically, asks "how do I start a new feature", "walk me through the workflow", or mentions any RPI command.
|
|
6
4
|
---
|
|
7
5
|
|
|
8
|
-
#
|
|
6
|
+
# RPIKit Workflow
|
|
9
7
|
|
|
10
|
-
|
|
8
|
+
## Overview
|
|
11
9
|
|
|
12
|
-
|
|
10
|
+
RPIKit v2 is a 7-phase pipeline for AI-assisted feature development:
|
|
11
|
+
request -> research -> plan -> implement -> simplify -> review -> docs
|
|
13
12
|
|
|
14
|
-
|
|
15
|
-
Run `/rpi:init` once per project to configure:
|
|
16
|
-
- Feature folder location (default: `rpi/`)
|
|
17
|
-
- Default research tier
|
|
18
|
-
- Parallel threshold, commit style, and other preferences
|
|
19
|
-
- Creates `.rpi.yaml` at project root
|
|
13
|
+
Each phase produces artifacts that feed the next, with named agents driving each step.
|
|
20
14
|
|
|
21
|
-
|
|
22
|
-
Run `/rpi:new` to start. Adaptive interview:
|
|
23
|
-
- Start with core questions: what feature, what problem it solves
|
|
24
|
-
- Ask follow-ups based on answers (who uses it, complexity, constraints, references)
|
|
25
|
-
- Set up isolation based on `isolation` config:
|
|
26
|
-
- `none`: work on current branch
|
|
27
|
-
- `branch`: `git checkout -b feature/{slug}`
|
|
28
|
-
- `worktree`: create `.worktrees/{slug}` with `git worktree add`
|
|
29
|
-
- Generate `{folder}/{feature-slug}/REQUEST.md` with structured sections
|
|
15
|
+
## Quick Start
|
|
30
16
|
|
|
31
|
-
|
|
17
|
+
1. `/rpi:init` -- configure RPIKit for your project
|
|
18
|
+
2. `/rpi:new my-feature` -- start a feature (Luna interviews you)
|
|
19
|
+
3. `/rpi my-feature` -- auto-progress through phases
|
|
32
20
|
|
|
33
|
-
|
|
34
|
-
Run `/rpi:research {feature-slug}` with optional tier flag.
|
|
21
|
+
## Phases
|
|
35
22
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
23
|
+
| Phase | Command | Agents | Artifacts |
|
|
24
|
+
|-------|---------|--------|-----------|
|
|
25
|
+
| Request | /rpi:new | Luna | REQUEST.md |
|
|
26
|
+
| Research | /rpi:research | Atlas, Scout, Nexus | RESEARCH.md |
|
|
27
|
+
| Plan | /rpi:plan | Mestre, Clara, Pixel, Nexus | PLAN.md, eng.md, pm.md, ux.md, delta/ |
|
|
28
|
+
| Implement | /rpi:implement | Forge, Sage | IMPLEMENT.md |
|
|
29
|
+
| Simplify | /rpi:simplify | Razor | code changes |
|
|
30
|
+
| Review | /rpi:review | Hawk, Shield, Sage, Nexus | review verdict |
|
|
31
|
+
| Docs | /rpi:docs | Quill | README, changelog |
|
|
40
32
|
|
|
41
|
-
|
|
33
|
+
## Auto-Flow
|
|
42
34
|
|
|
43
|
-
|
|
44
|
-
1. Executive Summary (5 lines: verdict, complexity, risk, recommendation, key finding)
|
|
45
|
-
2. Requirements Analysis
|
|
46
|
-
3. Product Scope
|
|
47
|
-
4. Codebase Context
|
|
48
|
-
5. Technical Analysis
|
|
49
|
-
6. Strategic Assessment (deep tier only)
|
|
50
|
-
7. Alternatives (mandatory if NO-GO)
|
|
35
|
+
`/rpi {feature}` detects the current phase and runs the next one automatically:
|
|
51
36
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
Adaptive artifact generation:
|
|
60
|
-
- Always: PLAN.md (task checklist) + eng.md (technical spec)
|
|
61
|
-
- Adaptive: pm.md (user stories) and ux.md (user flows) — generated based on feature type
|
|
62
|
-
- After research, asks user to confirm which artifacts to generate
|
|
63
|
-
|
|
64
|
-
PLAN.md task format:
|
|
65
|
-
```markdown
|
|
66
|
-
## Phase 1: Phase Name
|
|
67
|
-
|
|
68
|
-
- [ ] **1.1** Task description
|
|
69
|
-
Effort: S | Deps: none
|
|
70
|
-
Files: src/path/to/file.ts
|
|
71
|
-
Test: returns 200 for valid request with auth token
|
|
72
|
-
|
|
73
|
-
- [ ] **1.2** Another task
|
|
74
|
-
Effort: M | Deps: 1.1
|
|
75
|
-
Files: src/other/file.ts
|
|
76
|
-
Test: rejects duplicate entries with 409 conflict
|
|
37
|
+
```
|
|
38
|
+
/rpi oauth -> has REQUEST.md? -> Phase 2: Research
|
|
39
|
+
/rpi oauth -> has RESEARCH.md? -> Phase 3: Plan
|
|
40
|
+
/rpi oauth -> has PLAN.md? -> Phase 4: Implement
|
|
41
|
+
/rpi oauth -> has IMPLEMENT.md? -> Phase 5: Simplify
|
|
42
|
+
/rpi oauth -> simplify done? -> Phase 6: Review
|
|
43
|
+
/rpi oauth -> review PASS? -> Phase 7: Docs
|
|
77
44
|
```
|
|
78
45
|
|
|
79
|
-
|
|
80
|
-
Run `/rpi:test {feature-slug}` to run TDD cycles on individual tasks.
|
|
81
|
-
|
|
82
|
-
- Works independently of `/rpi:implement` — use when you want TDD on specific tasks
|
|
83
|
-
- Strict RED → GREEN → REFACTOR per task, one test at a time
|
|
84
|
-
- Auto-detects test framework and conventions from the project
|
|
85
|
-
- Flags: `--task <id>` for single task, `--all` for all uncompleted tasks
|
|
86
|
-
|
|
87
|
-
### Phase 4: Implement
|
|
88
|
-
Run `/rpi:implement {feature-slug}`.
|
|
89
|
-
|
|
90
|
-
Smart execution mode:
|
|
91
|
-
- < 8 tasks: single plan-executor agent, sequential
|
|
92
|
-
- 8+ tasks: group into waves by dependency, execute in parallel
|
|
93
|
-
- Override: `--sequential` or `--parallel` flags
|
|
46
|
+
If the feature does not exist: `Feature 'oauth' not found. Run /rpi:new oauth to start.`
|
|
94
47
|
|
|
95
|
-
|
|
96
|
-
1. Execute tasks → commit per task
|
|
97
|
-
- If TDD enabled: RED (write failing test) → VERIFY RED → GREEN (minimal code) → VERIFY GREEN → REFACTOR → commit
|
|
98
|
-
- If TDD disabled: execute task → commit (original behavior)
|
|
99
|
-
2. Simplify (3 parallel sub-agents: reuse, quality, efficiency)
|
|
100
|
-
3. Review (code-reviewer checks against plan + test coverage)
|
|
101
|
-
4. Phase verdict: PASS or FAIL
|
|
48
|
+
## Escape Hatches
|
|
102
49
|
|
|
103
|
-
|
|
50
|
+
Run a specific phase directly:
|
|
104
51
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
52
|
+
```
|
|
53
|
+
/rpi:research oauth -- force (re)run research
|
|
54
|
+
/rpi:plan oauth -- force (re)generate plan
|
|
55
|
+
/rpi:implement oauth -- force (re)implement
|
|
56
|
+
/rpi:simplify oauth -- force simplify
|
|
57
|
+
/rpi:review oauth -- force review
|
|
58
|
+
/rpi:docs oauth -- force docs
|
|
59
|
+
```
|
|
109
60
|
|
|
110
|
-
##
|
|
61
|
+
## Global Flags
|
|
111
62
|
|
|
112
|
-
```yaml
|
|
113
|
-
folder: rpi # Feature folder location
|
|
114
|
-
tier: standard # Default research tier
|
|
115
|
-
commit_style: conventional # Commit message format
|
|
116
|
-
parallel_threshold: 8 # Task count for parallel mode
|
|
117
|
-
skip_artifacts: [] # Artifacts to never generate
|
|
118
|
-
isolation: none # none | branch | worktree
|
|
119
|
-
tdd: false # Enable Test-Driven Development
|
|
120
|
-
test_runner: auto # Test command (auto-detect or explicit)
|
|
121
|
-
session_isolation: auto # auto | aggressive | off
|
|
122
|
-
max_tasks_per_session: 5 # tasks before warning/checkpoint
|
|
123
|
-
profile: balanced # quality-first | balanced | speed-first | budget (optional)
|
|
124
|
-
models: # Per-phase overrides (optional, takes precedence over profile)
|
|
125
|
-
# research: opus
|
|
126
|
-
# plan: opus
|
|
127
|
-
# implement: sonnet
|
|
128
|
-
# review: opus
|
|
129
63
|
```
|
|
64
|
+
--quick -- quick flow (skip research + full plan)
|
|
65
|
+
--skip=phase -- skip specific phase(s)
|
|
66
|
+
--force -- re-run phase even if artifacts exist
|
|
67
|
+
--from=phase -- start from a specific phase
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Quick Flow
|
|
130
71
|
|
|
131
|
-
|
|
72
|
+
`/rpi:new my-feature --quick` triggers a streamlined pipeline for small (S) features:
|
|
132
73
|
|
|
133
|
-
|
|
74
|
+
1. Luna asks 1-2 quick questions, produces compact REQUEST.md
|
|
75
|
+
2. Skip research + full plan
|
|
76
|
+
3. Forge receives REQUEST.md + context.md directly
|
|
77
|
+
4. Forge generates mini-plan inline (3-5 tasks max)
|
|
78
|
+
5. Implements task by task
|
|
79
|
+
6. Razor does quick simplify
|
|
80
|
+
7. Skip formal review (lint/tests only)
|
|
81
|
+
8. Quill updates docs if needed
|
|
134
82
|
|
|
135
|
-
|
|
83
|
+
**Auto-trigger:** Luna estimates complexity S and suggests quick flow.
|
|
84
|
+
**Safeguard:** If Forge detects complexity > S during implement, it stops and suggests running full research + plan.
|
|
136
85
|
|
|
137
|
-
|
|
138
|
-
2. **Profile default**: If `.rpi.yaml` has a `profile` value, look up the model for this phase in the profile table below.
|
|
139
|
-
3. **Inherit parent**: If neither is set, omit the `model` parameter entirely. The agent inherits the parent session's model (current default behavior).
|
|
86
|
+
## Delta Specs
|
|
140
87
|
|
|
141
|
-
|
|
88
|
+
Delta specs capture only what changes, not the full system state.
|
|
142
89
|
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
90
|
+
- `rpi/specs/` -- source of truth for current system state
|
|
91
|
+
- `rpi/features/{slug}/delta/` -- what changes for this feature
|
|
92
|
+
- `ADDED/` -- new spec files
|
|
93
|
+
- `MODIFIED/` -- changes to existing specs
|
|
94
|
+
- `REMOVED/` -- specs being deleted
|
|
95
|
+
- `/rpi:archive` merges delta into specs and cleans up the feature folder
|
|
149
96
|
|
|
150
|
-
|
|
151
|
-
Research quality may degrade with haiku -- research agents require structured
|
|
152
|
-
analysis with citations and evidence. Recommended for small or simple features only.
|
|
97
|
+
Flow: research creates baseline from existing specs, plan creates delta, archive merges delta back into specs.
|
|
153
98
|
|
|
154
|
-
|
|
99
|
+
## Knowledge Compounding
|
|
155
100
|
|
|
156
|
-
|
|
157
|
-
|-------|----------|
|
|
158
|
-
| `research` | `/rpi:research` |
|
|
159
|
-
| `plan` | `/rpi:plan` |
|
|
160
|
-
| `implement` | `/rpi:implement`, `/rpi:test`, `/rpi:simplify` |
|
|
161
|
-
| `review` | `/rpi:review`, `/rpi:docs` |
|
|
101
|
+
RPIKit builds a persistent knowledge base that grows with every feature.
|
|
162
102
|
|
|
163
|
-
|
|
103
|
+
- `rpi/solutions/` -- organized by category (performance/, security/, database/, testing/, architecture/, patterns/, decisions/)
|
|
104
|
+
- **Auto-saved:** during review, when Hawk/Shield find problems and the dev fixes them
|
|
105
|
+
- **Manual:** `/rpi:learn` -- Nexus asks what you learned and generates a solution doc
|
|
106
|
+
- **Reuse:** Scout checks solutions/ before external research and includes relevant solutions in RESEARCH.md
|
|
164
107
|
|
|
165
|
-
|
|
108
|
+
Solution format:
|
|
166
109
|
|
|
167
|
-
|
|
110
|
+
```markdown
|
|
111
|
+
# {Title}
|
|
168
112
|
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
- Omit the `model` parameter (inherit parent model).
|
|
172
|
-
- Do NOT stop execution.
|
|
113
|
+
## Problem
|
|
114
|
+
{symptoms, how it manifests}
|
|
173
115
|
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
- Treat all phases as "inherit parent".
|
|
116
|
+
## Solution
|
|
117
|
+
{code, approach, what worked}
|
|
177
118
|
|
|
178
|
-
|
|
119
|
+
## Prevention
|
|
120
|
+
{how to avoid in the future}
|
|
179
121
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
122
|
+
## Context
|
|
123
|
+
Feature: {slug} | Date: {YYYY-MM-DD}
|
|
124
|
+
Files: {list}
|
|
183
125
|
```
|
|
184
126
|
|
|
185
|
-
|
|
127
|
+
## Party Mode
|
|
186
128
|
|
|
187
|
-
|
|
129
|
+
`/rpi:party "topic"` -- multi-agent debate on any topic.
|
|
188
130
|
|
|
189
131
|
```
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
├── research/
|
|
193
|
-
│ └── RESEARCH.md
|
|
194
|
-
├── plan/
|
|
195
|
-
│ ├── PLAN.md
|
|
196
|
-
│ ├── pm.md (adaptive)
|
|
197
|
-
│ ├── ux.md (adaptive)
|
|
198
|
-
│ └── eng.md
|
|
199
|
-
└── implement/
|
|
200
|
-
├── IMPLEMENT.md
|
|
201
|
-
├── checkpoints/ (per-task status files)
|
|
202
|
-
└── sessions/ (session boundary records)
|
|
132
|
+
/rpi:party "GraphQL vs REST for the API?"
|
|
133
|
+
/rpi:party oauth "how to handle token refresh?"
|
|
203
134
|
```
|
|
204
135
|
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
136
|
+
1. Nexus analyzes the topic and selects 3-5 relevant agents
|
|
137
|
+
2. Each agent responds in character with their perspective
|
|
138
|
+
3. Nexus identifies consensus and divergence points
|
|
139
|
+
4. If divergence: Nexus asks each agent to respond to the opposing argument
|
|
140
|
+
5. Nexus synthesizes final recommendation with trade-offs
|
|
208
141
|
|
|
209
|
-
|
|
142
|
+
Output is saved to `rpi/solutions/decisions/` when requested.
|
|
210
143
|
|
|
211
|
-
|
|
144
|
+
## Utility Commands
|
|
212
145
|
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
146
|
+
```
|
|
147
|
+
/rpi:init -- configure RPIKit + generate context.md
|
|
148
|
+
/rpi:status -- view all features and their current phase
|
|
149
|
+
/rpi:party -- multi-agent debate on any topic
|
|
150
|
+
/rpi:learn -- manually capture a solution/insight
|
|
151
|
+
/rpi:archive -- merge delta into specs, delete feature folder
|
|
152
|
+
/rpi:onboarding -- first-time setup, analyzes codebase, guides the user
|
|
153
|
+
```
|
|
218
154
|
|
|
219
|
-
|
|
155
|
+
## Configuration
|
|
220
156
|
|
|
221
|
-
|
|
157
|
+
`.rpi.yaml` reference:
|
|
222
158
|
|
|
223
|
-
|
|
159
|
+
```yaml
|
|
160
|
+
version: 2
|
|
224
161
|
|
|
225
|
-
|
|
162
|
+
# Directories
|
|
163
|
+
folder: rpi/features
|
|
164
|
+
specs_dir: rpi/specs
|
|
165
|
+
solutions_dir: rpi/solutions
|
|
166
|
+
context_file: rpi/context.md
|
|
226
167
|
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
- **scope** (did more/less): blocks for human decision
|
|
168
|
+
# Execution
|
|
169
|
+
commit_style: conventional
|
|
170
|
+
tdd: false
|
|
231
171
|
|
|
232
|
-
|
|
172
|
+
# Conditional agents
|
|
173
|
+
ux_agent: auto # auto | always | never
|
|
233
174
|
|
|
234
|
-
|
|
175
|
+
# Quick flow
|
|
176
|
+
quick_complexity: S
|
|
235
177
|
|
|
236
|
-
|
|
178
|
+
# Knowledge compounding
|
|
179
|
+
auto_learn: true
|
|
237
180
|
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
- Multiple features can be in progress simultaneously
|
|
181
|
+
# Party mode
|
|
182
|
+
party_default_agents: 4
|
|
183
|
+
```
|
|
242
184
|
|
|
243
|
-
##
|
|
185
|
+
## Directory Structure
|
|
244
186
|
|
|
245
|
-
|
|
187
|
+
```
|
|
188
|
+
rpi/
|
|
189
|
+
├── context.md
|
|
190
|
+
├── specs/
|
|
191
|
+
│ ├── auth/
|
|
192
|
+
│ │ └── session-management.md
|
|
193
|
+
│ └── payments/
|
|
194
|
+
│ └── stripe-checkout.md
|
|
195
|
+
├── solutions/
|
|
196
|
+
│ ├── performance/
|
|
197
|
+
│ ├── security/
|
|
198
|
+
│ ├── database/
|
|
199
|
+
│ ├── testing/
|
|
200
|
+
│ ├── architecture/
|
|
201
|
+
│ ├── patterns/
|
|
202
|
+
│ └── decisions/
|
|
203
|
+
└── features/
|
|
204
|
+
└── {slug}/
|
|
205
|
+
├── REQUEST.md
|
|
206
|
+
├── research/
|
|
207
|
+
│ └── RESEARCH.md
|
|
208
|
+
├── delta/
|
|
209
|
+
│ ├── ADDED/
|
|
210
|
+
│ ├── MODIFIED/
|
|
211
|
+
│ └── REMOVED/
|
|
212
|
+
├── plan/
|
|
213
|
+
│ ├── PLAN.md
|
|
214
|
+
│ ├── eng.md
|
|
215
|
+
│ ├── pm.md
|
|
216
|
+
│ └── ux.md
|
|
217
|
+
└── implement/
|
|
218
|
+
└── IMPLEMENT.md
|
|
219
|
+
```
|
package/agents/code-reviewer.md
DELETED
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: code-reviewer
|
|
3
|
-
description: Review implementation against plan. Output PASS or FAIL. Spawned by /rpi:implement and /rpi:review.
|
|
4
|
-
tools: Read, Glob, Grep
|
|
5
|
-
color: bright-red
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
<role>
|
|
9
|
-
Review implementation against PLAN.md. Every finding traceable to a requirement.
|
|
10
|
-
</role>
|
|
11
|
-
|
|
12
|
-
<priorities>
|
|
13
|
-
1. Read: REQUEST.md, RESEARCH.md, PLAN.md, eng.md, IMPLEMENT.md, pm.md/ux.md
|
|
14
|
-
2. Cite PLAN.md, pm.md, eng.md, or ux.md in every finding
|
|
15
|
-
3. No style nitpicks. Check:
|
|
16
|
-
- Completeness: every PLAN.md task maps to code/tests
|
|
17
|
-
- Correctness: matches eng.md, acceptance criteria, UX flow
|
|
18
|
-
- Deviations: IMPLEMENT.md notes vs actual changes
|
|
19
|
-
- Risks: bugs, security, missing error handling, missing tests
|
|
20
|
-
4. PASS only if complete with no unjustified deviations or critical issues
|
|
21
|
-
5. FAIL lists actionable gaps
|
|
22
|
-
</priorities>
|
|
23
|
-
|
|
24
|
-
<output_format>
|
|
25
|
-
## Review: {feature-slug}
|
|
26
|
-
|
|
27
|
-
### Verdict: {PASS|FAIL}
|
|
28
|
-
|
|
29
|
-
### Completeness ({completed}/{total} tasks)
|
|
30
|
-
- Task {id}: {DONE|MISSING} — {details}
|
|
31
|
-
|
|
32
|
-
### Correctness
|
|
33
|
-
- {finding with file:line reference and plan citation}
|
|
34
|
-
|
|
35
|
-
### Deviations
|
|
36
|
-
- {deviation}: {justified|unjustified} — {reason}
|
|
37
|
-
|
|
38
|
-
### Issues
|
|
39
|
-
- [{CRITICAL|WARNING}] {file}:{line} — {description}. Required by: {plan reference}
|
|
40
|
-
</output_format>
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: code-simplifier
|
|
3
|
-
description: Review and fix reuse, quality, and efficiency issues in new code. Spawned by /rpi:implement and /rpi:simplify.
|
|
4
|
-
tools: Read, Write, Edit, Bash, Glob, Grep, Agent
|
|
5
|
-
color: white
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
<role>
|
|
9
|
-
Review new code for reuse, quality, and efficiency. Fix worthwhile issues directly.
|
|
10
|
-
</role>
|
|
11
|
-
|
|
12
|
-
<priorities>
|
|
13
|
-
1. Scope: files changed during implementation (read IMPLEMENT.md + diff)
|
|
14
|
-
2. Three checks (parallel sub-agents only if meaningfully faster):
|
|
15
|
-
- Reuse: duplicated logic that should call an existing utility
|
|
16
|
-
- Quality: hacky patterns, copy-paste variation, parameter sprawl, leaky abstractions
|
|
17
|
-
- Efficiency: unnecessary work, missed concurrency, hot-path bloat, TOCTOU, leaks
|
|
18
|
-
3. Flag reuse only when an existing utility fits
|
|
19
|
-
4. Fix valid issues directly; skip false positives silently
|
|
20
|
-
5. No new abstractions to "simplify"
|
|
21
|
-
6. Re-run tests after edits
|
|
22
|
-
7. Report counts and fixes by file
|
|
23
|
-
</priorities>
|
|
24
|
-
|
|
25
|
-
<output_format>
|
|
26
|
-
Simplify: {feature-slug}
|
|
27
|
-
- Reuse: {N found}, {M fixed}
|
|
28
|
-
- Quality: {N found}, {M fixed}
|
|
29
|
-
- Efficiency: {N found}, {M fixed}
|
|
30
|
-
|
|
31
|
-
Fixes applied:
|
|
32
|
-
- {file}: {change}
|
|
33
|
-
|
|
34
|
-
Or: `Code is clean - no issues found.`
|
|
35
|
-
</output_format>
|
package/agents/cto-advisor.md
DELETED
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: cto-advisor
|
|
3
|
-
description: Assess strategic fit, risk, and long-term implications. Spawned by /rpi:research (deep).
|
|
4
|
-
tools: Read, Glob, Grep
|
|
5
|
-
color: red
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
<role>
|
|
9
|
-
Assess strategic fit, risk, maintenance cost, and reversibility with concrete evidence.
|
|
10
|
-
</role>
|
|
11
|
-
|
|
12
|
-
<priorities>
|
|
13
|
-
1. Quantify risk: probability x impact
|
|
14
|
-
2. Ground claims in codebase evidence or dependency data
|
|
15
|
-
3. Describe architectural conflicts precisely
|
|
16
|
-
4. Always offer at least one alternative
|
|
17
|
-
5. Maintenance burden: files, dependencies, surface area
|
|
18
|
-
6. Evaluate reversibility and blast radius
|
|
19
|
-
</priorities>
|
|
20
|
-
|
|
21
|
-
<output_format>
|
|
22
|
-
## [CTO Advisor]
|
|
23
|
-
|
|
24
|
-
### Strategic Alignment
|
|
25
|
-
Verdict: GO | CONCERN | BLOCK
|
|
26
|
-
{How this aligns with project direction, with evidence.}
|
|
27
|
-
|
|
28
|
-
### Risk Assessment
|
|
29
|
-
Verdict: GO | CONCERN | BLOCK
|
|
30
|
-
|
|
31
|
-
| Risk | Probability | Impact | Level | Mitigation |
|
|
32
|
-
|------|-------------|--------|-------|------------|
|
|
33
|
-
| {risk} | low/med/high | low/med/high | {P x I} | {mitigation} |
|
|
34
|
-
|
|
35
|
-
### Maintenance Burden
|
|
36
|
-
- New files: {N}
|
|
37
|
-
- New dependencies: {M}
|
|
38
|
-
- New API surface: {routes, endpoints, jobs, commands}
|
|
39
|
-
- Ongoing cost: {what must be maintained}
|
|
40
|
-
|
|
41
|
-
### Reversibility
|
|
42
|
-
{How hard it is to roll back and what the blast radius is.}
|
|
43
|
-
|
|
44
|
-
### Alternatives
|
|
45
|
-
1. **{alternative}**: {description} — Pros: {pros}. Cons: {cons}.
|
|
46
|
-
|
|
47
|
-
### Recommendation
|
|
48
|
-
{Clear recommendation with reasoning.}
|
|
49
|
-
|
|
50
|
-
Estimated Complexity: S | M | L | XL
|
|
51
|
-
</output_format>
|