alunduil / alunduil/blog.alunduil.com

One canonical agent file, every vendor path a thin import

Aperta
#620 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
idea
Lingua principale
Astro
Stelle
1
Fork
1
Merge medio
6h 34m
PR unite (30g)
118

Descrizione

## Spark

AGENTS.md as the single source, with CLAUDE.md and the other vendor paths reduced to thin imports, got filed across seven repos on one day after genshin.dungeon.studio proved it. zfs-replicate went further and deleted its Copilot instruction files outright.

## Why it could be interesting

Every AI coding tool wants its own instruction file at its own path, and keeping N copies in sync fails silently — the agent reads the stale one and nothing errors. The claim: converge on one file, make the vendor paths pointers, and delete the pointer entirely when no tool at that path actually reads it.

## Open questions

- [ ] Which tools genuinely follow an import or pointer, and which need real content at their path? Needs per-tool verification, not assumption.
- [ ] Does a canonical file grow past what any single tool should load every turn? zfs-replicate#477 trimmed CLAUDE.md for exactly that.
- [ ] Is AGENTS.md the right canonical name, or is that betting on one ecosystem's convention?

## Source material

- https://github.com/dungeon-studio/genshin.dungeon.studio/pull/1417, closing https://github.com/dungeon-studio/genshin.dungeon.studio/issues/877 — the proof
- The sweep: https://github.com/alunduil/blog.alunduil.com/issues/587, https://github.com/alunduil/alunduil-chezmoi/issues/635, https://github.com/alunduil/alunduil-infrastructure/issues/427, https://github.com/alunduil/collection-json.hs/issues/299, https://github.com/alunduil/siren-json.hs/issues/154, https://github.com/alunduil/woodland-generators/issues/524, https://github.com/dungeon-studio/dungeon-studio-infrastructure/issues/35
- Deletion instead of a pointer: https://github.com/alunduil/zfs-replicate/issues/484 (closed) and https://github.com/alunduil/zfs-replicate/pull/667
- Token cost: https://github.com/alunduil/zfs-replicate/issues/477 (closed) and https://github.com/alunduil/zfs-replicate/pull/661

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.