alex/dotfiles
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: flip symlink structure - AGENTS.md is the real file

Browse Source 
AGENTS.md is now the canonical instruction file, with CLAUDE.md,
.cursorrules, and .github/copilot-instructions.md as symlinks to it.

This is simpler and more intuitive - the main file is at the root,
not buried in .github/.

Updated all references across agents, commands, skills, and .memory/.
This commit is contained in:
alex
2026-03-09 12:34:26 +00:00
parent fd5bdd6b0b
commit 33180d6e04
12 changed files with 49 additions and 98 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
.config/opencode/.memory/decisions.md
View File

@@ -17,15 +17,15 @@ See [Plan: Agent Memory Write Access](plans/agent-memory-write-access.md) | See
## Cross-Tool Instruction File Symlink Strategy
**Decision:** Use `.github/copilot-instructions.md` as the single source-of-truth instruction file and represent `AGENTS.md`, `CLAUDE.md`, and `.cursorrules` as symlinks to it.
**Decision:** Use `AGENTS.md` as the single source-of-truth instruction file and represent `CLAUDE.md`, `.cursorrules`, and `.github/copilot-instructions.md` as symlinks to it.
**Rationale:** The previous multi-file sync model required manual propagation/merge logic and could drift. Symlinks remove synchronization overhead and guarantee tool-level consistency by construction.
**Implementation:**
- Updated `AGENTS.md` “Cross-Tool Instruction Files” guidance to document the symlink pattern and initialization/joining workflow.
- Updated `AGENTS.md` "Cross-Tool Instruction Files" guidance to document the symlink pattern and initialization/joining workflow.
- Removed session-start instruction in `AGENTS.md` that required reading additional tool-specific instruction files for merge reconciliation.
- Updated `agents/librarian.md` responsibilities from multi-file sync/merge to maintaining `.github/copilot-instructions.md` plus symlink verification.
- Updated `agents/lead.md` PHASE-WRAP and Documentation Completion Gate to reference `.github/copilot-instructions.md` instead of syncing four files.
- Updated `agents/librarian.md` responsibilities from multi-file sync/merge to maintaining `AGENTS.md` plus symlink verification.
- Updated `agents/lead.md` PHASE-WRAP and Documentation Completion Gate to reference `AGENTS.md` instead of syncing four files.
**Affected files:** `AGENTS.md`, `agents/librarian.md`, `agents/lead.md`, `.memory/knowledge.md`.