chore: consolidate agent config under .agents/, symlink tool-specific paths

mvvmm · mvvmm · commit 73e902a0447e · 2026-06-09T10:58:53.000-05:00
- Move .opencode/command/ -&gt; .agents/commands/ and .opencode/agent/ -&gt; .agents/agents/
- Symlink .opencode/commands and .opencode/agents back to .agents/ (fixes singular/plural too)
- Add CLAUDE.md -&gt; AGENTS.md symlink for Claude Code and VS Code Copilot
- Remove rulesync dependency and ai-setup:* scripts (nothing consumed generated output)
- Update .gitignore: remove rulesync-generated entries, add explicit includes for new dirs
- Update AGENTS.md with commands/agents tables and symlink documentation
diff --git a/.agents/agents/docs.md b/.agents/agents/docs.md
diff --git a/.agents/commands/changelog.md b/.agents/commands/changelog.md
diff --git a/.agents/commands/pr.md b/.agents/commands/pr.md
diff --git a/.agents/commands/review-code-examples.md b/.agents/commands/review-code-examples.md
diff --git a/.agents/commands/styleguide.md b/.agents/commands/styleguide.md
diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
@@ -0,0 +1 @@
+../AGENTS.md
diff --git a/.claude/agents b/.claude/agents
@@ -0,0 +1 @@
+../.agents/agents
diff --git a/.claude/commands b/.claude/commands
@@ -0,0 +1 @@
+../.agents/commands
diff --git a/.claude/skills b/.claude/skills
@@ -0,0 +1 @@
+../.agents/skills
diff --git a/.github/workflows/auto-format-build.yml b/.github/workflows/auto-format-build.yml
@@ -71,6 +71,7 @@ jobs:
           mapfile -t files < <(
             git diff --name-only --diff-filter=ACMR "$BASE_SHA" HEAD \
             | grep -E '\.(js|jsx|ts|tsx|mjs|css|json|yaml|yml|md|astro)$' \
+            | while IFS= read -r f; do [[ -L "$f" ]] || echo "$f"; done \
             || true
           )
           if [ "${#files[@]}" -eq 0 ]; then
diff --git a/.gitignore b/.gitignore
@@ -12,6 +12,8 @@ distllms/
 # skills/ is fetched from middlecache via bin/fetch-skills.ts
 skills/
 !.agents/skills/
+!.agents/commands/
+!.agents/agents/
 !.flue/.agents/
 !.flue/.agents/**
 
@@ -51,15 +53,6 @@ pnpm-debug.log*
 
 tools/relevant_changed_files.txt
 
-# Configuration of AI tools we don't directly support in this repo (generated via rulesync)
-.rulesync/
-.claude/
-CLAUDE.md
-.cursor/
-.github/prompts/
-.github/agents/
-/agents/
-
 # certain versions of opencode mistakenly commit package-lock.json
 .opencode/package-lock.json
 
diff --git a/.opencode/agents b/.opencode/agents
@@ -0,0 +1 @@
+../.agents/agents
diff --git a/.opencode/commands b/.opencode/commands
@@ -0,0 +1 @@
+../.agents/commands
diff --git a/.prettierignore b/.prettierignore
@@ -15,3 +15,8 @@ pnpm-lock.yaml
 
 # Local agent state (not committed but ignore defensively)
 .opencode/
+
+# Symlinks — prettier errors on these
+CLAUDE.md
+GEMINI.md
+.claude/CLAUDE.md
diff --git a/.windsurf/workflows b/.windsurf/workflows
@@ -0,0 +1 @@
+../.agents/commands
diff --git a/AGENTS.md b/AGENTS.md
@@ -244,18 +244,23 @@ New web components in this codebase should use the `cfdocs-` prefix for custom e
 
 Existing components (`warp-download`, `stream-player`, `rule-id`, `check-box`, `r2-local-uploads-diagram`, `animated-workflow-diagram`, `autoconfig-diagram`) are exempt from the `cfdocs-` prefix requirement and do not need to be renamed.
 
-## Agent skills
-
-Repo-specific skills live in `.agents/skills/`. Each skill provides specialized instructions for a particular task. Load a skill when the task matches its description.
-
-| Skill               | When to use                                                        |
-| ------------------- | ------------------------------------------------------------------ |
-| `changelog`         | Creating, editing, or reviewing changelog entries                  |
-| `code-review`       | Reviewing Workers/platform code for type correctness and API usage |
-| `dependabot-review` | Analyzing a Dependabot PR for impact on this repo                  |
-| `docs-review`       | Reviewing documentation PRs for style, structure, and correctness  |
-| `eli5`              | Simplifying technical documentation for broader audiences          |
-| `pr`                | Creating or updating GitHub pull requests                          |
+## Agent skills, commands, and agents
+
+Repo-specific agent config lives in `.agents/`. All subdirectories are committed. Tool-specific paths (`.opencode/commands`, `.opencode/agents`, `CLAUDE.md`) are symlinks into `.agents/`.
+
+### Skills
+
+Skills live in `.agents/skills/`. Each skill's `SKILL.md` describes what it does and when to use it. Load a skill when the task matches its description.
+
+### Commands
+
+Slash commands live in `.agents/commands/` (symlinked from `.opencode/commands/`). Each command's frontmatter describes its purpose.
+
+### Agents
+
+Custom agent definitions live in `.agents/agents/` (symlinked from `.opencode/agents/`). Each agent's frontmatter describes its role.
+
+### Reference files
 
 Shared reference files in `.agents/references/`:
 
diff --git a/GEMINI.md b/GEMINI.md
@@ -0,0 +1 @@
+AGENTS.md
diff --git a/package.json b/package.json
@@ -38,10 +38,6 @@
 		"flue:sync-agents:remote": "tsx .flue/bin/sync-agents.ts",
 		"flue:clear-r2-pr-data:local": "tsx .flue/bin/clear-r2-pr-data.ts --local",
 		"lint": "eslint",
-		"ai-setup:import-from-opencode": "rulesync import --targets opencode --features rules,commands,subagents",
-		"ai-setup:claudecode": "pnpm run ai-setup:import-from-opencode && rulesync generate --targets claudecode --features rules,commands,subagents",
-		"ai-setup:cursor": "pnpm run ai-setup:import-from-opencode && rulesync generate --targets cursor --features commands,subagents",
-		"ai-setup:copilot": "pnpm run ai-setup:import-from-opencode && rulesync generate --targets copilot --features commands,subagents",
 		"prepare": "husky"
 	},
 	"devDependencies": {
@@ -149,7 +145,6 @@
 		"remark": "15.0.1",
 		"remark-gfm": "4.0.1",
 		"remark-stringify": "11.0.0",
-		"rulesync": "8.24.1",
 		"sharp": "0.34.5",
 		"solarflare-theme": "0.0.6",
 		"space-separated-tokens": "2.0.2",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
`@@ -71,6 +71,7 @@ jobs:`
`71`	`71`	`mapfile -t files < <(`
`72`	`72`	`git diff --name-only --diff-filter=ACMR "$BASE_SHA" HEAD \`
`73`	`73`	`\| grep -E '\.(js\|jsx\|ts\|tsx\|mjs\|css\|json\|yaml\|yml\|md\|astro)$' \`
	`74`	`+ \| while IFS= read -r f; do [[ -L "$f" ]] \|\| echo "$f"; done \`
`74`	`75`	`\|\| true`
`75`	`76`	`)`
`76`	`77`	`if [ "${#files[@]}" -eq 0 ]; then`