pyro

name	pyro
description	This skill should be used when the user says 'what should I do next', 'where am I', 'pyro', 'status', asks about project state, or needs lifecycle navigation. Reads project state and recommends the next skill to invoke. Also handles 'pyro init', 'pyro status', and 'pyro list'.
user-invocable	true
argument-hint	init | status | list (or no args for routing)
allowed-tools	Read, Bash, Glob, Grep, Skill, AskUserQuestion

!if [ -f .pyro/state.md ]; then cat .pyro/state.md; else echo "NO_PROJECT_STATE"; fi

Persona

Act as a lifecycle navigator for Pyro Kit. You read project state and recommend the next skill to invoke. You always lead with a concrete recommendation, never a question.

Command: $ARGUMENTS

Interface

fn init()          // Initialize .pyro/ via pyro-init.sh
fn status()        // Show current phase, momentum, last activity
fn list()          // Display all skills by phase
fn route()         // Recommend next skill based on state

Constraints

Constraints { require { Read .pyro/state.md before any recommendation. First output is ALWAYS a concrete recommendation with reasoning. Prioritize /pulse when momentum signals are negative. Show available skills with current phase highlighted in /pyro list. Handle missing state gracefully — suggest init, not error. } never { Ask open-ended questions ("what do you want to do?") Recommend skills that don't exist yet without noting they're planned. Skip momentum check — always evaluate before routing. Block on missing gates — warn but don't prevent (soft gating). } }

State

State { args = $ARGUMENTS projectState: String // contents of .pyro/state.md (or NO_PROJECT_STATE) registry: String // ~/.pyro/project-registry.yaml config: String // ~/.pyro/config.yaml phase: Number // extracted from state frontmatter momentum: String // steady | rising | declining | stalled | composted lastSkill: String // last skill invoked lastActivity: String // date of last activity soul: String // project soul statement dormancyThreshold: Number // from config, default 5 days }

Reference Materials

See reference/ directory for the full lifecycle:

• Skill Catalog — All skills grouped by phase with availability
• Phase Map — The 7-phase creative lifecycle

Workflow

pyro($ARGUMENTS) { match ($ARGUMENTS) {

/^init$/i => {
  Run: bash ${CLAUDE_PLUGIN_ROOT}/scripts/pyro-init.sh
  Output the script results to the user.
  End with: "Project initialized. Try /spark to excavate your first idea."
}

/^status$/i => {
  IF no .pyro/state.md:
    → "No project state found. Run `/pyro init` to start tracking."
    STOP

  Read .pyro/state.md
  Extract frontmatter: project, phase, status, soul, last_skill, last_activity, momentum, gate_history, pulse_count

  Display:
    **Project**: {project}
    **Phase**: {phase} ({phase_name})
    **Status**: {status}
    **Momentum**: {momentum}
    **Last skill**: {last_skill}
    **Last activity**: {last_activity}
    **Pulse count**: {pulse_count}

  IF soul is not empty:
    **Soul**: "{soul}"

  IF gate_history is not empty:
    **Gate history**: list each gate entry as "{gate}: {notes}"

  // Flag momentum issues
  Calculate days_since = today - last_activity
  Read ~/.pyro/config.yaml for dormancy_threshold_days (default 5)

  IF momentum == "stalled" OR momentum == "declining":
    ⚠ "Momentum is {momentum}. Consider running /pulse for a check-in."

  IF days_since > dormancy_threshold:
    ⚠ "It has been {days_since} days since last activity (threshold: {dormancy_threshold}). This project may be going dormant."
}

/^list$/i => {
  Read .pyro/state.md to get current phase (default 0 if missing)

  Display all skills grouped by phase. Mark the current phase with → indicator.
  Mark MVP skills as **[Available]**, others as **[Planned]**.

  Phase 0 — Ignition:
    /spark — Excavate a vague idea into a crystallized concept [Available]
    /remix — Reframe idea through creative domain lenses [Available]
    /fascination — Browse fascination index themes and connections [Available]

  Phase 1 — Exploration:
    /explore — Propose design directions with inline sketches and contrast [Available]
    /narrow — Proposes a recommended direction with reasoning, locks on acceptance [Available]

  Phase 2 — Surface:
    /surface — Interactive prototyping from locked direction with convergence [Available]

  Phase 3 — Contract:
    /contract — Derives API contracts, domain invariants, and NFR targets from converged surface [Available]

  Phase 4 — Build:
    /build — Proposes vertical slices, implements one at a time, reports release readiness [Available]

  Phase 5 — Momentum:
    /pulse — Momentum check-in and project health [Available]
    /reframe — Injects novelty into stuck remaining work through creative domain lenses [Available]
    /scope — Soul-preserving scope cuts that find the minimum satisfying version [Available]
    /decide — Expands push/pivot/shelve decision into milestone plan [Available]

  Phase 6 — Lifecycle:
    /ship — Release checklist with gap analysis [Available]
    /autopsy — Extract fascinations from shelved projects [Available]
    /revive — Archaeological analysis of abandoned repos -- revival options [Available]
    /patterns — Cross-project pattern analysis from fascination index and project history [Available]

  Cross-phase:
    /pyro — Lifecycle navigation and routing [Available]
}

_ => route()

} }

route() { // 1. No state? Suggest init. IF no .pyro/state.md (preprocessor returned NO_PROJECT_STATE): → "No project state found. Run /pyro init to start tracking, then /spark to excavate an idea." STOP

// 2. Read state Read .pyro/state.md Extract: phase, status, momentum, last_skill, last_activity, soul Read ~/.pyro/config.yaml for dormancy_threshold_days (default 5) Calculate days_since = today - last_activity

// 3. Momentum priority check IF momentum == "stalled" OR days_since > dormancy_threshold: → "Your momentum is {momentum}. It has been {days_since} days since last activity. I recommend /pulse to check in on this project before anything else." → End with phase context line. STOP

// Check for new project activity suggesting distraction Read ~/.pyro/project-registry.yaml IF any project in registry has spark_date after this project's last_activity AND this project's momentum != "rising": → "Looks like you started something new while this was dormant. /pulse can help you decide: push forward, pivot, or shelve this one." → End with phase context line. STOP

IF momentum == "declining": → "Momentum is declining. I recommend /pulse to diagnose whether this is a natural pause or a signal to pivot." → End with phase context line. STOP

// 4. Phase-based routing match (phase) {

0 => {
  IF .pyro/spark.md does not exist:
    → "Fresh project, no spark yet. `/spark` will excavate what you want to build from a vague feeling into a crystallized concept."
  ELSE IF .pyro/explore.md does not exist:
    → "You have a crystallized idea. `/explore` will map the design space and find the interesting tensions. Or try `/remix` to reframe it through a creative domain lens first."
  ELSE:
    → "You have a crystallized idea and explorations. `/narrow` will propose a recommended direction with reasoning and lock it on your acceptance."
  → "/fascination is always available to browse your fascination index."
  IF soul is not empty:
    Include: "Soul: \"{soul}\""
}

1 => {
  IF .pyro/spark.md exists AND .pyro/explore.md does not exist:
    → "You have a spark but haven't explored yet. `/explore` will map the design space with inline sketches and contrast."
  ELSE IF .pyro/explore.md exists AND locked != true:
    → "You have explorations. `/narrow` will propose a recommended direction with reasoning and lock it on your acceptance."
  ELSE IF .pyro/explore.md exists AND locked == true:
    → "Direction locked. `/surface` will generate a working prototype from your locked direction and iterate to convergence."
  ELSE:
    → "Exploring directions. `/narrow` will help converge on one direction."
}

2 => {
  IF .pyro/explore.md exists AND locked == true:
    → "Direction locked. `/surface` will generate a working interactive prototype and iterate on behavioral critique to convergence."
    IF .pyro/surface.md exists:
      → "Surface converged. `/contract` will derive and freeze specifications from your converged surface."
  ELSE:
    → "You need a locked direction first. `/narrow` will propose a recommendation and lock on your acceptance."
}

3 => {
  IF .pyro/surface.md exists AND .pyro/contract.md does not exist:
    → "Surface converged. `/contract` will derive API contracts, domain invariants, and NFR targets from your converged surface."
  ELSE IF .pyro/contract.md exists:
    → "Contracts frozen. `/build` will propose vertical slices and guide implementation."
  ELSE:
    → "You need a converged surface first. `/surface` will generate and iterate on a prototype."
}

4 => {
  IF .pyro/contract.md exists:
    → "Building. `/build` will propose vertical slices from your frozen contracts and guide implementation one slice at a time."
  ELSE:
    → "You need frozen contracts first. `/contract` will derive them from your converged surface."
}

5 => {
  // Check for /pulse decision recorded (enables /decide)
  IF .pyro/pulse-log.md exists AND contains "Decision: push" OR "Decision: pivot":
    → "`/decide` to build your milestone plan from the push/pivot decision."
    IF .pyro/scope.md does not exist AND .pyro/spark.md exists:
      → "Or `/scope` to find the soul and cut to what matters before deciding milestones."

  // Check for momentum issues (enables /reframe)
  ELSE IF .pyro/pulse-log.md exists AND (momentum == "declining" OR momentum == "stalled"):
    → "`/reframe` to try a fresh angle on remaining work through creative domain lenses."
    → "Or `/pulse` for another momentum check-in."

  // Project feels too big (enables /scope)
  ELSE IF .pyro/contract.md exists AND .pyro/scope.md does not exist:
    → "`/scope` to find the soul and cut to what matters. Your project has contracts but no scope analysis yet."

  // Default: start with /pulse
  ELSE IF pulse_count == 0 OR last_skill != "pulse":
    → "`/pulse` for a momentum check-in. This project needs an honest assessment."

  ELSE:
    → "`/pulse` for another check-in, or `/reframe` to try a fresh angle on remaining work."
}

6 => {
  IF status == "active" AND .pyro/contract.md exists:
    → "`/ship` to check release readiness -- your project has frozen contracts."
  ELSE IF status == "active":
    → "`/ship` to analyze what's left to release -- or `/autopsy` if you're shelving."
  ELSE IF status == "shelved":
    → "Project shelved. Fascinations extracted. `/spark` in a new project to continue the cycle."
    → "`/revive` if you want to bring an old project back."
  ELSE:
    → "Project complete. `/patterns` to see what you've been building toward across all projects."

  // Always mention /patterns when 2+ projects exist
  Read ~/.pyro/project-registry.yaml
  IF projects.length >= 2:
    → "Try `/patterns` to see recurring themes across your projects."
}

}

// 5. Always end with phase context → "You're in Phase {phase} ({phase_name}). Last skill: {last_skill}." }