doc-cross-repo-portfolio-map

Packet · {{ group }} · cross-repo/portfolio-map.md

Group mode only. This packet runs when the skill orchestrator is invoked with --group {{ group }}. In single-repo mode it is never seeded.

1. Objective

Produce {{ group_docs_root }}/cross-repo/portfolio-map.md: a 2-paragraph narrative of the {{ group }} group's shape, a Mermaid flowchart LR of its member repos with contract-count edges, and a ## Repos section with per-member H2 + relative link into each member's own .codehub/docs/ tree.

2. Scope

• Create: {{ group_docs_root }}/cross-repo/portfolio-map.md
• Do not touch: any other file under {{ group_docs_root }}/, any file under a member repo (including {{ member_repos }}/.codehub/docs/), {{ group_context_path }}, {{ group_prefetch_path }}, or any .packets/*.md other than this one.

3. Input specification

Source	Read how	Cache state
Group shared context	Read {{ group_context_path }}	always first
Group prefetch ledger	Read {{ group_prefetch_path }}	always first
Member list + freshness	{{ group_context_path }} § Members / {{ group_prefetch_path }} § group_list,group_status	cached
Group contracts	{{ group_prefetch_path }} § group_contracts	cached
Per-member one-line description	{{ group_context_path }} § Member profiles	cached
Member docs-root paths	derived: ../{{ member_repos[i] }}/.codehub/docs/README.md	n/a

4. Process

1. Read {{ group_context_path }} and Read {{ group_prefetch_path }}. Confirm the member list under § Members and re-verify that every member is tagged fresh in the cached group_status digest. If any member is stale, abort and write the gap to Work log — the orchestrator's Phase 0 gate should have caught this.
2. Pull the contract inventory from {{ group_prefetch_path }} § group_contracts. Aggregate by (producer_repo, consumer_repo) into an edge-count table.
3. Pull one-line domain descriptions for each member from {{ group_context_path }} § Member profiles. These become the second line of each node label via <br/>.
4. Draft the 2-paragraph narrative: paragraph 1 = what the group does as a whole (domain, scope); paragraph 2 = how the members relate (who produces for whom, which member is the hub). Every factual claim carries a repo:path:LOC citation.
5. Draft the Mermaid flowchart LR: one node per member repo with the two-line label "<repo><br/><one-line domain>"; one edge per (producer, consumer) pair labeled contracts: N. Cap at 20 nodes — if the group has > 20 members, keep the top-20 by inbound+outbound contract count and move the overflow to a ## Legend (overflow) table.
6. Draft the ## Repos section: one H2 per member (## <repo> — <one-line description>), each with 1-2 repo:path:LOC citations and a [See {{ member_repos[i] }} docs →](../{{ member_repos[i] }}/.codehub/docs/README.md) link.
7. Write {{ group_docs_root }}/cross-repo/portfolio-map.md with H1 = {{ group }} · Portfolio map.