{"id":42481575,"url":"https://github.com/frmoretto/stream-coding","last_synced_at":"2026-03-02T04:09:05.216Z","repository":{"id":328745847,"uuid":"1103255021","full_name":"frmoretto/stream-coding","owner":"frmoretto","description":"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.","archived":false,"fork":false,"pushed_at":"2025-12-23T08:01:57.000Z","size":138,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-24T21:58:39.561Z","etag":null,"topics":["ai-accelerated","ai-coding","ai-development","claude","claude-code","context-engineering","cursor","developer-tools","documentation-first","llm","methodology","sdd","software-engineering","specification-driven-development","technical-debt","velocity"],"latest_commit_sha":null,"homepage":"https://www.stream-coding.com/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frmoretto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-24T16:21:05.000Z","updated_at":"2025-12-23T08:02:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/frmoretto/stream-coding","commit_stats":null,"previous_names":["frmoretto/stream-coding"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/frmoretto/stream-coding","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frmoretto%2Fstream-coding","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frmoretto%2Fstream-coding/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frmoretto%2Fstream-coding/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frmoretto%2Fstream-coding/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frmoretto","download_url":"https://codeload.github.com/frmoretto/stream-coding/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frmoretto%2Fstream-coding/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29204940,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T17:44:10.191Z","status":"ssl_error","status_checked_at":"2026-02-07T17:44:07.936Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-accelerated","ai-coding","ai-development","claude","claude-code","context-engineering","cursor","developer-tools","documentation-first","llm","methodology","sdd","software-engineering","specification-driven-development","technical-debt","velocity"],"created_at":"2026-01-28T11:00:20.597Z","updated_at":"2026-03-02T04:09:05.209Z","avatar_url":"https://github.com/frmoretto.png","language":null,"readme":"# Stream Coding v3.5\n\n**The 10-20x Methodology for AI-Accelerated Software Development**\n\n[![License: CC BY 4.0](https://img.shields.io/badge/License-CC_BY_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)\n\n\u003e 📢 **v3.5 Update:** Phase 2.5 Adversarial Review added, internal gate renamed Spec Gate (structural), Clarity Gate is now a standalone epistemic tool. Re-download if using older version.\n\n\u003e ✅ **This methodology built 7 production modules in 4.5 hours** ([5Levels Case Study](./manifesto/Appendix_C_5Levels_Case_Study.md), Git-verified)\n\n\u003e *\"Stream coding isn't about faster coding. It's about documentation so clear that code writes itself.\"*\n\n---\n\n## The Problem: The Velocity Mirage\n\nAI tools promise 10x productivity. GitHub Copilot, Cursor, Claude Code—they make coding 55% faster.\n\n**But projects still take the same time to ship.**\n\nWhy? Because faster typing doesn't solve:\n- Strategic decisions AI can't make for you\n- Context that gets lost between prompts\n- Technical debt created at 10x speed\n\nThis gap between task velocity and project velocity is the **Velocity Mirage**.\n\n---\n\n## The Solution: Stream Coding\n\nStream Coding is a documentation-first methodology that makes AI-generated code deterministic.\n\n**The 40/40/5/10/5 Split:**\n- **40%** Strategic Thinking (Phase 1) — Solve hard problems before coding\n- **40%** AI-Ready Documentation (Phase 2) — Specs so complete AI has zero decisions\n- **5%** Adversarial Review (Phase 2.5) — Different AI attacks the specs before coding\n- **10%** Execution (Phase 3) — Code streams out automatically\n- **5%** Quality (Phase 4) — Tests and verification\n\n**Real Results (5Levels Case Study):**\n- 7 production modules in 4.5 hours\n- 46 intelligence endpoints (77 total backend API)\n- Zero bugs in generated code, 21 minutes average per tested module\n\n*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.*\n\n---\n\n## Quick Start\n\n### Option 1: Claude.ai / Claude Desktop\n\n1. Download [`stream-coding.skill`](dist/stream-coding.skill)\n2. Go to Settings → Features → Skills → Add\n3. Upload the `.skill` file\n4. Ask Claude: *\"Build a user authentication system\"*\n\n### Option 2: Claude Code\n\nClone the repo — Claude Code auto-detects skills in `.claude/skills/`:\n\n```bash\ngit clone https://github.com/frmoretto/stream-coding\ncd stream-coding\n# Claude Code will automatically detect .claude/skills/stream-coding/SKILL.md\n```\n\nOr copy `.claude/skills/stream-coding/` to your project's `.claude/skills/` directory.\n\nAsk Claude: *\"Build a user authentication system\"*\n\n### Option 3: Claude Projects\n\nAdd [`SKILL.md`](SKILL.md) to project knowledge. Claude will search it when needed, though Skills provide better integration.\n\n### Option 4: OpenAI Codex / GitHub Copilot\n\nCopy the canonical skill to the appropriate directory:\n\n| Platform | Location |\n|----------|----------|\n| OpenAI Codex | `.codex/skills/stream-coding/SKILL.md` |\n| GitHub Copilot | `.github/skills/stream-coding/SKILL.md` |\n\nUse [`skills/stream-coding/SKILL.md`](skills/stream-coding/SKILL.md) (agentskills.io format).\n\n### Option 5: Manual / Other LLMs\n\nFor Cursor, Windsurf, or other AI tools:\n- Extract core principles (Phases, Document Types, Spec Gate)\n- Create a condensed version for `.cursorrules` or project settings\n- Use the [templates](./templates) and [Spec Gate Checklist](./templates/SPEC_GATE_CHECKLIST.md) as reference\n\nThe methodology is tool-agnostic—only SKILL.md is Claude-optimized.\n\n---\n\n## Read the Manifesto\n\nThe [`/manifesto`](./manifesto) folder contains the complete methodology:\n\n| Chapter | Topic |\n|---------|-------|\n| [Chapter 1](./manifesto/Chapter_01_The_10x_Promise.md) | The Velocity Mirage |\n| [Chapter 2](./manifesto/Chapter_02_Why_AI_Cant_Deliver.md) | Why AI Tools Alone Fail |\n| [Chapter 3](./manifesto/Chapter_03_The_Methodology_Gap.md) | The Missing Middle |\n| [Chapter 4](./manifesto/Chapter_04_What_Is_Stream_Coding.md) | The 5-Phase Methodology |\n| [Chapter 5](./manifesto/Chapter_05_The_Perpetual_Stream.md) | Day 2 \u0026 The Rule of Divergence |\n| [Appendix A](./manifesto/Appendix_A_The_Toolkit.md) | Templates \u0026 Checklists |\n| [Appendix B](./manifesto/Appendix_B_References.md) | Research \u0026 SDD Positioning |\n| [Appendix C](./manifesto/Appendix_C_5Levels_Case_Study.md) | 5Levels Case Study (Git-Verified) |\n| [Advanced Framework](./manifesto/advanced/Advanced_Framework.md) | Document Architecture (v3.5) |\n\n### Use the Templates\n\nThe [`/templates`](./templates) folder contains ready-to-use frameworks:\n\n| Template | Purpose |\n|----------|--------|\n| [Strategic Blueprint](./templates/STRATEGIC_BLUEPRINT.md) | Answer the 7 Phase 1 Questions |\n| [ADR Template](./templates/ADR_TEMPLATE.md) | Document architecture decisions with rationale |\n| [Spec Gate Checklist](./templates/SPEC_GATE_CHECKLIST.md) | The mandatory Phase 2→2.5 gate |\n\n---\n\n## The Core Insight\n\n\u003e **\"When code fails, fix the spec—not the code.\"**\n\nTraditional development iterates on code. Stream Coding iterates on documentation.\n\nEvery manual code edit without updating the spec creates **Divergence**—technical debt that breaks the stream. The methodology works because it treats code as a compiled output of documentation, not the source of truth.\n\n---\n\n## Who This Is For\n\n- ✅ **Technical founders** building greenfield products\n- ✅ **Solo developers** and small teams (1-5 people)\n- ✅ **Anyone tired of AI-generated spaghetti code**\n- ✅ **Backend/business logic focused** (see Chapter 4 for frontend approach)\n\n- ❌ Not for large enterprises (see GitHub Spec-Kit, Kiro, Gemini Conductor)\n- ❌ Not for teams who can't commit to documentation-first\n\n---\n\n## Where Stream Coding Fits\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│  AI-Assisted Development Landscape                              │\n├─────────────────────────────────────────────────────────────────┤\n│                                                                 │\n│  Layer 3: Enterprise SDD    GitHub Spec-Kit, Kiro, Conductor    │\n│           (teams 50+)       Full lifecycle, heavy process       │\n│                                                                 │\n│  Layer 2: Founder SDD  ◄──  STREAM CODING                       │\n│           (teams 1-5)       Documentation-first, AI-ready specs │\n│                                                                 │\n│  Layer 1: AI Assistants     Copilot, Cursor, Claude Code        │\n│           (task-level)      Fast typing, no methodology         │\n│                                                                 │\n│  Layer 0: Manual Coding     Traditional development             │\n│                                                                 │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n**The Gap:** Layer 1 tools make coding 55% faster but don't solve the methodology problem. Enterprise tools (Layer 3) are overkill for founders. Stream Coding fills the middle.\n\n---\n\n## Competitive Positioning\n\n| Dimension | AI Assistants (Copilot) | Stream Coding | Enterprise SDD (Kiro) |\n|-----------|------------------------|---------------|----------------------|\n| **Target** | Individual developers | Founders, small teams | Large enterprises |\n| **Focus** | Task velocity | Project velocity | Process compliance |\n| **Cost** | $10-20/mo | Free | Enterprise pricing |\n| **Methodology** | None | 5-phase, Spec Gate | Full SDLC |\n| **Documentation** | Optional | Mandatory (80% of time) | Mandatory |\n| **AI Role** | Code suggestions | Spec execution | Workflow automation |\n\n---\n\n## Research Validation\n\nStream Coding aligns with industry research:\n\n- **McKinsey (2025):** Top performers see 16-30% productivity gains through \"end-to-end PDLC implementation\" and \"structured communication of specs\"\n- **DORA (2025):** 7.2% delivery instability increase for every 25% AI adoption *without foundational systems*\n- **METR (2025):** Developers 19% slower with AI despite *feeling* 20% faster\n\nThe methodology isn't magic, it's systematic application of spec-driven development at founder scale.\n\n---\n\n## Related\n\n**Clarity Gate** — Pre-ingestion verification for epistemic quality (originated from Stream Coding's Clarity Gate concept)  \n[github.com/frmoretto/clarity-gate](https://github.com/frmoretto/clarity-gate)\n\n**Source of Truth Creator** — Create epistemically calibrated documents  \n[github.com/frmoretto/source-of-truth-creator](https://github.com/frmoretto/source-of-truth-creator)\n\n---\n\n## Roadmap\n\n| Phase | Status | Description |\n|-------|--------|-------------|\n| **v3.4** | ✅ Released | 13-item Clarity Gate, scoring rubric, Documentation Audit |\n| **v3.5** | ✅ Released | Phase 2.5 Adversarial Review, Spec Gate (structural), Clarity Gate (epistemic) split |\n| **v4.0** | 🔜 Planned | Multi-agent workflow support, automated spec validation |\n\n---\n\n## Contributing\n\nStream Coding is open source under CC BY 4.0. You're free to use, adapt, and share with attribution.\n\nLooking for:\n1. **Real-world case studies** — Applied Stream Coding to your project?\n2. **Tool integrations** — Cursor, Windsurf, other AI tools\n3. **Methodology feedback** — Are the 5 phases the right split?\n4. **Template improvements** — Better Strategic Blueprint, ADR formats\n\nOpen an issue or PR.\n\n---\n\n## About\n\nCreated by [Francesco Marinoni Moretto](https://www.linkedin.com/in/francesco-moretto/) while building [5Levels](https://5levels.io), a LinkedIn relationship intelligence platform.\n\nThe methodology emerged from building 7 production modules in 4.5 hours, and documenting exactly how.\n\n---\n\n## License\n\n[CC BY 4.0](./LICENSE) — Use freely with attribution.\n\n*\"Stream Coding methodology by Francesco Marinoni Moretto (github.com/frmoretto/stream-coding)\"*\n\n---\n\n*In memory of my beloved father Guido*\n","funding_links":[],"categories":["Lista de Habilidades","Phase 3: Build and Integrate"],"sub_categories":["Habilidades de la Comunidad","Reference Implementations"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrmoretto%2Fstream-coding","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrmoretto%2Fstream-coding","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrmoretto%2Fstream-coding/lists"}