Skip to content

Add CLAUDE.md and consolidate AI agent conventions#168

Open
aram356 wants to merge 4 commits intomainfrom
chore/claude-md-agent-conventions
Open

Add CLAUDE.md and consolidate AI agent conventions#168
aram356 wants to merge 4 commits intomainfrom
chore/claude-md-agent-conventions

Conversation

@aram356
Copy link
Contributor

@aram356 aram356 commented Feb 20, 2026

Summary

  • Add CLAUDE.md as the single source of truth for all AI agent conventions
  • Rewrite AGENTS.md as a thin redirect with fallback rules for Codex
  • Add shared slash commands in .claude/commands/ (tracked in git)
  • Update .gitignore to track .claude/commands/
  • Append review entry to TODO.md

Closes #167

Changes

File Change
CLAUDE.md New — project overview, workspace layout, toolchain, build commands, coding conventions, adapter pattern, CI gates, standard workflow, verification guidance, slash commands, MCPs, key files, deps philosophy, guardrails
AGENTS.md Rewritten — redirects to CLAUDE.md with 9-rule fallback summary
.claude/commands/ New — 5 shared slash commands: /check-ci, /test-all, /test-crate, /review-changes, /verify
.gitignore Updated — track .claude/commands/, keep settings gitignored
TODO.md Appended review entry for AGENTS.md fallback alignment

Local-only (not in this PR)

  • .claude/settings.local.json — expanded permission allowlist and PostToolUse hook for auto cargo fmt

Test plan

  • Verify CLAUDE.md renders correctly on GitHub
  • Verify AGENTS.md fallback rules cover CI-critical conventions
  • Verify slash commands appear in .claude/commands/
  • Confirm no Rust source code was changed (docs-only PR)

Consolidate all project conventions, coding standards, build commands,
workflow rules, and CI requirements into CLAUDE.md. Rewrite AGENTS.md
as a thin redirect with a fallback summary so both Claude Code and
Codex operate under identical rules from one source of truth.
@aram356 aram356 self-assigned this Feb 20, 2026
Track .claude/commands/ in git so the team shares slash commands.
Settings files remain gitignored (local-only).

Commands: /check-ci, /test-all, /test-crate, /review-changes, /verify
Copy link
Contributor

@prk-Jr prk-Jr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me.

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.

Add CLAUDE.md and consolidate AI agent conventions

2 participants

Comments