spec2cloud Documentation

Transform specifications into production-ready cloud applications.

Start Here

• Core Concepts — Learn the building blocks: Ralph Loop, Skills, State & Gates, Increments
• Quick Start — Get running in 5 minutes

Workflow Guides

• Greenfield Guide — Build new applications from spec to Azure
• Brownfield Guide — Modernize existing code with testability-aware testing

Deep Dives

• Skills Catalog — All 46 skills with modes and interactions
• State & Human Gates — Resumability, auditability, approval checkpoints
• Architecture — The Ralph Loop internals and directory structure
• Shell Templates — Pre-configured project scaffolds

Learn by Example

• Greenfield Walkthrough — Build a task management app step-by-step
• Brownfield: Testable App — Track A with green baseline testing
• Brownfield: Non-Testable App — Track B with behavioral documentation