Skip to content

[AAASM-3940] ✨ (docs): Add org-level CLAUDE.md and AGENTS.md baseline#26

Merged
Chisanan232 merged 2 commits into
masterfrom
v0.1.0/AAASM-3940/create_claude_agents_baseline
Jul 6, 2026
Merged

[AAASM-3940] ✨ (docs): Add org-level CLAUDE.md and AGENTS.md baseline#26
Chisanan232 merged 2 commits into
masterfrom
v0.1.0/AAASM-3940/create_claude_agents_baseline

Conversation

@Chisanan232

@Chisanan232 Chisanan232 commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

Jira Ticket

Summary

Changes

  • CLAUDE.md: additive "AI tooling: rules, skills, and Codex parity" section — no existing content rewritten or duplicated.
  • AGENTS.md (new): compact, self-sufficient Codex entry point — product summary, repo map, commit/branch/PR conventions, remote-naming gotcha, CI reality, JIRA conventions, project policy, and a pointer to .claude/rules/ and .claude/skills/ (with a note that org policy in those rules/skills applies to Codex work too, even though Codex has no native skill loader).

Validation

  • Content reviewed for accuracy
  • Links verified
  • No unintended scope changes

Checklist

  • PR title follows: [<ticket ID>] <GitEmoji> (<change scope category>): <key point as summary>
  • PR body follows this template

@Chisanan232

Copy link
Copy Markdown
Contributor Author

Claude Code review — AAASM-3940

CI: Red, same org-wide Actions billing-block as every other PR in this stack (see #25's comment for detail) — not caused by this change.

Scope vs ticket: Matches AAASM-3940's acceptance criteria — CLAUDE.md gets a compact additive pointer section (verified via git diff against pre-Epic master: 16 lines added, 0 lines removed from the existing file — no rewriting), and AGENTS.md is a new, self-sufficient Codex baseline.

Side effects: None on existing CLAUDE.md content — confirmed pure addition, not a rewrite.

Note (non-blocking): 3946's dogfooding pass later found AGENTS.md doesn't inline the policy from 05-context-boundary.md/06-audit-trail.md (added in #27), so a Codex session is structurally blind to that guidance in a way a Claude Code session isn't. Tracked as follow-up item #6 in #33 — not an AAASM-3940 AC gap, since those rule files didn't exist yet when this ticket was scoped.

Frontend: N/A.

Recommend: ready to merge, after #25.

Adds a short section noting AGENTS.md exists as the Codex-facing
counterpart to this file, and that .claude/rules/ and .claude/skills/
are reserved org-wide directories to be populated by AAASM-3941/3942.
Gives Codex (which does not read CLAUDE.md) a self-sufficient
org-wide entry point covering product summary, repo map,
commit/branch/PR conventions, remote-naming gotcha, CI reality,
JIRA conventions, and project policy, plus a pointer to the
upcoming .claude/rules and .claude/skills directories.
@Chisanan232 Chisanan232 force-pushed the v0.1.0/AAASM-3940/create_claude_agents_baseline branch from 4d19b86 to a79c585 Compare July 6, 2026 00:19
@Chisanan232 Chisanan232 merged commit 2c11408 into master Jul 6, 2026
@Chisanan232 Chisanan232 deleted the v0.1.0/AAASM-3940/create_claude_agents_baseline branch July 6, 2026 00:21
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