MageByte-Zero/spec-superflow

Bug Investigator guides systematic root-cause debugging for bugs, test failures, and unexpected behavior before any fix is proposed. Use it when execution is blocked or the cause is unclear.

Build Executor governs implementation from an approved execution contract and supports disciplined build work, TDD execution, and guarded batch-by-batch changes. Use it when work must follow approved tasks, verification steps, and branch isolation rules.

Code Reviewer reviews completed implementation batches for spec compliance and code quality. Use it after execution waves, before merging, or at a review gate to verify changes and act on feedback.

Contract Builder converts approved planning artifacts into a single execution contract for implementation. Use it when moving from planning to build or when the current execution contract is missing or stale.

Need Explorer clarifies intent, scope, constraints, and success criteria before artifacts are written. Use it when a request is fuzzy, options need comparison, or a stable change definition is needed first.

Release Archivist closes a spec-superflow change with verification, audit, and archive readiness. Use it when implementation is complete or a final wrap-up is needed before moving to closing.

Spec Merger syncs delta specs into the published main spec base before a change closes. Use it when a change is still executing or when spec drift needs to be merged and conflicts checked.

Spec Writer creates or refines planning artifacts for a change: proposal.md, specs/, design.md, and tasks.md. Use it after the change is understood enough to write testable specs and implementation tasks.

Workflow Start inspects an active spec-superflow change, checks state and artifacts, and routes to the next workflow step. Use it when starting, resuming, or continuing a spec-superflow change.