Repository navigation
Fix what an agent's read of the templates found #2124
Copy link
Copy link
Open
4 / 144 of 14 issues completedLabels
P2Medium — important but not blockingMedium — important but not blockingepicLarge initiative spanning multiple tasksLarge initiative spanning multiple tasks
Description
An agent's read of all 39 templates on 2026-10-22 scored them 7 out of 10. These children fix the contradictions, wrong facts, ambiguity and weight it found.
Keep
The parts an agent finds most useful, which no child may weaken:
- Rules aimed at agent habits: reach assertions, planted controls, CI evidence, "an issue describes the tree on its filing date"
- A command paired with its pass condition
- "Verifying a finding", from an agent (
core/review.md) - Destructive operations, with the worked example (
core/quality.md) - Agent secrets handling (
security/security.md)
Children
Defects:
- Resolve rules in two templates that contradict each other #2125 rules in two templates that contradict
- Resolve rules that contradict others in the same template #2126 rules that contradict inside one template
- Correct rules that are factually wrong or out of date #2127 rules that are factually wrong or out of date
- Resolve the conflicts and over-broad rules a second agent review found #2139 conflicts and over-broad rules a second agent review found
Decisions:
- Decide the exception policy for a MUST rule #2128 the exception policy for a MUST rule
- Measure which core-tier procedures most projects need #2129 core-tier procedures most projects do not need
Clean-up:
- Demote one organisation's HTTP API style from MUST to an example #2130 one organisation's HTTP style stated as MUST
- Rewrite the declarative templates as imperatives #2131 declarative templates rewritten as imperatives
- Make the score check catch declarative rules and broken wraps #2132 the score check sees the declarative style
- State each repeated rule once, in its widest template #2133 repeated rules stated once
- Name the file and heading wherever a rule cites another section #2134 section references an agent can resolve
- Give each compressed lesson rule an example #2135 compressed lesson rules given examples
Related: #2077, the per-chain contradiction audit, which #2125 and #2126 feed.
Order
- Confirm each finding against its scenario before fixing it
- Fix the confirmed defects: Resolve rules in two templates that contradict each other #2125, Resolve rules that contradict others in the same template #2126, Correct rules that are factually wrong or out of date #2127, Resolve the conflicts and over-broad rules a second agent review found #2139
- Settle the decisions, then the clean-up and style rewrites
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
P2Medium — important but not blockingMedium — important but not blockingepicLarge initiative spanning multiple tasksLarge initiative spanning multiple tasks
Activity