[AAASM-3939] 📝 (workspace): Add org-level AI workspace layout doc#25
Conversation
Defines workspace-root vs repo-root responsibilities, the .github repo's role as source-of-truth/bootstrap source, the override model, and Claude Code / Codex discovery assumptions for the AAASM-3938 onboarding POC.
|
Claude Code review — AAASM-3939 CI: Red, but root cause is infra, not this change. Scope vs ticket: Matches all AAASM-3939 acceptance criteria — workspace-root vs repo-root responsibilities, Side effects: None — single new file, no existing content touched. Frontend: N/A, no FE code in this change. Recommend: ready to merge first in the stack (no dependencies). |
Jira Ticket
Summary
.githubrepo participates as source-of-truth/bootstrap source.Changes
.claude/WORKSPACE.mddocumenting: proposed local workspace layout, workspace-root responsibilities, repo-root responsibilities,.githubrepo's role, the override model (repo-local.claude/rules|skillsshadow org-level ones by filename), and explicit Claude Code / Codex discovery assumptions (nearest-directory-wins, no cross-repo auto-fetch).Validation
Checklist
[<ticket ID>] <GitEmoji> (<change scope category>): <key point as summary>