main-workflow-router_skill

Overview

This skill routes work between OpenSpec (L0-1) and BMAD (L2-4), tracks project status, and guides the team through defined phases. It auto-invokes at project start or on status queries, initializes workflow state if needed, and recommends the next skill with concrete prerequisites and rationale.

How this skill works

The router assesses intent and complexity (levels 0–4) from the user's description or project summary, then selects OpenSpec for small changes or BMAD for discovery and complex work. It inspects status files (e.g., docs/bmad-workflow-status.md, docs/sprint-status.yaml, workflow-status.md) and artifact indexes, validates quality gates in CHECKLIST.md, updates workflow state, and returns the next action and required inputs.

When to use it

• At the start of any BMAD project or when the user says “start project”, “new project”, or “initialize”
• When the user asks workflow questions like “what's next?”, “where am I?”, or “check status”
• When a user describes a product idea or feature and you need routing between lightweight change vs full product workflow
• When a downstream skill finishes a phase and you need to transition to the next phase
• When workflow-status.md or equivalent files are missing and initialization is required

Best practices

• Always verify required artifacts and quality gates in CHECKLIST.md before advancing phases
• Ask clarifying questions when complexity is ambiguous (default to asking rather than assuming)
• Auto-initiate workflow files only when no status file exists; otherwise read and recommend next steps
• Halt routing and report missing prerequisites or blockers with actionable remediation
• Escalate to BMAD when scope grows beyond Level 1; downgrade to OpenSpec for simple fixes

Example use cases

• User types “start project” — skill initializes workflow files and recommends discovery or openspec based on initial summary
• User asks “what should I do next?” — skill reads workflow-status.md, summarizes progress, and routes to the appropriate skill
• Developer reports a bug labeled “small change” — skill routes to openspec-change-proposal and scaffolds a change workspace
• PM delivers a PRD — skill confirms prerequisites and routes to solutioning or architecture as appropriate
• A downstream skill completes discovery — skill updates state and queues planning and UX phases