Skip to content

refactor(agents): consolidate agent set 18 to 7 + skill taxonomy + CI reorg (ADR-0038) - #13

Merged
ronsilver merged 7 commits into
mainfrom
refactor/agent-set-cleanup-7-agents
Aug 25, 2026
Merged

ronsilver merged 7 commits into
mainfrom
refactor/agent-set-cleanup-7-agents

Conversation

@ronsilver

Copy link
Copy Markdown
Owner

Summary

  • Agent-set consolidation 18→7: prune supported agents to {antigravity, claude-code, codex-app, codex-cli, omp, opencode, pi}; remove windsurf, windsurf-jetbrains, cursor, cursor-cli, copilot-cli, copilot-app, copilot-vscode, copilot-intellij, claude-desktop, gemini-cli, local-project. Updates manifest template, kernels (add codex-cli/omp/pi, drop copilot), validator TOOL_AGENTS/FILE_AGENTS arrays, pruning scripts, and canonical paths. ADR-0038 records the decision.
  • Skill-invocation taxonomy fix: split TOOL vs FILE skill-invocation semantics across 17 subagent bodies + templates so skill loading is agent-agnostic (was hardcoded to Claude Code). Subagent targets pruned to {opencode, claudecode, codex}; skill-router 3.1→3.2, governance 2.4→2.5.
  • Spanish→English: translated skills-core definition, skills-definitions, SKILL_QUALITY_STANDARD, and docs/reference catalogs per English-only content policy.
  • Makefile reorg + CI guard: grouped sections, new lint-yaml-json target, check deps updated; check.yml switches to make lint-md + make lint-yaml-json and adds a benchmark-exclusion guard step.

Type of change

  • New skill
  • Skill update / fix
  • New or updated rule pack
  • New hook
  • Infrastructure / validation / CI
  • Documentation

Checklist

  • make check passes locally
  • New SKILL.md files have all required frontmatter (name, description, license, metadata.*)
  • All → references/X.md links in new/edited SKILL.md files resolve to real files
  • No secrets, PII, or real credentials in any committed file
  • make validate-skill-refs run and findings reviewed (existing failures pre-date this PR)

Testing

  • make check → all checks passed (lint → lint-md → lint-yaml-json → fmt-check → validate → test, 243 Bats assertions)
  • make test → all tests passed
  • Commits grouped into 7 coherent, conventional-commit units (agent set → taxonomy → translations → docs/ADR → tests → build/CI → changelog)

Intentional exclusions

  • docs/plans/cleanup-agent-set-2026-08-24.md — gitignored (docs/plans/)
  • manifest.yaml — gitignored (local manifest; manifest.example.yaml is the committed template)
  • CLAUDE.md — untracked GitNexus-generated root config, unrelated to this change
  • .opencode/node_modules/, .gitnexus/ — gitignored

Keep antigravity, claude-code, codex-app, codex-cli, omp, opencode, pi.
Remove windsurf, windsurf-jetbrains, cursor, cursor-cli, copilot-cli,
copilot-app, copilot-vscode, copilot-intellij, claude-desktop, gemini-cli,
local-project.

- manifest.example.yaml pruned to 7 agents with pi/omp/codex blocks
- add codex-cli, omp, pi kernels; drop copilot-global kernel
- validate-kernel-skill-coherence.sh TOOL_AGENTS/FILE_AGENTS arrays
- validate.sh portable parent-dir fix
- bootstrap-symlinks, sync.sh, lib/sync.sh, validate-shell-safety prune
  removed-agent references
- docs/canonical-paths.yaml pruned to 7 agents
- content/mcp/.env.example drops windsurf memory path
Split TOOL_AGENTS vs FILE_AGENTS skill invocation semantics so skill
loading is agent-agnostic instead of hardcoding Claude Code behavior.
- 17 subagent bodies + _TEMPLATE + git-requests step-0 neutralized
- subagent targets pruned to {opencode, claudecode, codex}
- skill-router 3.1->3.2 and governance 2.4->2.5 version bumps
- boot-manifest.yaml, content/rules/README.md, runner-matrix, _TEMPLATE
- skill-invocation-matrix validation rows updated to 7 agents
English-only content/ and docs/ policy (ADR governance invariant 6/10).
- docs/skills-core-definition.md, docs/skills-definitions.md,
  docs/SKILL_QUALITY_STANDARD.md
- docs/reference/{subagents-catalog,master-catalog-mapping,lsp-reference,
  workflows-catalog,subagent-schema}.md
- docs/validation/canonical-paths.yaml
- ADR-0038 records the 18-to-7 agent-set consolidation decision
- README, AGENTS.md (incl. gitnexus H2 fix + agent counts), CONTRIBUTING
- content/mcp/README.md MCP sync paths for 7 kept agents
- docs/reference {skills-catalog,rules-reference,mcp-servers}
- test_boot_skill_step_zero and test_kernel_invocation_clause strings
  updated for the 7-agent set + skill-invocation taxonomy
- remove docs/validation/path-validation.md (superseded by
  canonical-paths.yaml)
- Makefile regrouped into logical sections; new lint-yaml-json target;
  check deps updated
- check.yml: lint-markdown -> make lint-md, lint-yaml-json job runs
  make lint-yaml-json, benchmark-exclusion guard step + policy comment
@ronsilver ronsilver self-assigned this Aug 25, 2026
@ronsilver
ronsilver merged commit 3a0bd11 into main Aug 25, 2026
11 of 12 checks passed
@ronsilver
ronsilver deleted the refactor/agent-set-cleanup-7-agents branch August 25, 2026 17:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant