Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

docs(agents): consolidate manuals into one AGENTS.md + symlink CLAUDE.md#164

Open
vsits-team-lead-agent[bot] wants to merge 3 commits into
main from
docs/consolidate-agents-symlink
Open

docs(agents): consolidate manuals into one AGENTS.md + symlink CLAUDE.md #164
vsits-team-lead-agent[bot] wants to merge 3 commits into
main from
docs/consolidate-agents-symlink

Conversation

@vsits-team-lead-agent

@vsits-team-lead-agent vsits-team-lead-agent Bot commented May 28, 2026

Copy link
Copy Markdown
Contributor

⚠️ DO NOT MERGE YET. Proxy Builder is actively working in this repo. Merging converts CLAUDE.md from a regular file into a symlink, which changes PB's working tree on next pull — coordinate so PB is at a clean stopping point first.

Consolidates the two separate manuals into a single canonical AGENTS.md, then makes CLAUDE.md a symlink to it — matching the convention aegis and RCB already use (one manual per repo, discoverable under both names).

What changed

  • AGENTS.md is now the single manual, role-sectioned:
    • # Project-wide — Git Workflow, GitHub Bot Identity, Agent Roles, Review Workflow, PR Labels, Cross-LLM Review, Non-Functional Requirements & Anti-Bloat (the standard from docs: NFR + anti-bloat review standard (pilot) #161 ), Public Communication, Public-Repo Information Hygiene, Release Safety Rules. (All from the old CLAUDE.md.)
    • # Codex Review Agent — Role, PR Review Workflow, Labels You Own, What/How You Review (incl. the anti-bloat lens), Review Output Format, Context, What You Do NOT Do. (All from the old AGENTS.md.)
  • CLAUDE.md → symlink to AGENTS.md (mode 120000).
  • Added bloat-cleanup to the canonical PR Labels list.

One reconciliation to confirm

The two manuals contradicted each other on comment attribution: the reviewer manual said prefix Codex review:, the project-wide manual said postfix — Codex review and "do not prefix." A merged file can't hold both — I standardized on the project-wide postfix convention (consistent with the global agent sign-off rule). Flagging it explicitly; revert if you'd rather keep the prefix for the reviewer.

All other content is preserved verbatim, just reorganized. No code touched.

— AI Team Lead

...CLAUDE.md
Merges the builder manual (CLAUDE.md) and Codex-reviewer manual (AGENTS.md) into
a single canonical AGENTS.md (Project-wide + Codex Review Agent sections), then
makes CLAUDE.md a symlink to it (matches aegis/RCB). All content preserved;
reconciles one contradiction (sign-off: postfix "— Codex review", not the old
"Codex review:" prefix). Adds bloat-cleanup to the canonical label list.
@vsits-team-lead-agent vsits-team-lead-agent Bot added the documentation Improvements or additions to documentation label May 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

documentation Improvements or additions to documentation

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

0 participants

AltStyle によって変換されたページ (->オリジナル) /