/doc-suite-generator

Orchestrates comprehensive project documentation from a codebase scan. Produces 13 reports per project. Portfolio-level synthesis for multi-project runs.

Trigger: document this project, generate docs, build project documentation, analyze my portfolio, run the full report suite Output: docs/01-project-documentation/ · Portfolio: portfolio-docs/ Reports: 13 (00–12) per project + 7 synthesis · Sub-skills: 10

Reports (per project)

#	File	What it covers
00	00-readme.md	Standardized README with badges, getting-started, light spec
01	01-executive-summary.md	Documentation index, project summary
02	02-project-overview.md	What it is, tech stack, architecture
03	03-technical-specification.md	APIs, data models, deployment, security architecture
04	04-business-benefits.md	Value props, ROI, target users, use cases
05	05-innovation-themes.md	What’s technically novel
06	06-features-capabilities.md	Detailed feature inventory
07	07-extensibility.md	Plugin points, growth surfaces
08	08-work-zones.md	Thematic development areas
09	09-portfolio-position.md	Position in broader portfolio
10	10-technical-readiness.md	Production maturity scorecard
11	11-worksona-themes.md	Leadership runbook alignment
12	12-worksona-first-principles.md	16 structural constraints

Portfolio Synthesis (multi-project)

File	What it covers
00-portfolio-overview.md	All projects summarized, aggregate scorecard
01-synthesis-ai-innovation.md	AI/ML patterns across portfolio
02-synthesis-technology.md	Shared tech patterns, convergence/divergence
03-synthesis-ux.md	UX consistency, onboarding, philosophy
04-synthesis-worksona-runbook.md	Leadership runbook adherence
05-synthesis-worksona-fp.md	Structural principle adherence
06-synthesis-cross-cutting.md	Interconnections, narrative, strategic recommendations

Usage Modes

Mode	What happens
Single project	Phases 1–4: scan → README → 12 reports → enrichment pass
Batch (portfolio)	Single project × N, then Phase 5: portfolio synthesis
Incremental update	Re-scan, diff against existing docs, regenerate changed sections
README-only	Scan + README standardization, skip docs/