[problem] architect-enforce-edit + jtbd-enforce-edit hooks should add docs/retros/ to the exclusion list

[tompahoward]

Description

The architect + JTBD edit-enforce hooks (packages/architect/hooks/architect-enforce-edit.sh + packages/jtbd/hooks/jtbd-enforce-edit.sh) fire gate delegations on routine writes to docs/retros/*.md ask-hygiene trail files. The sibling exclusion paths already cover docs/problems/, docs/briefing/, docs/jtbd/, docs/PRODUCT_DISCOVERY.md, docs/VOICE-AND-TONE.md, docs/STYLE-GUIDE.md, RISK-POLICY.md, .risk-reports/, .changeset/, memory files, and plan files. Retro trails fit the same routine-output pattern: mechanical persistence artefacts written by /wr-retrospective:run-retro Step 2d (ask-hygiene trail) and Step 5 (retro summary). Per-iter gate cost is paid for no governance benefit.

Symptoms

• Every iter that writes a docs/retros/<date>-*.md trail pays the architect-enforce-edit + jtbd-enforce-edit gate delegation cost (subagent invocations, marker hash refresh).
• Routine ask-hygiene trail writes trigger the same gate flow as edits to source code, hook scripts, ADR proposals.
• Approximately 45 seconds of wall-clock per retro write observed across iter 3, iter 4, iter 6 of the 2026-05-12 AFK loop.

Workaround

None inline. Per-iter gate cost is the workaround until the exclusion lands upstream.

Affected plugin or component

multiple plugins (wr-architect + wr-jtbd)

Frequency

every iter (the retro trail write), plus any BRIEFING.md retro updates.

Local plugin version

wr-architect@0.6.1 + wr-jtbd@0.7.3

Upstream package version

not applicable

Claude Code CLI version

2.1.140

Node version

v22.17.1

Operating system

Darwin 25.3.0 x86_64

Evidence

• 2026-05-12 AFK iter 3 retro at docs/retros/2026-05-12-afk-iter-3-p050-ask-hygiene.md: single-character em-dash substitution in this file triggered two gate round-trips.
• 2026-05-12 AFK iter 4 + iter 6 retros: identical pattern recurred.
• Sibling exclusion paths are already implemented in packages/architect/hooks/architect-enforce-edit.sh + packages/jtbd/hooks/jtbd-enforce-edit.sh for the existing entries; this report asks to add docs/retros/ to the same list.

Additional context

• Composes with windyroad/agent-plugins#? (sibling hook-protocol surface; em-dash hook port to Edit-tool surface, tracked locally as P057).
• The downstream /wr-retrospective:run-retro skill writes ask-hygiene trails and retro summaries on every AFK iter close per the P086 retro-on-exit contract; the gate-fire cascade is per-iter, not per-session.

Cross-reference

Reported from https://github.com/windyroad/windyroad/blob/master/docs/problems/058-architect-and-jtbd-edit-enforce-hooks-should-exclude-docs-retros.open.md

This issue is tracked locally as P058 in the downstream project's docs/problems/ directory.

[tompahoward]

Thanks for the report. Tracked locally as docs/problems/open/203-architect-jtbd-enforce-edit-hooks-should-add-docs-retros-to-exclusion-paths.md (P203, classified via /wr-itil:review-problems Step 4.5e safe-and-valid with safe-low-fix-risk).