snap-agents-md

AGENTS.md is canonical: root = repo defaults, nested = subtree deltas; parent applies unless local overrides, nearest wins, user wins. Add scopes for behavior splits, not folder taxonomy; CLAUDE.md is inventory context/optional alias.

Process

1. Inventory

   • Find all AGENTS.md/CLAUDE.md with available search tools (fd, find, rg, glob); include symlinks/hidden paths when relevant.
   • For each path: record link target and resolved realpath.
   • Same realpath = aliases; read once. Distinct real files = read both as context.

2. Explore

   • Read manifests, workspace config, lockfiles, scripts, docs, tests, deploy seams, generated paths, domain seams.

3. Decide files

   • Classify: single-root, multi-scope, domain-scoped, divergent monorepo.
   • Show before drafting: path | purpose | template | action.
   • Ask only for missing intent, conflicts, or risky overwrite.