Skip to content

[AAASM-3074] 📝 (docs): Add org-wide baseline CLAUDE.md for LLM-assisted dev#21

Merged
Chisanan232 merged 1 commit into
masterfrom
v0.0.1/AAASM-3074/docs/claude_md
Jun 16, 2026
Merged

[AAASM-3074] 📝 (docs): Add org-wide baseline CLAUDE.md for LLM-assisted dev#21
Chisanan232 merged 1 commit into
masterfrom
v0.0.1/AAASM-3074/docs/claude_md

Conversation

@Chisanan232

Copy link
Copy Markdown
Contributor

What changed

Adds a canonical org-wide baseline CLAUDE.md at the root of the org .github repo.

It documents the org-universal context that every per-repo .claude/CLAUDE.md should reference rather than duplicate: the product/architecture overview + repo map, shared commit/branch/PR conventions, the remote + default-branch detection rules (canonical remote is remote or origin depending on the repo; default is master except docs/inner-document which are main; org id is lowercase ai-agent-assembly), the GHA billing-block reality (validate locally), JIRA conventions (component=repo 1:1, Team Pioneer), project policy (no self-hosted; spec stays in the monorepo), and the "document the WHY, not the WHAT" documentation standard.

Why

Almost every cross-repo friction point is org-universal but non-obvious. Centralising it in one source-of-truth lets each repo's CLAUDE.md stay thin and consistent, and reduces drift as the per-repo files multiply.

Important: this is a documentation convention, not enforcement — GitHub does not auto-apply a CLAUDE.md across repos. Claude Code reads the file in the repo you're in plus your global ~/.claude/CLAUDE.md. This baseline is the link target the per-repo files point at.

Scope

  • Docs-only: one new file, CLAUDE.md (103 lines). No workflow/template changes.

Part of Epic AAASM-3065 (per-repo CLAUDE.md + org baseline). Closes AAASM-3074.

🤖 Generated with Claude Code

Canonical source-of-truth for org-universal context that per-repo
.claude/CLAUDE.md files reference: product/architecture overview, repo map,
shared commit/branch/PR conventions, remote+default-branch detection rules,
the GHA billing-block reality, JIRA conventions, project policy, and the
'document the WHY not WHAT' doc standard. Notes that GitHub does not
auto-inherit CLAUDE.md — this is a referenced convention. Refs AAASM-3074.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@Chisanan232

Copy link
Copy Markdown
Contributor Author

🤖 Claude Code — PR review

Ticket: AAASM-3074 (Epic AAASM-3065). The org-wide baseline.

  • CI: none configured on this meta repo (community-health + workflow-templates) — nothing to gate.
  • Scope: ✅ 1 file, CLAUDE.md, +103/-0. No changes to templates/workflows.
  • Content: product/architecture + repo map, shared commit/branch/PR conventions, the remote + default-branch detection rules (canonical remote varies remote/origin; default varies master/main; org id lowercase), GHA billing-block reality, JIRA conventions, project policy, and the "document the WHY not WHAT" standard. Explicitly states this is a referenced convention, not GitHub inheritance.

Verdict: ready to approve & merge — this is the link target the per-repo .claude/CLAUDE.md files point at.

@Chisanan232 Chisanan232 merged commit 6dfe614 into master Jun 16, 2026
@Chisanan232 Chisanan232 deleted the v0.0.1/AAASM-3074/docs/claude_md branch June 16, 2026 14:24
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