Quick Start

This guide walks you through creating a new project and running the first two phases of the Spec Chain — from intent to prototype — in under 5 minutes.

1. Create a new project

Open RunLogos and click New Project. Give it a name and choose a directory. RunLogos creates the following structure:

my-project/
├── logos/
│   ├── logos.config.json
│   ├── resources/
│   │   ├── prd/
│   │   ├── api/
│   │   ├── database/
│   │   ├── test/
│   │   └── scenario/
│   └── changes/

2. Run the Requirements Skill

Click Phase 1 → Requirements in the left panel. RunLogos opens a structured conversation:

What do you want to build? — describe your idea in plain language
Who are the users? — describe personas and pain points
What are the main scenarios? — the skill extracts S01, S02 … scenario IDs
What are the acceptance criteria? — one per scenario

When the dialogue ends, RunLogos writes logos/resources/prd/1-product-requirements/requirements.md.

3. Run the Design Skill

Click Phase 2 → Product Design. The Design Skill reads your requirements and generates an HTML prototype in logos/resources/prd/2-product-design/.

Click Preview to see the prototype side-by-side with the spec. Add inline comments if anything needs changing, and run the skill again.

4. Continue the Spec Chain

Once you're happy with the prototype:

Phase 3 Step 1 — Scenario Mapping → sequence diagrams
Phase 3 Step 2 — API Design + Database Design
Phase 3 Step 3 — Test Design
Phase 3 Step 4 — Code Generation
Phase 3 Step 5 — Verification (openlogos verify)

Each step reads the output of the previous step. The AI never guesses.

Next: The Spec Chain in depth

Read The Spec Chain overview → for a detailed walkthrough of all 9 phases with screenshots.