yao-meta-skill/reports/architecture_maintainability.md

Architecture Maintainability

Generated at: 2026-06-16

Summary

• decision: pass
• python files: 193
• scripts: 122
• tests: 71
• internal modules: 39
• CLI scripts: 85
• Yao CLI command handlers: 68
• entrypoint command handlers: 18
• command modules: 6
• largest file lines: 870
• watch threshold lines: 720
• watchlist: 9
• hotspots: 0
• blockers: 0

This report keeps maintainability risk visible before the Meta Skill grows more gates, renderers, and CLI commands.

Hotspots

No file-size hotspots found.

Watchlist

File	Lines	Kind	Recommended next split
scripts/yao_cli_parser.py	870	internal-module	Watch this file before adding new responsibilities; extract a helper module when one concern dominates.
tests/verify_review_studio.py	836	test	Break broad integration assertions into focused verifier helpers when the next behavior change lands.
scripts/render_world_class_preflight.py	814	cli-script	Watch this file before adding new responsibilities; extract a helper module when one concern dominates.
scripts/render_evidence_consistency.py	808	cli-script	Watch this file before adding new responsibilities; extract a helper module when one concern dominates.
scripts/skill_report_model.py	800	internal-module	Watch this file before adding new responsibilities; extract a helper module when one concern dominates.
tests/verify_yao_cli.py	776	test	Break broad integration assertions into focused verifier helpers when the next behavior change lands.
scripts/build_skill_atlas.py	730	cli-script	Watch this file before adding new responsibilities; extract a helper module when one concern dominates.
scripts/compile_skill.py	723	cli-script	Watch this file before adding new responsibilities; extract a helper module when one concern dominates.
scripts/optimize_description.py	723	cli-script	Watch this file before adding new responsibilities; extract a helper module when one concern dominates.

Largest Files

File	Lines	Kind	Severity
scripts/yao_cli_parser.py	870	internal-module	pass
tests/verify_review_studio.py	836	test	pass
scripts/render_world_class_preflight.py	814	cli-script	pass
scripts/render_evidence_consistency.py	808	cli-script	pass
scripts/skill_report_model.py	800	internal-module	pass
tests/verify_yao_cli.py	776	test	pass
scripts/build_skill_atlas.py	730	cli-script	pass
scripts/compile_skill.py	723	cli-script	pass
scripts/optimize_description.py	723	cli-script	pass
scripts/trust_check.py	714	internal-module	pass
scripts/apply_adaptation.py	706	cli-script	pass
scripts/world_class_evidence_contract.py	686	internal-module	pass

Release Rule

• block hotspots should be split before governed release.
• warn hotspots 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.