Context
This repo's AGENTS.md predates the consolidated global AGENTS.md at
chipi/agentic-ai-homelab/AGENTS.md.
The global owns universal rules; per-project files should keep ONLY
project-specific content. This was codified as decision D-0006 in
agentic-ai-homelab/docs/history/0002-decisions.md.
This repo's AGENTS.md is currently ~669L. Expected post-dedup:
~100-150L of only-project-specific content.
Goal
Bring this project's AGENTS.md into compliance with the D-0006 pattern:
global owns universal rules, project files own only what's specific here.
The classification rule
For every rule currently in AGENTS.md:
| Bucket |
Example |
Action |
| Duplicate of global |
"Never push without explicit approval" |
Delete — global covers it |
| Project specialization |
"Never push to main; the auth team's RFC-0007 mandates PR review" |
Keep + flag relationship to the global rule |
| Project-specific only |
Stack table, named ADR anchors, domain knowledge, custom workflows |
Keep as-is |
If you find yourself reluctant to delete a duplicate because "ours is
worded better", that's a signal to update the global instead — open a PR
to chipi/agentic-ai-homelab first, then come back here.
Concrete steps
- Pull the global side-by-side with this repo's
AGENTS.md:
curl -s https://raw.githubusercontent.com/chipi/agentic-ai-homelab/main/AGENTS.md > /tmp/global-agents.md
diff -u /tmp/global-agents.md AGENTS.md | less
- Classify each rule into one of the three buckets above.
- Add this preamble at the top of
AGENTS.md:
> Layers on `~/.config/opencode/AGENTS.md` (canonical:
> https://github.com/chipi/agentic-ai-homelab/blob/main/AGENTS.md).
> Only project-specific rules live here.
- Verify nothing critical was lost: read the trimmed file end-to-end. If
it reads as "everything an agent specifically working on this project
needs to know that the global doesn't cover", you're done.
- Branch, commit
AGENTS.md: dedup against new global (D-0006), open PR.
Acceptance
Cross-references
Context
This repo's
AGENTS.mdpredates the consolidated globalAGENTS.mdatchipi/agentic-ai-homelab/AGENTS.md.
The global owns universal rules; per-project files should keep ONLY
project-specific content. This was codified as decision D-0006 in
agentic-ai-homelab/docs/history/0002-decisions.md.
This repo's AGENTS.md is currently ~669L. Expected post-dedup:
~100-150L of only-project-specific content.
Goal
Bring this project's
AGENTS.mdinto compliance with the D-0006 pattern:global owns universal rules, project files own only what's specific here.
The classification rule
For every rule currently in
AGENTS.md:If you find yourself reluctant to delete a duplicate because "ours is
worded better", that's a signal to update the global instead — open a PR
to
chipi/agentic-ai-homelabfirst, then come back here.Concrete steps
AGENTS.md:AGENTS.md:it reads as "everything an agent specifically working on this project
needs to know that the global doesn't cover", you're done.
AGENTS.md: dedup against new global (D-0006), open PR.Acceptance
Cross-references
0002-decisions.md0001-genesis.md