polyphony-bootstrap

What problem does it solve?

Polyphony-bootstrap prevents broken SDLC routing and configuration wiring by providing a guided, prerequisite-checked onboarding path for repos that have twig and the polyphony CLI installed but are missing the initial .polyphony-config/ directory.

Core Features & Use Cases

• Prerequisite verification: Confirms the expected polyphony CLI verbs and that twig workspace discovery works before any configuration authoring starts.
• End-to-end smoke testing: Runs a six-step command sequence to validate-config, confirm hierarchy/type mapping, compute next-ready routing, validate transitions, and ensure the target state exists in twig without writing to ADO.
• Bootstrap pitfall catalog + checklist: Identifies common configuration and vocabulary mismatches (including scope_removed pitfalls, facet validation issues, and config argument-shape errors) and provides an operator-ready checklist for readiness.
• Guided onboarding flow: Points to the long-form docs for full walkthrough while supplying the missing agent-loadable operational steps.

Quick Start

Run this skill’s prerequisite checks and smoke test against one real work item ID after generating .polyphony-config/ from your chosen process template.