Add a lint rule to block the `../AGENTS.md` reference pattern from returning #172

New issue

Closed

opened 2026-06-04 11:20:38 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-06-04 11:20:38 +00:00

Owner

Follow-up from coilyco-bridge/agentic-os-kai#267 (the ../AGENTS.md reference-pattern sweep, now complete across all 17 sibling repos).

Add a catalog lint rule so the brittle relative-path opener can not return. A repo AGENTS.md should never open with:

See ../AGENTS.md for workspace conventions ...

The relative path only resolves when the repo sits as a sibling of agentic-os-kai/; from a worktree, remote build, or isolated clone it points nowhere. The canonical form is the coily-style header:

Workspace conventions load globally via ~/.claude/CLAUDE.md -> agentic-os-kai/AGENTS.md. This file covers only what is specific to this repo.

Suggested shape: extend context-load-points (or a small new agents-md check) to fail when a tracked AGENTS.md contains a \../AGENTS.md`reference. Wire it into.pre-commit-hooks.yaml`, then bump the rev across consumers.

**Follow-up from coilyco-bridge/agentic-os-kai#267** (the `../AGENTS.md` reference-pattern sweep, now complete across all 17 sibling repos). Add a catalog lint rule so the brittle relative-path opener can not return. A repo `AGENTS.md` should never open with: > See `../AGENTS.md` for workspace conventions ... The relative path only resolves when the repo sits as a sibling of `agentic-os-kai/`; from a worktree, remote build, or isolated clone it points nowhere. The canonical form is the coily-style header: > Workspace conventions load globally via `~/.claude/CLAUDE.md` -> `agentic-os-kai/AGENTS.md`. This file covers only what is specific to this repo. **Suggested shape**: extend `context-load-points` (or a small new `agents-md` check) to fail when a tracked `AGENTS.md` contains a `\`../AGENTS.md\`` reference. Wire it into `.pre-commit-hooks.yaml`, then bump the rev across consumers.

coilysiren added the

label

2026-06-17 07:05:13 +00:00

coilysiren commented

2026-06-17 08:23:06 +00:00

Author

Owner

Backlog burndown 2026-06-17: closing low-priority (P3/P4) to bring the open count to a manageable level. Nothing lost — reopen if this resurfaces. Batch tag: burndown-2026-06.

Backlog burndown 2026-06-17: closing low-priority (P3/P4) to bring the open count to a manageable level. Nothing lost — reopen if this resurfaces. Batch tag: `burndown-2026-06`.

coilysiren

2026-06-17 08:23:06 +00:00