# Announcement Relevancy Matrix

Which agents consume announcements from which other agents, and at what
minimum priority threshold.

For context on the announcement system itself (how to create, read, and close
announcements) see [`../`](../) (the tracking-system reference).

For dynamic programmatic lookup use the `agent-prefix-info` subagent with
operation `GET_RELEVANCY_MATRIX`.


## Universal Baseline — Applies to ALL Agents Without Exception

```
Priority/CI-Blocker from ANY agent → consume immediately, always
```

No agent is exempt from this rule. CI-Blocker signals block all other work.


## Per-Agent Relevancy Table

### `AUTO-PROD-BLDR` — product-builder (process supervisor)

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| ALL agents | Priority/Low+ | Monitors everything; must see all signals |


### `AUTO-WDOG` — system-watchdog

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| ALL agents | Priority/Low+ | Must observe the full system to audit it |


### `AUTO-HUMAN` — human-liaison

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| ALL agents | Priority/High+ | Relays important events to humans |


### `AUTO-EVLV` — agent-evolution

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| ALL agents | Priority/Medium+ | Needs broad pattern detection across all pools |


### `AUTO-IMP-SUP` — implementation pool (primary code producer)

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts that may block implementation work |
| `AUTO-EPIC` | Priority/High+ | New issues created and ready to implement |
| `AUTO-REV-SUP` | Priority/High+ | Review feedback requiring code fixes |
| `AUTO-PRMRG-SUP` | Priority/High+ | Merge status, rebase failures affecting PR work |
| `AUTO-ARCH` | Priority/High+ | Architectural decisions affecting implementation approach |
| `AUTO-OWNR` | Priority/High+ | Priority and scope changes |
| `AUTO-HUMAN` | Priority/High+ | Human requests relayed by liaison |
| `AUTO-GROOM` | Priority/Medium+ | Issue quality corrections affecting work items |
| `AUTO-GUARD` | Priority/Medium+ | Pattern drift warnings to apply to new code |
| `AUTO-SPEC` | Priority/Medium+ | Spec changes affecting implementation approach |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-REV-SUP` — PR review pool

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-IMP-SUP` | Priority/High+ | New PRs available for review |
| `AUTO-ARCH` | Priority/High+ | Architecture decisions affecting review criteria |
| `AUTO-PRMRG-SUP` | Priority/High+ | Merge status of previously reviewed PRs |
| `AUTO-GUARD` | Priority/Medium+ | Pattern standards to check for in reviews |
| `AUTO-SPEC` | Priority/Medium+ | Spec alignment criteria updates |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-PRMRG-SUP` — PR merge pool

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | CI-Blocker alerts, system health |
| `AUTO-REV-SUP` | Priority/High+ | Review approvals that enable merging |
| `AUTO-IMP-SUP` | Priority/High+ | New PRs entering the merge pipeline |
| `AUTO-GROOM` | Priority/Medium+ | PR quality corrections before merge |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-UAT-SUP` — UAT test pool

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-IMP-SUP` | Priority/High+ | New code merged and ready for UAT |
| `AUTO-SPEC` | Priority/High+ | Spec changes requiring retesting |
| `AUTO-ARCH` | Priority/High+ | Behavioral changes affecting test scope |
| `AUTO-PRMRG-SUP` | Priority/Medium+ | Merged PRs triggering retest cycles |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-BUG-SUP` — bug hunt pool

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-IMP-SUP` | Priority/High+ | New code to analyze for bugs |
| `AUTO-UAT-SUP` | Priority/Medium+ | Test failures that may reveal underlying bugs |
| `AUTO-SPEC` | Priority/Medium+ | Spec changes affecting analysis scope |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-INF-SUP` — test infrastructure pool

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | CI pipeline failures |
| `AUTO-IMP-SUP` | Priority/High+ | CI changes, test additions requiring infra update |
| `AUTO-BUG-SUP` | Priority/Medium+ | Test reliability issues affecting infrastructure |
| `AUTO-UAT-SUP` | Priority/Medium+ | Test infrastructure problems discovered during UAT |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-ARCH` — architecture

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-IMP-SUP` | Priority/High+ | Implementation discoveries affecting spec |
| `AUTO-SPEC` | Priority/High+ | Spec evolution feedback requiring arch input |
| `AUTO-GUARD` | Priority/High+ | Pattern drift requiring architectural response |
| `AUTO-HUMAN` | Priority/High+ | Human architectural feedback |
| `AUTO-EPIC` | Priority/Medium+ | Planning gaps needing spec coverage |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-EPIC` — epic planning

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-ARCH` | Priority/High+ | Architecture to decompose into epics/issues |
| `AUTO-OWNR` | Priority/High+ | Priority and scope decisions affecting planning |
| `AUTO-HUMAN` | Priority/High+ | Human requests for work breakdown |
| `AUTO-SPEC` | Priority/Medium+ | Spec changes affecting issue planning |
| `AUTO-IMP-SUP` | Priority/Medium+ | Implementation progress affecting future plans |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-GUARD` — architecture guard

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-ARCH` | Priority/High+ | Architecture pattern standards to enforce |
| `AUTO-IMP-SUP` | Priority/High+ | New code merges that may introduce pattern drift |
| `AUTO-SPEC` | Priority/Medium+ | Spec changes affecting acceptable patterns |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-SPEC` — spec update

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-ARCH` | Priority/High+ | Architecture changes to reflect in spec |
| `AUTO-IMP-SUP` | Priority/High+ | Implementation divergences from spec |
| `AUTO-HUMAN` | Priority/High+ | Human feedback on spec content |
| `AUTO-PRMRG-SUP` | Priority/Medium+ | Merges triggering spec-vs-implementation comparison |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-GROOM` — backlog grooming

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-OWNR` | Priority/High+ | Priority corrections from project owner |
| `AUTO-IMP-SUP` | Priority/High+ | PR quality issues surfaced during implementation |
| `AUTO-HUMAN` | Priority/High+ | Human requests about specific issues |
| `AUTO-EPIC` | Priority/Medium+ | New epics with children needing grooming |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-DOCS` — documentation

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-ARCH` | Priority/High+ | Architecture changes to document |
| `AUTO-SPEC` | Priority/High+ | Spec changes requiring documentation updates |
| `AUTO-IMP-SUP` | Priority/Medium+ | New features completed and ready to document |
| `AUTO-UAT-SUP` | Priority/Medium+ | Test examples suitable for documentation |
| `AUTO-PRMRG-SUP` | Priority/Medium+ | Milestone completions triggering doc cycle |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-TIME` — timeline update

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-IMP-SUP` | Priority/Medium+ | Progress data for timeline entries |
| `AUTO-PRMRG-SUP` | Priority/Medium+ | Merged PRs to record in timeline |
| `AUTO-PROD-BLDR` | Priority/Medium+ | Milestone status updates |
| All others | Priority/Critical+ | Universal baseline |


### `AUTO-OWNR` — project owner

| Source | Min Priority | Rationale |
|--------|-------------|-----------|
| `AUTO-WDOG` | Priority/Critical+ | System alerts |
| `AUTO-HUMAN` | Priority/High+ | Human requests and feedback |
| `AUTO-EPIC` | Priority/High+ | New epics and scope changes |
| `AUTO-IMP-SUP` | Priority/High+ | Implementation progress affecting priority decisions |
| `AUTO-GROOM` | Priority/Medium+ | Issue quality reports requiring owner action |
| `AUTO-UAT-SUP` | Priority/Medium+ | Test results affecting priority decisions |
| All others | Priority/Critical+ | Universal baseline |


## Rule of Thumb

When in doubt, **lower the threshold** (consume more). Missing an important
announcement is always worse than reading a slightly irrelevant one.
