claudiomaradonna/agent-foundry
claudiomaradonna/agent-foundry
Template
1
0
Fork 0
Code Issues Pull requests Activity Actions

fix(agents): give a restated passage one kind #102

Merged
claudiomaradonna merged 1 commit from fix/auditor-kinds into main 2026-10-15 21:52:16 +02:00
Conversation 0 Commits 1 Files changed 1 +15 -10
motoko commented 2026-10-15 21:29:19 +02:00
Collaborator
Copy link

Why

document-auditor could report one passage under two kinds: a restatement for the same reader was both a duplicate and a rule finding, so two audits of one document could disagree on kinds and counts (#83).

What changed

  • Each passage now takes one kind: a duplicate wins over noise and misplaced, a restatement for another reader is a duplicate only where it contradicts its home, and a rule finding covers only text no other kind covers.
  • The kind's edit also brings the text it keeps within the writing rules, so a moved or corrected passage loses no finding.

How to verify

  1. Read the paragraph of .agents/agents/document-auditor.md that sorts passages, with a README step that restates AGENTS.md's commit rule for agents as "never commit to main": before, it was a duplicate and a rule finding; now it is a duplicate, whose edit links to the home or deletes it.
  2. bash tests/verify-agent-config.sh passes, the auditor's adapters still pointing to the brief.

The six Maintenance checks pass at the tip.

Considerations

  • One ranking edge remains: a late passage that is noise and also contradicts a home written for another reader can still be read two ways; the review rounds on this paragraph were capped before it.
## Why `document-auditor` could report one passage under two kinds: a restatement for the same reader was both a duplicate and a rule finding, so two audits of one document could disagree on kinds and counts (#83). ## What changed - Each passage now takes one kind: a duplicate wins over noise and misplaced, a restatement for another reader is a duplicate only where it contradicts its home, and a rule finding covers only text no other kind covers. - The kind's edit also brings the text it keeps within the writing rules, so a moved or corrected passage loses no finding. ## How to verify 1. Read the paragraph of `.agents/agents/document-auditor.md` that sorts passages, with a README step that restates `AGENTS.md`'s commit rule for agents as "never commit to main": before, it was a duplicate and a rule finding; now it is a duplicate, whose edit links to the home or deletes it. 2. `bash tests/verify-agent-config.sh` passes, the auditor's adapters still pointing to the brief. The six Maintenance checks pass at the tip. ## Considerations - One ranking edge remains: a late passage that is noise and also contradicts a home written for another reader can still be read two ways; the review rounds on this paragraph were capped before it. 
document-auditor's rule-finding sentence covered every other rule of
the Documentation and Writing sections, the one-home rule included,
so a same-reader restatement was both a duplicate and a rule finding.
The sentence now sets the one-home rule aside.

Closes #83.
motoko force-pushed fix/auditor-kinds from 6ab1e599c4 to c900ffd023 2026-10-15 21:50:27 +02:00 Compare
claudiomaradonna deleted branch fix/auditor-kinds 2026-10-15 21:52:22 +02:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
claudiomaradonna/agent-foundry!102
No description provided.