Skip to content

Commit 8767ff3

Browse files
committed
docs(health): fix JSON-shape ref + fix-notation consistency (Copilot re-review)
- `readiness.yellow_reasons` implied a nested JSON shape; readiness returns `yellow_reasons` at the top level. Reworded accordingly. - `pyauto-heart fix <ci|dirty|drift|timing>` read as literal syntax and clashed with the Procedure section's explicit forms; now `pyauto-heart fix <topic>` with the topics listed as examples. Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 754afc0 commit 8767ff3

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

agents/health/AGENTS.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -135,8 +135,8 @@ never change the verdict, which is always adopted from Heart verbatim.
135135
first, then warnings, each mapped to its manifest capability.
136136
- **Unknown-CI tiles.** A repo whose required-workflow conclusion is
137137
unresolved on `main` HEAD is rendered by Heart as `CI in_progress` — an
138-
*unknown*, not an actively-running workflow, and it does **not** enter
139-
`readiness.yellow_reasons`. Keep such tiles visually secondary: note the
138+
*unknown*, not an actively-running workflow, and it does **not** enter the
139+
readiness output's top-level `yellow_reasons`. Keep such tiles visually secondary: note the
140140
"unknown-on-HEAD, gate-irrelevant" nature once and do not let many
141141
near-identical tiles dominate the card.
142142
- **Local-checks-blind.** When `repo_state` reports `present: false` (the
@@ -146,9 +146,9 @@ never change the verdict, which is always adopted from Heart verbatim.
146146
health unobserved here" and **downgrade confidence**; do not read the
147147
resulting silence (or a vacuously green tile) as *verified clean*. Cite the
148148
one-time fix: set `PYAUTO_ROOT` to the actual checkout root (or auto-detect).
149-
- **`fix` citations.** Cite a `pyauto-heart fix <ci|dirty|drift|timing>` entry
150-
point **only when Heart's verdict names that failure class**. An unknown is
151-
not a failure — never emit a fix for it.
149+
- **`fix` citations.** Cite a `pyauto-heart fix <topic>` entry point (topics:
150+
`ci`, `dirty`, `drift`, `timing`) **only when Heart's verdict names that
151+
failure class**. An unknown is not a failure — never emit a fix for it.
152152
- **Staleness.** If `dashboard.stale == true`, or the snapshot `ts` is older
153153
than the watch interval, downgrade confidence and recommend
154154
`pyauto-heart tick` rather than trusting the stale board.

0 commit comments

Comments
 (0)