Skill definition
hi-module-summary-report
Synthesize existing module-inventory and tech-audit artifacts into an architecture summary, per-module breakdown, risk assessment, and optional Mermaid diagrams. Do not inspect source from scratch or run full onboarding.
SKILL.md
Module Summary and Risk Report
Read shared/leaf-contract.md. Consume evidence; do not independently rediscover the repository. Lifecycle orchestrator owns refinement, review, approval, and publication.
Inputs
Require valid module_inventory and tech_audit artifact paths. Accept audience (engineering | management | mixed), depth (executive | standard | detailed), mermaid (default true), optional repo_root — only to close a named evidence gap.
Missing/invalid input → return prerequisite result naming the missing producer; do not invoke it.
Workflow
- Validate input manifests, hashes, schemas, and producer statuses.
- Reconcile modules, dependencies, entry points, stack, build, CI/CD, and platform evidence. Record contradictions and incomplete modules.
- Produce per-module responsibility, technology, structure, dependency, and evidence block.
- Prioritize risks by impact and likelihood; attach evidence and concrete mitigation.
- Tailor detail to audience and depth without removing traceability.
- When requested, create sanitized Mermaid source per report-and-diagram-contract.md.
- Write
module-summary.md,risk-assessment.md, optional diagrams, andartifact-manifest.json. - Validate every module is represented and every risk cites evidence.
Completion
Complete when: input coverage explicit, all modules represented, diagrams parse when requested, unsupported claims labeled as inference or gap.
Continue exploring