frmoretto/stream-coding
Stop "vibe coding" and start Stream Coding, the 10-20x velocity methodology for AI-accelerated development. Includes the official SKILL.md for Claude/Cursor/Windsurf and the complete Manifesto.
npx skills add frmoretto/stream-codingREADME
Stream Coding v3.4
The 10-20x Methodology for AI-Accelerated Software Development
📢 v3.4 Update: Complete 13-item Clarity Gate (was 5 items), scoring rubric, Documentation Audit. Re-download if using older version.
âś… This methodology built 7 production modules in 4.5 hours (5Levels Case Study, Git-verified)
"Stream coding isn't about faster coding. It's about documentation so clear that code writes itself."
The Problem: The Velocity Mirage
AI tools promise 10x productivity. GitHub Copilot, Cursor, Claude Code—they make coding 55% faster.
But projects still take the same time to ship.
Why? Because faster typing doesn't solve:
- Strategic decisions AI can't make for you
- Context that gets lost between prompts
- Technical debt created at 10x speed
This gap between task velocity and project velocity is the Velocity Mirage.
The Solution: Stream Coding
Stream Coding is a documentation-first methodology that makes AI-generated code deterministic.
The 40/40/20 Split:
- 40% Strategic Thinking (Phase 1) — Solve hard problems before coding
- 40% AI-Ready Documentation (Phase 2) — Specs so complete AI has zero decisions
- 20% Execution + Quality (Phases 3-4) — Code streams out automatically
Real Results (5Levels Case Study):
- 7 production modules in 4.5 hours
- 46 intelligence endpoints (77 total backend API)
- Zero bugs in generated code, 21 minutes average per tested module
Note: The case study focuses on backend intelligence modules—Stream Coding's sweet spot. For frontend, use the methodology for behavior (components, state, logic) and complement with AI design tools for visuals. See Chapter 4 for details.
Quick Start
Option 1: Claude.ai / Claude Desktop
- Download
stream-coding.skill - Go to Settings → Features → Skills → Add
- Upload the
.skillfile - Ask Claude: "Build a user authentication system"
Option 2: Claude Code
Clone the repo — Claude Code auto-detects skills in .claude/skills/:
git clone https://github.com/frmoretto/stream-coding
cd stream-coding
# Claude Code will automatically detect .claude/skills/stream-coding/SKILL.md
Or copy .claude/skills/stream-coding/ to your project's .claude/skills/ directory.
Ask Claude: "Build a user authentication system"
Option 3: Claude Projects
Add SKILL.md to project knowledge. Claude will search it when needed, though Skills provide better integration.
Option 4: OpenAI Codex / GitHub Copilot
Copy the canonical skill to the appropriate directory:
| Platform | Location |
|---|---|
| OpenAI Codex | .codex/skills/stream-coding/SKILL.md |
| GitHub Copilot | .github/skills/stream-coding/SKILL.md |
Use skills/stream-coding/SKILL.md (agentskills.io format).
Option 5: Manual / Other LLMs
For Cursor, Windsurf, or other AI tools:
- Extract core principles (Phases, Document Types, Clarity Gate)
- Create a condensed version for
.cursorrulesor project settings - Use the templates and Clarity Gate Checklist as reference
The methodology is tool-agnostic—only SKILL.md is Claude-optimized.
Read the Manifesto
The /manifesto folder contains the complete methodology:
| Chapter | Topic |
|---|---|
| Chapter 1 | The Velocity Mirage |
| Chapter 2 | Why AI Tools Alone Fail |
| Chapter 3 | The Missing Middle |
| Chapter 4 | The 4-Phase Methodology |
| Chapter 5 | Day 2 & The Rule of Divergence |
| Appendix A | Templates & Checklists |
| Appendix B | Research & SDD Positioning |
| Appendix C | 5Levels Case Study (Git-Verified) |
| Advanced Framework | Document Architecture (v3.3) |
Use the Templates
The /templates folder contains ready-to-use frameworks:
| Template | Purpose |
|---|---|
| Strategic Blueprint | Answer the 7 Phase 1 Questions |
| ADR Template | Document architecture decisions with rationale |
| Clarity Gate Checklist | The mandatory Phase 2→3 gate |
The Core Insight
"When code fails, fix the spec—not the code."
Traditional development iterates on code. Stream Coding iterates on do
...