[AAASM-3074] 📝 (docs): Add org-wide baseline CLAUDE.md for LLM-assisted dev#21
Merged
Merged
Conversation
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>
Contributor
Author
🤖 Claude Code — PR reviewTicket: AAASM-3074 (Epic AAASM-3065). The org-wide baseline.
Verdict: ready to approve & merge — this is the link target the per-repo |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
Adds a canonical org-wide baseline
CLAUDE.mdat the root of the org.githubrepo.It documents the org-universal context that every per-repo
.claude/CLAUDE.mdshould reference rather than duplicate: the product/architecture overview + repo map, shared commit/branch/PR conventions, the remote + default-branch detection rules (canonical remote isremoteororigindepending on the repo; default ismasterexcept docs/inner-document which aremain; org id is lowercaseai-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.
Scope
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