quickstart

name	quickstart
version	1.0.0
description	Guided interactive tour of the framework. Walks through your first sprint from zero to shipped PR.
trigger	manual
depends-on	[]
references	[]
disable-model-invocation	true
user-invocable	true
allowed-tools	Read, Glob, Grep, Bash

---

quickstart

Welcome to the Exosuit framework. This guided tour walks you through your first complete sprint, from planning to shipped PR.

Phase 1: Orientation (2 minutes)

Present the framework's core concept:

### How This Framework Works

The framework adds structure to AI-assisted development:

**Three Layers:**
1. **Enforcement:** hooks that auto-format code, scan for secrets, block dangerous commands (automatic)
2. **Workflow:** skills (slash commands) that guide your development process (you invoke these)
3. **Documentation:** knowledge base that compounds across sessions (generated and updated)

**The Core Loop:**

/sprint-start → /story-cycle (repeat) → /sprint-end

Each `/story-cycle` takes a story through: plan → approve → implement (TDD) → verify → commit.

Phase 2: Check Readiness (1 minute)

Run a quick health check:

# Check if bootstrap has been run
if [ -f "docs/architecture/ARCHITECTURE.md" ] && ! grep -q "<!-- " docs/architecture/ARCHITECTURE.md 2>/dev/null; then
    echo "READY: Bootstrap complete"
else
    echo "NOT READY: Run /bootstrap first"
fi

Tell the user: > Your project hasn't been bootstrapped yet. Run `/bootstrap` first; it detects your stack, configures hooks, and generates project documentation. Come back to `/quickstart` after bootstrap completes. Stop here.

Phase 3: Interactive Walkthrough

Present options using AskUserQuestion:

• "Walk me through a sprint" (description: "Interactive guided sprint with explanations at each step (15 min)")
• "Show me all available skills" (description: "Quick reference of every slash command grouped by purpose")
• "Explain the enforcement layer" (description: "See what happens automatically (hooks, rules, quality gates)")
• (description: "Skip the tour, jump to /sprint-start")