Skip to content

[AAASM-3939] 📝 (workspace): Add org-level AI workspace layout doc#25

Merged
Chisanan232 merged 1 commit into
masterfrom
v0.1.0/AAASM-3939/define_workspace_layout
Jul 6, 2026
Merged

[AAASM-3939] 📝 (workspace): Add org-level AI workspace layout doc#25
Chisanan232 merged 1 commit into
masterfrom
v0.1.0/AAASM-3939/define_workspace_layout

Conversation

@Chisanan232

@Chisanan232 Chisanan232 commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

Jira Ticket

Summary

  • Defines the org-level AI workspace layout for the AAASM-3938 onboarding POC: what lives at the workspace root vs. each repo root, and how the .github repo participates as source-of-truth/bootstrap source.

Changes

  • Add .claude/WORKSPACE.md documenting: proposed local workspace layout, workspace-root responsibilities, repo-root responsibilities, .github repo's role, the override model (repo-local .claude/rules|skills shadow org-level ones by filename), and explicit Claude Code / Codex discovery assumptions (nearest-directory-wins, no cross-repo auto-fetch).

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

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.
@Chisanan232

Copy link
Copy Markdown
Contributor Author

Claude Code review — AAASM-3939

CI: Red, but root cause is infra, not this change. ci-success.yml runs (event=push) with zero jobs and instant failure — same 0-job/0s pattern also hits the unrelated, already-merged #24 merge commit on master. Check-suites show GitHub Actions: failure while SonarQubeCloud/Codecov/Cloudflare Pages stay stuck queued — consistent with this org's own documented "GitHub Actions frequently billing-blocked" CI reality (see this repo's CLAUDE.md). Not fixable by a code change in this PR; recommend merging on green local validation and treating the Actions billing block as a separate ops item.

Scope vs ticket: Matches all AAASM-3939 acceptance criteria — workspace-root vs repo-root responsibilities, .github's bootstrap/source-of-truth role, override model, and explicit Claude Code/Codex discovery assumptions are all present in .claude/WORKSPACE.md.

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).

@Chisanan232 Chisanan232 merged commit c9dd131 into master Jul 6, 2026
@Chisanan232 Chisanan232 deleted the v0.1.0/AAASM-3939/define_workspace_layout branch July 6, 2026 00:16
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