bchanot/claude
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(handover-writers): stale ch.4 refs post-NAP-renumbering (glossary/tone->6, cross-links/THRESHOLD->5); 14.5 verification deferred to post-write; anchor gate ordered into STEP 16

Browse Source
This commit is contained in:
Bastien Chanot
2026-08-26 21:55:13 +02:00
parent 27f17939d7
commit c983f1ff94
2 changed files with 11 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
agents/client-handover-writer.md
+1 -1
View File
@@ -732,7 +732,7 @@ write `.claude/audits/THRESHOLD-OVERRIDE.md` documenting:
- Top 3 unresolved issues per axis - Top 3 unresolved issues per axis
- User's stated reason - User's stated reason
This file is referenced in §4 of the client doc ("Ce qui vous reste à faire") This file is referenced in §5 of the client doc ("Ce qui vous reste à faire")
so the client knows what's still below the bar. so the client knows what's still below the bar.
If `ALL_PASS = false`: If `ALL_PASS = false`:
agents/handover-doc-writer.md
+10 -5
View File
@@ -424,7 +424,7 @@ Wrong — has date prefix:
### 6.3 Glossaire (optionnel) ### 6.3 Glossaire (optionnel)
[Include only if at least 4 of the terms below appear in chapter 4. [Include only if at least 4 of the terms below appear in chapter 6.
Format: term — one-line plain-language definition. Sort alphabetically. Format: term — one-line plain-language definition. Sort alphabetically.
This is the ONLY place internal tooling names may be mentioned by This is the ONLY place internal tooling names may be mentioned by
their internal label, and only when explaining what they correspond their internal label, and only when explaining what they correspond
@@ -465,7 +465,7 @@ des audits de santé. Pour toute question, contactez [contact].*
1. Address the client directly ("votre site", "vous pouvez"). 1. Address the client directly ("votre site", "vous pouvez").
2. Chapters 1–3: replace every tech term with a user-facing equivalent. 2. Chapters 1–3: replace every tech term with a user-facing equivalent.
3. No abbreviations the client wouldn't use (HTTPS yes, CSP no — unless 3. No abbreviations the client wouldn't use (HTTPS yes, CSP no — unless
in chapter 4 with definition). in chapter 6 with definition).
4. Concrete numbers > adjectives. 4. Concrete numbers > adjectives.
5. Short paragraphs. Bullet lists for things you can count. 5. Short paragraphs. Bullet lists for things you can count.
6. **Score deltas explained in plain words**. Never just dump numbers. 6. **Score deltas explained in plain words**. Never just dump numbers.
@@ -535,9 +535,9 @@ The chapter must include:
8. **Outils gratuits pour vérifier votre présence**. 8. **Outils gratuits pour vérifier votre présence**.
Cross-link this chapter from §4 (owner responsibilities — "Ce qui vous Cross-link this chapter from §5 (owner responsibilities — "Ce qui vous
reste à faire"). Items in this §7 annex that are recurring belong in reste à faire"). Items in this §7 annex that are recurring belong in
§4's cadence checklist (Mensuel / Trimestriel / Annuel). §5's cadence checklist (Mensuel / Trimestriel / Annuel).
--- ---
@@ -624,7 +624,9 @@ checkbox:
(`LANG=en`: "Items already checked have been validated.") (`LANG=en`: "Items already checked have been validated.")
### Verification ### Verification (deferred — run right AFTER STEP 15 writes `$OUTPUT_MD`;
the pre-checks themselves are applied to the in-memory body here, the
file does not exist yet)
```bash ```bash
# At least one pre-check expected for any project with real history. # At least one pre-check expected for any project with real history.
@@ -687,6 +689,9 @@ awk '/^## 1\./{flag=1} /^## 6\./{flag=0} flag' "$OUTPUT" \
**Anchor-resolution gate** (clickable section refs work). **Anchor-resolution gate** (clickable section refs work).
```bash ```bash
# ORDER: run this gate in STEP 16, immediately AFTER the HTML render —
# $OUTPUT_HTML does not exist yet at STEP 15. A broken anchor found here
# loops back to fix the markdown ref, then re-render.
grep -oE '\]\(#[a-z0-9-]+\)' "$OUTPUT_MD" | tr -d ']()#' | sort -u > /tmp/refs.txt grep -oE '\]\(#[a-z0-9-]+\)' "$OUTPUT_MD" | tr -d ']()#' | sort -u > /tmp/refs.txt
grep -oE 'id="[^"]+"' "$OUTPUT_HTML" | sed 's/id="//;s/"//' | sort -u > /tmp/ids.txt grep -oE 'id="[^"]+"' "$OUTPUT_HTML" | sed 's/id="//;s/"//' | sort -u > /tmp/ids.txt
comm -23 /tmp/refs.txt /tmp/ids.txt comm -23 /tmp/refs.txt /tmp/ids.txt