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

mvvmm · mvvmm · commit 1c407a37daf2 · 2026-06-09T10:44: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/.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/.windsurf/workflows b/.windsurf/workflows
@@ -0,0 +1 @@
+../.agents/commands
diff --git a/AGENTS.md b/AGENTS.md
@@ -244,9 +244,13 @@ 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
+## Agent skills, commands, and agents
 
-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.
+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/`. Load a skill when the task matches its description.
 
 | Skill               | When to use                                                        |
 | ------------------- | ------------------------------------------------------------------ |
@@ -257,6 +261,27 @@ Repo-specific skills live in `.agents/skills/`. Each skill provides specialized
 | `eli5`              | Simplifying technical documentation for broader audiences          |
 | `pr`                | Creating or updating GitHub pull requests                          |
 
+### Commands
+
+Slash commands live in `.agents/commands/` (symlinked from `.opencode/commands/`).
+
+| Command                | Description                                     |
+| ---------------------- | ----------------------------------------------- |
+| `changelog`            | Generate a product changelog entry              |
+| `pr`                   | Create a pull request for current branch        |
+| `review-code-examples` | Review code examples in documentation           |
+| `styleguide`           | Validate changes against the style guide        |
+
+### Agents
+
+Custom agent definitions live in `.agents/agents/` (symlinked from `.opencode/agents/`).
+
+| Agent  | Description                                      |
+| ------ | ------------------------------------------------ |
+| `docs` | Documentation writer persona used by `/changelog` |
+
+### Reference files
+
 Shared reference files in `.agents/references/`:
 
 | File             | Contents                                                    |
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
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
