Converge a project — greenfield or half-way-there — toward the canonical agent-neutral structure\nspecified in references/target-structure.md (read it before the\naudit), so a team of developers using different agents shares one lean, progressively disclosed\nsetup. Re-running converges further and reports drift.
\nInvocation: /agentify-project [audit] [path]
audit — run step 1 only, print the findings and what a full run would change, modify nothing;\nthe periodic drift check.path — target a subdirectory instead of the repo root (see Monorepos)..claude/skills/ links, the Claude gitignore entries) is applied\nunconditionally, never detection-gated..claude/commands/, .claude/agents/, .claude/rules/): report,\nleave. Flag .claude/rules/ content as candidate governing-doc material (path-scoped rules are\na Claude-specific disclosure mechanism); legacy commands may get a one-off note that they could\nbecome skills — the conversion itself is out of scope./context-checkup later.Done when every target-structure area has a detected state and every agent trace found is\naccounted for.
\nMulti-select over the applicable change areas only — entry-file indirection, AGENTS.md slimming\ninto docs, skills relocation + symlinks, gitignore hygiene, planning dir, onboarding doc, README\npointer — each annotated with audit findings (e.g. \"CLAUDE.md, 180 lines, no AGENTS.md →\nindirection + slimming\"). \"All\" is the first and recommended option. Report already-converged\nareas ✓ and omit them from the choices. Every area is independently skippable: a team may\ndeliberately stay Claude-only (no multi-agent support) — then apply the selected areas within the\nClaude-only variant in target-structure.md.
\nApply each accepted area immediately, behind its approval gate — no migration-plan artifact: the\nmoves are mostly mechanical, and re-running converges. Suggested order: entry files →\nslimming/docs → skills → gitignore → extras.
\nEntry files. Invariant covering every starting state: the content of all existing entry\nfiles — any agent's, including a divergent CLAUDE.md + AGENTS.md pair — feeds the slimming\nmapping; AGENTS.md ends canonical; every detected entry file ends as a pointer (or duplicated\ncontent, per matrix), CLAUDE.md always included. Common case (CLAUDE.md exists, no AGENTS.md):\nrename it to AGENTS.md — git detects the rename — and recreate CLAUDE.md as @AGENTS.md plus any\ngenuinely Claude-specific remainder. AGENTS.md-only and third-party-only repos: same invariant —\ncreate the missing pointer(s), seed AGENTS.md from whatever entry-file content exists. Greenfield\n(no entry file of any agent): minimal seed from cheap reconnaissance (README, package manifest /\nbuild files) — one-liner, verified build/test/run commands, planning-dir convention — plus\nthe pointer; deep doc generation is out of scope, the structure grows later via /self-improve\nand /memory-doctor.
Slimming (mapping-first). Draft one full mapping: each block → stays / moves to existing doc\nX / new doc Y, applying the keep-vs-extract test (target-structure §1); where a block's relevance\nis verifiable from the codebase, check the code instead of asking. Present the mapping with\nobvious calls pre-decided; walk only doubtful blocks as individual questions, each with a\nrecommendation; one approval gate before any edit. Offer a compaction pass on blocks that stay;\nwrite extracted docs compact from birth — via compact-docs-writer when installed, else inline\nwith its core principle (least text, zero information loss). Each extracted doc gets a plain-link\nindex entry in AGENTS.md with its \"read when…\" hook.
Skills. Move real dirs, create relative symlinks (committed), per matrix; leave\nforeign/personal links untouched and report them.
\nGitignore. Show the proposed block as a diff; apply on approval.
\nExtras. Planning dir + AGENTS.md convention line; onboarding doc; README pointer.
\nDone when every selected area is applied or explicitly skipped by the user.
\nEvery AGENTS.md reference resolves; symlinks point at real dirs; git check-ignore confirms each\nignore entry; CLAUDE.md pointer intact; duplicated entry files match AGENTS.md. Close with a\nshort converged-state report of what changed.
Suggest, each only when installed and applicable — skip silently otherwise:
\n/memory-doctor — when the agent accumulates project memory (e.g. auto memory) — to relocate\nsaved lessons into the new docs structure and share them with the team; it no-ops harmlessly on\nempty memory, so no content check is needed./context-checkup — measure what now auto-loads, with the audit's entry-file line counts as\nthe coarse before-figure.Full treatment targets the repo root. Nested entry files are offered only the cheap mechanical\nindirection (nested CLAUDE.md → nested AGENTS.md + pointer); defer nested slimming to a re-run\nwith that subdirectory as the path argument.