Skip to content

Commit d3bf7ed

Browse files
author
igor
committed
Rename agents.md → AGENTS.md; add CLAUDE.md; disable auto-memory
Phase 4a of the distributed-singing-stonebraker plan: foundation commit for the linuxcnc fork's lazy-loaded, audience-separated context layout. Mirrors what Phase 3a did for the lab repo. - git mv agents.md -> AGENTS.md (case rename via two-step temp file so case-insensitive filesystems aren't required) - Create CLAUDE.md containing @AGENTS.md so Claude Code auto-loads AGENTS.md via the documented import mechanism on every session - Set autoMemoryEnabled: false in .claude/settings.json (documented setting that disables harness auto-memory). Linuxcnc has 39 entries in the auto-memory directory at this work computer; with this flag none of them auto-load. In-repo memory/ (Phase 4c) becomes the sole source of truth. - Un-ignore .claude/settings.json specifically (.gitignore changed from '.claude/' to '.claude/*' + '!/.claude/settings.json' exception). The .claude/settings.local.json file remains gitignored — it's the per-developer override slot, never tracked. - Update the two 'agents.md' references in memory.md to 'AGENTS.md' (the only external references to the old filename in the repo). Content of AGENTS.md is unchanged; Phase 4b will trim and rewrite it per the plan budgets, mirror the canonical sections from lab/AGENTS.md, and preserve the existing 'Upstream PR prep' section verbatim.
1 parent 6e46e9d commit d3bf7ed

5 files changed

Lines changed: 52 additions & 3 deletions

File tree

.claude/settings.json

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
{
2+
"autoMemoryEnabled": false,
3+
"permissions": {
4+
"allow": [
5+
"Bash(make:*)",
6+
"Bash(git:*)",
7+
"Bash(halcmd:*)",
8+
"Bash(halrun:*)",
9+
"Bash(halcompile:*)",
10+
"Bash(linuxcnc:*)",
11+
"Bash(python3:*)",
12+
"Bash(grep:*)",
13+
"Bash(find:*)",
14+
"Bash(ls:*)",
15+
"Bash(cat:*)",
16+
"Bash(head:*)",
17+
"Bash(tail:*)",
18+
"Bash(wc:*)",
19+
"Bash(file:*)",
20+
"Bash(which:*)",
21+
"Bash(command -v:*)",
22+
"Bash(echo:*)",
23+
"Bash(env)",
24+
"Bash(pgrep:*)",
25+
"Bash(dpkg:*)",
26+
"Bash(apt-cache:*)",
27+
"Bash(apt list:*)",
28+
"Bash(mkdir:*)",
29+
"Bash(cp:*)",
30+
"Bash(chmod:*)",
31+
"Bash(sed:*)",
32+
"Bash(tar:*)",
33+
"Bash(sudo:*)",
34+
"Read(//usr/**)",
35+
"Read(//tmp/**)",
36+
"Read(//proc/**)",
37+
"Read(//etc/**)",
38+
"Read(//home/igor/**)",
39+
"WebFetch(domain:linuxcnc.org)",
40+
"WebFetch(domain:forum.linuxcnc.org)"
41+
],
42+
"additionalDirectories": [
43+
"/tmp"
44+
]
45+
}
46+
}

.gitignore

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,4 +57,6 @@ position.txt
5757
*.*-stamp
5858
# Ignore VSCode settings
5959
.vscode/settings.json
60-
.claude/
60+
.claude/*
61+
# Exception: project settings like autoMemoryEnabled must reach every cloner
62+
!/.claude/settings.json
File renamed without changes.

CLAUDE.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
@AGENTS.md

memory.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Persistent memory for Claude Code agents working in this fork.
44
Update this file as conventions, practices, and learnings evolve.
55

6-
For step-by-step build/run/test procedures, see [agents.md](agents.md).
6+
For step-by-step build/run/test procedures, see [AGENTS.md](AGENTS.md).
77
For agent-helpers documentation, see [agent-helpers/README.md](agent-helpers/README.md).
88

99
---
@@ -20,7 +20,7 @@ For agent-helpers documentation, see [agent-helpers/README.md](agent-helpers/REA
2020
- **Use safe-agent-action.sh for ALL operations** — builds, grep, find, git, view, tail, ps, halcmd. The wrapper auto-cd's to repo root and is pre-approved via a global PreToolUse hook.
2121
- **Extend the wrapper, don't fall back to bare bash** — if a subcommand is missing, add it to `safe-agent-action.sh`. New subcommands are auto-approved (the hook matches the script name).
2222
- **Never use bare `make` in `src/`** — the wrapper handles setuid restore automatically.
23-
- Keep agent instructions in [agents.md](agents.md) — committed to the fork, not local
23+
- Keep agent instructions in [AGENTS.md](AGENTS.md) — committed to the fork, not local
2424
- Keep project memory in this file — committed to the fork, not local
2525
- Runtime-generated config files (`.pref`, `qtvcp/`) are excluded via `.git/info/exclude`
2626

0 commit comments

Comments
 (0)