doc-architecture-system-overview

Packet · {{ repo }} · architecture/system-overview.md

1. Objective

Produce {{ docs_root }}/architecture/system-overview.md: a 400–600-word narrative of what {{ repo }} does and how its top-level pieces fit, with one stack table and one Mermaid flowchart LR of the top 6 modules.

2. Scope

• Create: {{ docs_root }}/architecture/system-overview.md
• Do not touch: any other file under {{ docs_root }}/, any source file in the repo, .context.md, .prefetch.md, or any .packets/*.md other than this one.

3. Input specification

Source	Read how	Cache state
Shared context	Read {{ context_path }}	always first
Prefetch ledger	Read {{ prefetch_path }}	always first
Project profile	{{ context_path }} § Repo profile	cached
Top communities	{{ context_path }} § Top communities	cached
Top processes	{{ context_path }} § Top processes	cached
External deps	{{ context_path }} § Stack or mcp__codehub__dependencies({repo: "{{ repo }}"})	cached if digest present
Module relations	mcp__codehub__context({symbol: <community-name>}) per top 6 modules	mid-run

4. Process

1. Read {{ context_path }} and Read {{ prefetch_path }}. Confirm {{ repo }} profile, top-6 community names, top processes.
2. For each of the top 6 communities (from .context.md § Top communities): call mcp__codehub__context({symbol: <community-name>}) to pull inbound/outbound relation counts. Cache the summary in this packet's Work log.
3. Pull the external dependencies list from .context.md § Stack (or call dependencies if not cached). Keep the top 15 by usage.
4. Resolve the stack layers by inspecting project_profile.entry_points and cross-referencing the top communities with their file_path prefixes.
5. Draft the narrative (400–600 words). Structure: paragraph 1 = what the repo does, paragraph 2 = how the pieces fit.
6. Draft the Stack table with columns Layer | Technology | Source. Every row cites path:LOC.
7. Draft the Module-map Mermaid flowchart LR — ≤ 20 nodes, short labels (≤ 20 chars), edges from relation counts ≥ 1.
8. Write {{ docs_root }}/architecture/system-overview.md with H1 = {{ repo }} · System overview.