Development record
The comment line of the .gitignore block ahoy install writes into an adopted repository uses an em dash ('# abcd-managed block — do not hand-edit. Run /abcd:ahoy to refresh.'), so a repository whose own writing rules ban em dashes or non-ASCII in committed files fails them on a line it cannot edit, since the block is managed. Reproduced at tip with a private-visibility install into a scratch repository. Sibling of the conventions-file block's em dashes (iss-2610020700529281).
issueresolvednitpickiss-2610020704163406
The comment line of the .gitignore block ahoy install writes into an adopted repository uses an em dash ('# abcd-managed block — do not hand-edit. Run /abcd:ahoy to refresh.'), so a repository whose own writing rules ban em dashes or non-ASCII in committed files fails them on a line it cannot edit, since the block is managed. Reproduced at tip with a private-visibility install into a scratch repository. Sibling of the conventions-file block's em dashes (iss-2610020700529281).
Grounds
- pursued: every byte ahoy install writes into .gitignore is ASCII, fresh or refreshing an old block, and an existing install's old comment is not flagged as drift; a non-ASCII byte in a freshly installed .gitignore, or ahoy detect reporting drift on a block whose only difference is the old comment, would show it wrong.
Frontmatter
| id | iss-2610020704163406 |
|---|---|
| type | issue |
| lifecycle | resolved |
| severity | nitpick |
.abcd/work/issues/resolved/iss-2610020704163406-the-comment-line-of-the-gitignore-block.md
open on GitHub ↗ · commit history ↗
mentions1
- iss-2610020700529281The managed block ahoy install plants into an adopted repository's conventions file when a docs target is chosen (internal/core/ahoy/defaults/claude-md-marker-block.md) is abcd's own rule-loader section copied verbatim, and it breaks the repositories that receive it. (a) It ends 'For internals see .abcd/development/brief/05-internals/03-configuration.md' and says OPINIONS points at .abcd/development/principles/; both exist only in abcd's own repository, so they dangle in every adopted one. (b) At tip it is 98 lines with em dashes on 10 of them, so a repository whose own AGENTS.md rules bound file length, ban em dashes or require every link to resolve fails its own gate on the block. (c) Its header says /abcd:ahoy 'silently overwrites this block on drift (per itd-3)', citing an abcd-internal record id, so the adopter cannot trim it to fit. (d) It is inserted directly under the H1, ahead of the repository's own opening text. This record is intent-shaped: the ask is a capability, a short pointer variant of the block for adopted repositories (a few ASCII lines, no repository-internal links or record ids) or keeping the long text where consumer repositories never commit it; routing it to an intent is the product thinker's call. Related: iss-2609110944498549 (resolved, the default docs target is skip) and iss-2608210934566220 (the injected OPINIONS pointers dangle in managed repositories).