decide-architecture-shapelisted
Install: claude install-skill SylphxAI/skills
# Decide Architecture Shape
Turn a substantial architecture change into independently verifiable
convergence slices. The same terminal applies whether the implementation spans
one repository or many. Optimize for verified throughput: disjoint slices may
advance in parallel when doing so has positive net value, but no slice advances
on narrative status or stale proof.
## When to use
- A substantial architecture change needs one chosen shape with verifiable convergence slices
- Implementation spans one or many repositories and needs parity gates and cutover policy
- Not for a single-screen interface (`craft-product-interface`) or a product blueprint (`design-product`)
## Resource guide
- Read `references/decide-architecture-shape-patterns.md` before choosing slice boundaries, states, parity gates, concurrency, or cutover policy.
- Use `scripts/validate_migration_ledger.py` only when the convergence adopts the portable ledger shape in the reference. From this repository's root, run `python3 -m unittest -v skills/decide-architecture-shape/scripts/test_validate_migration_ledger.py` after changing the validator. A simple single-repository refactor does not need a ledger merely to use this Skill. Reuse the repository's existing proportional verification entrypoint when ledger validity is material; do not add a dedicated CI workflow merely because the portable validator exists. Prefer an existing repo-native schema and validator when one already owns this fact.
- Load the target