Skip to content

refactor: consolidate CLAUDE.md into AGENTS.md as single source of truth#12

Merged
AndyBoWu merged 1 commit into
mainfrom
refactor/consolidate-claude-agents-md
Mar 12, 2026
Merged

refactor: consolidate CLAUDE.md into AGENTS.md as single source of truth#12
AndyBoWu merged 1 commit into
mainfrom
refactor/consolidate-claude-agents-md

Conversation

@AndyBoWu

Copy link
Copy Markdown
Member

Summary

  • Reduce CLAUDE.md to a thin shim (@AGENTS.md), matching the pattern in nexus-demo
  • Merge all unique CLAUDE.md content (repo description, structure, agent anatomy, adding new agent, key conventions) into AGENTS.md
  • Deduplicate overlapping sections (agent shape, config.yaml rules, failure handling, skill boundaries)

Test plan

  • Verify AGENTS.md contains all information previously split across both files
  • Verify no content was lost during the merge
  • Confirm CLAUDE.md correctly references AGENTS.md via @AGENTS.md directive

CLAUDE.md and AGENTS.md had significant content overlap (agent shape,
config.yaml rules, failure handling, skill boundaries). Make AGENTS.md
the authoritative entry point and reduce CLAUDE.md to a thin shim that
imports it, matching the pattern used in nexus-demo.
@github-actions github-actions Bot added the meta Repo-level files (AGENTS.md, README, reference) label Mar 12, 2026
@AndyBoWu AndyBoWu merged commit 25d0685 into main Mar 12, 2026
5 checks passed
@AndyBoWu AndyBoWu deleted the refactor/consolidate-claude-agents-md branch March 12, 2026 17:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

meta Repo-level files (AGENTS.md, README, reference)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant