1.8 KiB
1.8 KiB
Architecture Maintainability
Generated at: 2026-06-14
Summary
- decision:
watch-maintainability-hotspots - python files:
144 - scripts:
88 - tests:
56 - internal modules:
17 - CLI scripts:
72 - Yao CLI command handlers:
35 - largest file lines:
1159 - hotspots:
1 - blockers:
0
This report keeps maintainability risk visible before the Meta Skill grows more gates, renderers, and CLI commands.
Hotspots
| File | Lines | Kind | Severity | Recommended action |
|---|---|---|---|---|
scripts/yao.py |
1159 |
cli-script |
warn |
Split command handlers by domain while keeping scripts/yao.py as the thin CLI orchestrator. |
Largest Files
| File | Lines | Kind | Severity |
|---|---|---|---|
scripts/yao.py |
1159 |
cli-script |
warn |
scripts/render_review_studio.py |
887 |
cli-script |
pass |
tests/verify_yao_cli.py |
838 |
test |
pass |
scripts/skill_report_model.py |
782 |
internal-module |
pass |
scripts/compile_skill.py |
734 |
cli-script |
pass |
scripts/optimize_description.py |
723 |
cli-script |
pass |
scripts/trust_check.py |
714 |
internal-module |
pass |
scripts/yao_cli_parser.py |
691 |
internal-module |
pass |
scripts/render_review_viewer.py |
685 |
cli-script |
pass |
scripts/build_skill_atlas.py |
674 |
cli-script |
pass |
scripts/skill_report_layout.py |
653 |
internal-module |
pass |
scripts/render_reference_synthesis.py |
644 |
cli-script |
pass |
Release Rule
blockhotspots should be split before governed release.warnhotspots can ship only when Review Studio keeps them visible and a reviewer accepts the modularization plan.- Do not split a file only for line count; split when a stable responsibility boundary is clear.