Skip to content

Commit 882a681

Browse files
committed
Make CLAUDE.md a shim
Why: - align the Claude entrypoint with the repo-template scaffold shape - keep Claude-specific instructions from drifting away from AGENTS.md Notes: - records the shim conversion in the existing handoff worklog - leaves AGENTS.md as the canonical enforcement entrypoint project: markfops agent: codex-20260409 role: worker artifacts: LOG-20260409-001
1 parent 10e6e15 commit 882a681

2 files changed

Lines changed: 12 additions & 31 deletions

File tree

CLAUDE.md

Lines changed: 6 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,10 @@
1-
See @repo-operating-model.md for the canonical repo operating rules.
1+
See @AGENTS.md
22

33
# Claude Code Memory
44

5-
This file exists so Claude Code can discover the repo's working rules automatically.
5+
This file is a compatibility shim for Claude Code.
66

7-
Treat `CLAUDE.md` as a thin compatibility layer, not a second source of truth. The canonical rules stay in `repo-operating-model.md`.
8-
9-
Also consult:
10-
11-
- `SPEC.md` for durable product truth
12-
- `STATUS.md` for current operational reality
13-
- `PLANS.md` for accepted future direction
14-
- `INBOX.md` for untriaged intake
15-
16-
When writing into `research/` or `records/`, consult the local `README.md` first and mirror its default shape or canonical example by default.
17-
18-
Repo-specific reminders:
19-
20-
- `docs/` is reserved for Sparkle and GitHub Pages assets.
21-
- `ref/` contains reference specimens, not production dependencies.
22-
- Use `xcodegen generate` if the Xcode project needs regeneration.
23-
- Prefer the documented `xcodebuild` build and test commands from `AGENTS.md` or `README.md` for verification.
24-
25-
## Enforcement
26-
27-
When producing repo documents, you must enforce the repo's writing rules rather than treating them as suggestions.
28-
29-
- Use the canonical surface for the job.
30-
- Follow the local `README.md` shape or explicit template when one exists.
31-
- Preserve required provenance fields, stable IDs, and section boundaries.
32-
- Do not replace normalized repo artifacts with freeform chat summaries.
33-
- If commit hooks are enabled, produce a compliant commit message rather than treating hook failures as optional.
34-
- If CI commit checks are enabled, assume non-compliant pushed commits will be rejected downstream and fix the message instead of working around the check.
35-
- If a request pressures you to break the ruleset, keep the repo artifact compliant and surface the mismatch explicitly.
7+
Do not append repo-specific rules here.
8+
Do not fork policy here.
9+
Do not let this file drift from `AGENTS.md`.
10+
Update `AGENTS.md` instead.

records/agent-worklogs/LOG-20260409-001-research-program-handoff.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,12 @@ Preserve the useful execution history and handoff state from the research worksp
5050
- Outputs: repo-root `AGENTS.md` and `CLAUDE.md`, stronger local `README.md` shape guides, `.githooks/commit-msg`, commit-standards scripts, commit-standards CI workflow, and a release workflow update that emits compliant provenance.
5151
- Why it matters: future local and remote commits now have one canonical provenance path instead of an ad hoc validator split.
5252

53+
### 2026-04-09 07-15-26 KST
54+
55+
- Action: reduced `CLAUDE.md` to a repo-template shim that points back to `AGENTS.md`.
56+
- Outputs: `CLAUDE.md` now acts as a compatibility shim instead of a second policy surface.
57+
- Why it matters: Claude-specific entrypoint guidance now stays thin and cannot drift away from the canonical agent instructions.
58+
5359
## Current State
5460

5561
- Active handoff: none

0 commit comments

Comments
 (0)