Why rp1?¶
Raw prompting works. You can accomplish real development tasks with freeform AI conversations. But as projects grow in complexity and team size, the cracks appear: inconsistent results, lost context, repeated setup, and no audit trail.
rp1 addresses these pain points with structured workflows that execute in a single pass.
The Raw Prompting Problem¶
Raw prompting treats every conversation as a blank slate:
- Context rebuilding: Each session starts fresh. You re-explain your architecture, conventions, and constraints.
- Inconsistent outputs: The same request yields different approaches depending on how you phrase it.
- No memory between tasks: Yesterday's decisions are forgotten. You re-discover the same patterns.
- Hidden rework: What looks like "one prompt" often requires 3-5 iterations to get right.
- Team divergence: Each developer prompts differently, producing inconsistent code styles and patterns.
These friction points compound. What starts as minor inconvenience becomes significant overhead as projects mature.
Side-by-Side Comparison¶
| Dimension | Raw Prompting | With rp1 |
|---|---|---|
| Iterations to complete | 3-5 typical | 1 (single-pass) |
| Context setup per task | Manual each time | Automatic via KB |
| Output consistency | Varies by phrasing | Constitutional constraints |
| Codebase awareness | None / manual context | Built-in knowledge base |
| Audit trail | Chat history only | Structured artifacts |
| Team alignment | Per-developer style | Shared workflows |
Before/After Examples¶
Example 1: Feature Implementation¶
Prompt 1: "Add a dark mode toggle to the settings page"
Response: Generic React component, doesn't match your patterns
Prompt 2: "Actually we use Zustand for state, not Redux"
Response: Rewrites with Zustand, wrong file structure
Prompt 3: "Put it in src/components/settings/, use our Button component"
Response: Better, but tests are missing
Prompt 4: "Add tests using our testing patterns with Vitest"
Response: Tests added, but component doesn't persist preference
Prompt 5: "Store preference in localStorage, check system preference on load"
Response: Finally complete
Result: 5 iterations, 20+ minutes, still may not match team conventions
# One-time setup (already done)
/knowledge-build
# Single command orchestrates the entire workflow
/build dark-mode-toggle
# What happens:
# - KB provides your architecture, patterns, conventions
# - Requirements step clarifies scope upfront
# - Design step creates spec matching your patterns
# - Builder implements with reviewer validation
# - Tests included, style matches codebase
Result: Single pass, structured artifacts, team-consistent output
Example 2: Bug Investigation¶
Prompt 1: "Users report login fails intermittently"
Response: "Could be network issues, session timeout, or auth server"
(Generic suggestions, no codebase context)
Prompt 2: "Here's our auth flow: [paste 200 lines of code]"
Response: "I see a potential race condition in..."
(Context window filling up)
Prompt 3: "What about the token refresh logic?"
Response: "Can you share that code too?"
Prompt 4: [Paste more code, hit context limits]
Response: "Based on what I can see..."
(Lost earlier context)
Result: Fragmented investigation, context thrashing, uncertain conclusions
/code-investigate login-bug "Users report intermittent login failures"
# What happens:
# - KB provides auth architecture understanding
# - Agent systematically traces auth flow
# - Generates hypotheses ranked by likelihood
# - Tests hypotheses against codebase
# - Produces evidence-based findings
Result: Structured investigation, clear findings, reproducible process
When to Use Raw Prompting¶
rp1 covers most development scenarios with dedicated commands:
| Task | rp1 Command |
|---|---|
| Feature development | /build |
| Quick fixes, small tasks | /build-fast |
| PR code review | /pr-review |
| Address PR feedback | /address-pr-feedback |
| Bug investigation | /code-investigate |
| Learning, research, exploration | /deep-research |
Raw prompting remains useful for:
Good candidates for raw prompting
- Non-project conversations: Learning a new language, general CS questions
- Iterative dialogue: When you want back-and-forth refinement
- Outside your codebase: Work unrelated to the current project
- Syntax lookups: Simple "how do I X" questions
rp1 shines when you need:
Good candidates for rp1
- Codebase-aware work: Any task benefiting from KB context
- Team consistency: Multiple developers, shared conventions
- Audit requirements: Traceability from requirements to code
- Reproducible workflows: PR reviews, feature builds, quality checks
- Single-pass execution: Get it right the first time
Rule of thumb: If the task involves your codebase, use rp1.
How Much Time Will You Save?¶
Per Task¶
| Activity | Raw Prompting | With rp1 | Savings |
|---|---|---|---|
| Context setup | 5-10 min | 0 (uses KB) | 5-10 min |
| Iteration cycles | 3-5 rounds | 1 pass | 10-20 min |
| Consistency fixes | 10 min | 0 | 10 min |
| Total per task | 25-40 min | 5-10 min | ~75% faster |
Per Week¶
For a developer running ~8 AI tasks per day (40/week):
| Metric | Raw Prompting | With rp1 | Savings |
|---|---|---|---|
| Time per task | ~32 min | ~8 min | 75% |
| Weekly AI task time | 21 hours | 5 hours | 16 hours |
| % of 40-hour week | 53% | 13% | 40% |
Team Multiplier¶
Benefits scale with team size:
- Shared KB: One knowledge base, all developers benefit
- Consistent patterns: Reduced code review friction
- Onboarding acceleration: New developers inherit team workflows
- Audit trail: Requirements-to-code traceability
Calculate your savings
Get Started¶
Ready to try structured workflows?
- Install rp1: Installation Guide
- Build your knowledge base: Run
/knowledge-buildonce - Try a feature workflow: Feature Development Tutorial
Or start small:
# Review a PR (no setup required)
/pr-review 123
/pr-review https://github.com/org/repo/pull/123
# Quick code check
/code-check
Related¶
- Constitutional Prompting - How rp1 achieves single-pass execution
- Knowledge-Aware Agents - How the KB provides codebase context
- Feature Development - Full workflow tutorial
Ready to Try?¶
Start shipping features without iteration loops.