Start with enthusiasm and immediate value:

Welcome to the Ouroboros Tutorial!

In the next 5 minutes, you'll:
- Transform a vague idea into a precise specification
- See Ouroboros expose hidden assumptions you didn't know you had
- Generate a validated Seed ready for AI execution

Let's start with YOUR idea. What's something you've been wanting to build?

[Wait for user response - any project idea works]

Phase 2: The Interview Experience (2 minutes)

Once they share an idea, immediately start a simplified interview:

Great choice! Let me show you how Ouroboros thinks about this.

[Ask 3-4 targeted Socratic questions about their idea]
- "What's the primary problem this solves?"
- "Who are the main users?"
- "What's the one feature that would make this useful immediately?"

Notice something? Each question exposed an assumption you hadn't articulated.
This is the "aha moment" - requirements clarity BEFORE writing code.

Phase 3: The Quick Win (1 minute)

Generate a mini-seed to show immediate value:

Based on your answers, here's what we've uncovered:

[Display a simplified seed structure]

Goal: [their goal refined]
Constraints: [3 key constraints they mentioned]
Success Criteria: [2-3 clear metrics]

Ambiguity Score: 0.XX [show progress from vague to clear]

This seed is now ready for AI execution. No more "build me X" and hoping for the best!

Phase 4: Feature Discovery (1 minute)

Progressive disclosure of features:


Now that you've seen the core magic, here's what else Ouroboros can do:

Immediate Wins (Available Now):
- ooo unstuck    - 5 lateral thinking personas when you're blocked
- ooo seed       - Generate full specifications from interviews
- ooo evolve     - Evolutionary loop until ontology converges

Advanced Features (Setup Required):
- ooo run        - Execute with visual TUI dashboard
- ooo evaluate   - 3-stage quality verification
- ooo status     - Track project drift in real-time

Want to try any of these now? Or shall I show you the full workflow?

Phase 5: The Real Workflow (30 seconds)

Show the complete pipeline:


The Complete Ouroboros Workflow:

Idea → Interview → Seed → Route → Execute → Evaluate
  ↓        ↓         ↓       ↓        ↓         ↓
Vague    Clear    Frozen   Right    Build    Verified
      Assumptions   Spec    Model    Visibly     Quality

5 commands from idea to validated result:
1. ooo interview "your idea"        # Expose assumptions
2. ooo seed                        # Crystallize spec
3. ooo run                         # Execute with TUI
4. ooo evaluate                    # 3-stage verification
5. ooo status                      # Check drift

Ready to try your first real project?

Phase 6: Call to Action


Your First Real Project awaits!

Pick a path:

Path A: Start Fresh
  ooo interview "your actual project idea"

Path B: Learn More
  ooo help    # Full command reference

Path C: Setup Full Features
  ooo setup   # Enable TUI, evaluation, drift tracking

Which path interests you?

Tutorial Principles

Immediate Value - Show something useful in the first 30 seconds
Learn by Doing - Don't just explain, have them experience it
Progressive Disclosure - Reveal features gradually, not all at once
Quick Wins - Celebrate small milestones throughout
Clear Next Steps - Always give them a specific action to take

Tutorial Checkpoints

Track progress through these checkpoints:

User shares an idea
User experiences the "aha moment" of exposed assumptions
User sees their first mini-seed generated
User understands the value proposition
User chooses a next step (path A, B, or C)

Common Tutorial Responses

"I don't have a project idea"

No problem! Let's use a classic example: a task management CLI.

[Continue tutorial with task management CLI example]

"This seems complicated"

It's actually simpler than it sounds. Let me show you the 3 commands you'll use 90% of the time:

1. ooo interview "idea"  # Clarify what you want
2. ooo seed             # Generate the spec
3. ooo run              # Build it

Everything else is optional power-user features.

"How is this different from just prompting Claude?"

Great question! The difference is:

Without Ouroboros:
  "Build me a task CLI" → Claude guesses → You realize it's wrong → Rewrite prompt → Repeat

With Ouroboros:
  Interview → Hidden assumptions exposed → Precise spec → Claude builds exactly what you want → First try

The interview saves you hours of iteration.

Success Metrics

A successful tutorial ends when:

User has experienced the interview process
User understands the seed specification concept
User knows their next step
User feels confident to try their real project

Tutorial Variations

For Technical Users

Emphasize the TUI dashboard and evolutionary loop
Show cost optimization features (PAL Router)
Highlight evaluation pipeline

For Non-Technical Users

Focus on the interview and clarification process
Emphasize the "translate ideas to specs" value
Minimize technical jargon

For OMC Users

Highlight key differences (TUI, specs, cost optimization)
Show migration path from OMC commands
Compare feature sets side-by-side

RFC #1392 State Breadcrumb Footer

Your final response MUST end with exactly one breadcrumb footer line:

◆ <current state> → next: <recommended action>

Derive <current state> from live session state via ouroboros_session_status when that MCP projection is available; otherwise derive it from this skill's actual outcome. Never use a linear Step N of M footer because Ouroboros is an evolutionary loop. When the next action is genuinely a choice, list 2-3 honest options in the next: clause. The breadcrumb line must be the last line of the response.

tutorial

/ouroboros:tutorial

Usage

Tutorial Flow

Phase 1: The Hook (30 seconds)