← ClaudeAtlas

decide-architecture-shapelisted

Decide one architecture shape from options with tradeoffs.
SylphxAI/skills · ★ 1 · Code & Development · score 74
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