Development record
The conventions-file intent removes the CLAUDE.md and GEMINI.md links; the docs chapter still justifies its root-symlink rule by the bridge files it lets pass.
The conventions-file intent removes the CLAUDE.md and GEMINI.md links; the docs chapter still justifies its root-symlink rule by the bridge files it lets pass.
A premise contradiction (severity nitpick) found by the cross-document consistency pass.
- End A:
.abcd/development/intents/shipped/itd-2610030814013772-evaluate-whether-claude-md-can-be.md:84— "this repository's CLAUDE.md and GEMINI.md links are removed whichever way the rest falls" - End B:
.abcd/development/brief/04-surfaces/10-docs.md:160— "what lets the bridge files pass while appearing in no allowlist"
The intent removes this repository's CLAUDE.md and GEMINI.md links, and has abcd write no separate conventions copy for any tool. The docs chapter judges a root markdown symlink by its target's stem, and gives as the reason that this is what lets the bridge files pass while appearing in no allowlist. That reason assumes bridge files still stand at the root, and the intent says they were removed.
Evidence: .abcd/work/reviews/2026-10-26-consistency/00-summary.md, finding 670.
Grounds
- declined: Closed in the 2026-10-27 triage (dcn-2610271112330536): the two ends do not conflict when read in full. internal/core/lint/lint.go still exempts a root symlink that resolves to AGENTS.md, and the intent keeps the claude_md and both values readable for detection; the chapter describes the rule's mechanism, not a link abcd's repository holds.
Frontmatter
| id | iss-2610262036446593 |
|---|---|
| type | issue |
| lifecycle | wontfix |
| severity | nitpick |
.abcd/work/issues/wontfix/iss-2610262036446593-the-conventions-file-intent-removes-the.md
open on GitHub ↗ · commit history ↗
References1
- itd-2610030814013772abcd's projects keep one conventions file, AGENTS.md, and Claude Code reads it directlyrelated
mentions1
- dcn-26102711123305362026-10-27 — The product thinker accepted on 2026-10-27 the triage of the 1301 records the 2026-10-26 consistency pass filed. The duplicates, the records a later record already settles, the ones that are no contradiction and the one already fixed are closed with each reader's reason. Every other record gets its fix as its remedy, the rulings' accepted answers included, so a drain can take it. The 45 major records left open are deferred past v0.15.1, because the brief's single-home rewrite rewrites or removes most of the passages they quote. The person ruled the major rulings one at a time; the minor rulings take their recommended answers.