Issue Description
Add comprehensive "why" documentation for the RPI (Research→Plan→Implement) workflow, explaining the psychology of constraints, time benefits, and when to use strict RPI vs rpi-agent.
Problem
Current RPI documentation explains WHAT the workflow is and HOW to use it, but lacks explanation of WHY the framework works. Users cannot make informed decisions about when to use RPI vs rpi-agent without understanding the underlying principles.
Deliverables
Acceptance Criteria
- Readers understand WHY traditional AI coding fails before learning RPI
- Psychology of constraints is explained (why limiting AI improves output)
- Time/quality comparisons are documented (6-8 hrs → 2-3 hrs)
- Clear guidance on when to use strict RPI vs rpi-agent
- All content follows repository markdown and writing style conventions
Additional Context
Research completed in .copilot-tracking/research/20260105-rpi-why-documentation-research.md with proposed content for all five files.
Issue Description
Add comprehensive "why" documentation for the RPI (Research→Plan→Implement) workflow, explaining the psychology of constraints, time benefits, and when to use strict RPI vs rpi-agent.
Problem
Current RPI documentation explains WHAT the workflow is and HOW to use it, but lacks explanation of WHY the framework works. Users cannot make informed decisions about when to use RPI vs rpi-agent without understanding the underlying principles.
Deliverables
docs/rpi/why-rpi.md- comprehensive "why" document (primary)docs/rpi/README.md- streamline "Why Use RPI?" sectionREADME.md(root) - add problem statement teaserdocs/rpi/using-together.md- expand RPI Agent decision criteriadocs/getting-started/first-workflow.md- add motivation calloutAcceptance Criteria
Additional Context
Research completed in
.copilot-tracking/research/20260105-rpi-why-documentation-research.mdwith proposed content for all five files.