doc-cross-repo-contracts-matrix

Packet · {{ group }} · cross-repo/contracts-matrix.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/contracts-matrix.md: the N×N producer/consumer matrix for the {{ group }} group (rows = producers, columns = consumers, cells = contract counts), followed by a ## Notable contracts H2 listing the top 10 contracts with both-ends repo:path:LOC citations.

2. Scope

• Create: {{ group_docs_root }}/cross-repo/contracts-matrix.md
• Do not touch: any other file under {{ group_docs_root }}/, any file under a member repo (including {{ member_repos }}/), {{ 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 (the spine)	{{ group_prefetch_path }} § group_contracts	cached
Per-member route inventory	{{ group_prefetch_path }} § route_map(<repo>) per {{ member_repos }}	cached
Concept → symbol disambiguation	mcp__codehub__group_query({group: "{{ group }}", text: <concept>})	mid-run, on demand

4. Process

1. Read {{ group_context_path }} and Read {{ group_prefetch_path }}. Confirm the member list and re-verify every member is tagged fresh in the cached group_status digest. Abort to Work log if any member is stale.
2. Pull the contract list from {{ group_prefetch_path }} § group_contracts. Each row has {producer_repo, consumer_repo, path, method, shape}. This is the spine of the entire artifact.
3. Build the producer/consumer matrix: rows = producer repos (in group_list order), columns = consumer repos (same order). Each cell = the contract count for that (producer, consumer) pair. Diagonal cells show —. Render as a Markdown table.
4. Select the top 10 contracts by consumer count (ties broken by producer path lexicographically). For each, resolve both ends to real files via the cached route_map digests — producer file comes from route_map(<producer>), consumer file from the group_contracts row's consumer_repo + path. Cite both with repo:path:LOC.
5. Draft the ## Notable contracts H2: a bullet list of the 10 entries in the form `<producer-repo>:<producer-path>:<LOC>` ← consumed by `<consumer-repo>:<consumer-path>:<LOC>` (method + shape summary).
6. If the matrix has zero non-diagonal contracts, still emit the full N×N matrix (all 0 / — cells), add a > No inter-repo contracts detected — the group graph does not currently encode cross-repo edges banner immediately beneath the H1, and replace ## Notable contracts with ## Notable contracts\n\n_None detected._.
7. Write {{ group_docs_root }}/cross-repo/contracts-matrix.md with H1 = {{ group }} · Contracts matrix.