speckit-orchestrator

Table of Contents

• Overview
• Persistent Presence Lens
• When to Use
• Core Workflow
• Session Initialization
• Command-Skill Matrix
• Progress Tracking Items
• Exit Criteria
• Related Skills

Speckit Orchestrator

Overview

Coordinates the Spec Driven Development workflow, skill loading, and progress tracking throughout the command lifecycle.

Persistent Presence Lens

Treat SDD as a minimal, testable "self-modeling" loop:

• World model: repo + speckit artifacts (spec.md, plan.md, tasks.md)
• Agent model: loaded skills/plugins + constraints (especially .specify/memory/constitution.md) + progress state

This mirrors patterns from open-ended embodied agents (e.g., Voyager/MineDojo) that compound capability via a curriculum (tasks.md) and a skill library (reusable plugin skills and superpowers methodology skills).

When To Use

• Starting any /speckit-* command.
• Coordinating multi-phase development workflows.
• Tracking progress across specification, planning, and implementation.
• Ensuring skill dependencies are loaded.

When NOT To Use

• Single-phase work (just specify, or just plan)
• Non-spec-driven projects

Core Workflow

Session Initialization

1. Verify Repository Context

   • Confirm working directory is a speckit-enabled project.
   • Check for .specify/ directory structure.
   • Validate required scripts exist.

2. Load Persistent State ("presence")

   • Read .specify/memory/constitution.md for constraints/principles.
   • Load current spec.md / plan.md / tasks.md context if present.

3. Load Command Dependencies

   • Match current command to required skills.
   • Load complementary superpowers skills.

4. Initialize Progress Tracking

   • Create TodoWrite items for workflow phases.
   • Track completion status.

Command-Skill Matrix

Quick reference for command-to-skill mappings:

Command	Primary Skill	Complementary Skills
/speckit-specify	spec-writing	brainstorming
/speckit-clarify	spec-writing	brainstorming
/speckit-plan	task-planning	writing-plans
/speckit-tasks	task-planning	executing-plans
/speckit-implement	-	executing-plans, systematic-debugging
/speckit-converge	-	executing-plans, verification-before-completion
/speckit-analyze	-	systematic-debugging, verification
/speckit-checklist	-	verification-before-completion

For detailed patterns: See modules/command-skill-matrix.md for complete mappings and loading rules.

See modules/writing-plans-extensions.md for plan authoring patterns.

Progress Tracking Items

For each workflow session, track:

• Repository context verified.
• Prerequisites validated.
• Command-specific skills loaded.
• Artifacts created/updated.
• Verification completed.

For detailed patterns: See modules/progress-tracking.md for TodoWrite patterns and metrics.

Exit Criteria

• Active command completed successfully.
• All required artifacts exist and are valid.
• Progress tracking reflects current state.
• No unresolved blockers.

Related Skills

• spec-writing: Specification creation and refinement.
• task-planning: Task generation and planning.
• superpowers:brainstorming: Idea refinement.
• superpowers:writing-plans: Implementation planning.
• superpowers:executing-plans: Task execution.