@yottagraph-app/aether-instructions 1.1.43 → 1.1.44

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/commands/update_instructions.md

@@ -72,7 +72,7 @@ The extracted content is in `$TEMP_DIR/package/`.
 
 ## Step 4: Delete Previously Installed Files
 
-Read the manifest and delete listed paths. **Skip blank lines** — an empty `rel` would run `rm -rf ".cursor/"` and wipe the whole directory. Entries prefixed with `root/` point at files at the repo root (currently just `AGENTS.md`); only remove **regular files** there, never directories.
+Read the manifest and delete listed paths. **Skip blank lines** — an empty `rel` would run `rm -rf ".cursor/"` and wipe the whole directory. Entries prefixed with `root/` point at files at the repo root (currently `AGENTS.md` and `CLAUDE.md`); only remove **regular files** there, never directories.
 
 ```bash
 if [ -f .cursor/.aether-instructions-manifest ]; then
@@ -115,10 +115,11 @@ cp "$TEMP_DIR/package/commands/"* .cursor/commands/ 2>/dev/null || true
 cp -r "$TEMP_DIR/package/skills/"* .cursor/skills/ 2>/dev/null || true
 ```
 
-Copy the root-level AGENTS.md from the package to the tenant repo root, if the package ships one:
+Copy the root-level AGENTS.md and CLAUDE.md from the package to the tenant repo root, if the package ships them. `CLAUDE.md` is a one-line `@AGENTS.md` pointer so Claude Code imports the same instructions Cursor reads from `AGENTS.md`:
 
 ```bash
 [ -f "$TEMP_DIR/package/AGENTS.md" ] && cp "$TEMP_DIR/package/AGENTS.md" ./AGENTS.md
+[ -f "$TEMP_DIR/package/CLAUDE.md" ] && cp "$TEMP_DIR/package/CLAUDE.md" ./CLAUDE.md
 ```
 
 ### Data-mode variant overlay
@@ -158,6 +159,7 @@ Build a manifest of all installed files (one relative path per line). **Do not**
   for f in .cursor/commands/*.md; do [ -f "$f" ] && echo "commands/$(basename "$f")"; done
   for d in .cursor/skills/*/; do [ -d "$d" ] && echo "skills/$(basename "$d")"; done
   [ -f "$TEMP_DIR/package/AGENTS.md" ] && [ -f ./AGENTS.md ] && echo "root/AGENTS.md"
+  [ -f "$TEMP_DIR/package/CLAUDE.md" ] && [ -f ./CLAUDE.md ] && echo "root/CLAUDE.md"
 } > .cursor/.aether-instructions-manifest
 ```
 
@@ -208,6 +210,7 @@ Commit the updated instruction files. A root `.gitignore` rule like `skills/` ca
 git add .cursor/commands/ .cursor/.aether-instructions-version .cursor/.aether-instructions-manifest
 git add -f .cursor/skills/
 [ -f AGENTS.md ] && git add AGENTS.md
+[ -f CLAUDE.md ] && git add CLAUDE.md
 # Remove the legacy rules dir from tracking if it was committed in an earlier install
 git rm -rf --cached --ignore-unmatch .cursor/rules 2>/dev/null || true
 git commit -m "Update instructions to vX.Y.Z"
@@ -235,11 +238,13 @@ If you get permission errors:
 
 ### Want to customize a command, skill topic, or AGENTS.md?
 
-If you need to modify a package-provided file (including the root `AGENTS.md`):
+If you need to modify a package-provided file (including the root `AGENTS.md` or `CLAUDE.md`):
 
 1. Edit it directly — your changes will persist until the next update
 2. To preserve changes across updates, copy it to a new name first (e.g. `cp AGENTS.md AGENTS.local.md`)
-3. Remove the original's entry from `.cursor/.aether-instructions-manifest` so it won't be deleted on update (for `AGENTS.md`, remove the `root/AGENTS.md` line)
+3. Remove the original's entry from `.cursor/.aether-instructions-manifest` so it won't be deleted on update (for `AGENTS.md`, remove the `root/AGENTS.md` line; for `CLAUDE.md`, remove `root/CLAUDE.md`)
+
+`CLAUDE.md` ships as a one-line `@AGENTS.md` pointer — Claude Code imports `AGENTS.md` via that syntax, so in most cases you only need to edit `AGENTS.md`.
 
 ### Blank line in manifest deleted `.cursor/`
 

package/package.json

@@ -1,12 +1,13 @@
 {
     "name": "@yottagraph-app/aether-instructions",
-    "version": "1.1.43",
+    "version": "1.1.44",
     "description": "Cursor commands and skills for Aether development",
     "files": [
         "commands",
         "skills",
         "variants",
-        "AGENTS.md"
+        "AGENTS.md",
+        "CLAUDE.md"
     ],
     "repository": {
         "type": "git",

package/skills/aether/instructions_warning.md

@@ -6,7 +6,8 @@ Package-managed files are tracked by `.cursor/.aether-instructions-manifest`.
 They will be **overwritten** when you run `/update_instructions`.
 
 This includes files under `.cursor/commands/`, `.cursor/skills/`, **and the
-root `AGENTS.md`** (tracked as `root/AGENTS.md` in the manifest).
+root `AGENTS.md` and `CLAUDE.md`** (tracked as `root/AGENTS.md` and
+`root/CLAUDE.md` in the manifest).
 
 ## Do Not
 
@@ -14,7 +15,7 @@ root `AGENTS.md`** (tracked as `root/AGENTS.md` in the manifest).
 
 ## To Customize
 
-If you need to modify a package-provided command, skill topic, or the root `AGENTS.md`:
+If you need to modify a package-provided command, skill topic, or the root `AGENTS.md` / `CLAUDE.md`:
 
 1. **Copy** the file to a new name
 2. Make your changes to the copy
@@ -32,6 +33,10 @@ cp AGENTS.md AGENTS.local.md
 # then remove the `root/AGENTS.md` line from
 # .cursor/.aether-instructions-manifest
 
+# Customize CLAUDE.md
+cp CLAUDE.md CLAUDE.local.md
+# then remove the `root/CLAUDE.md` line from the manifest
+
 # Edit your copy — it won't be affected by instruction updates
 ```
 
@@ -40,7 +45,7 @@ cp AGENTS.md AGENTS.local.md
 - `.cursor/.aether-instructions-manifest` lists every file installed by the
   package (one relative path per line, e.g. `skills/aether/data.md`). Entries
   prefixed with `root/` refer to files at the tenant repo root
-  (currently only `root/AGENTS.md`).
+  (currently `root/AGENTS.md` and `root/CLAUDE.md`).
 - `/update_instructions` deletes manifest entries, extracts fresh files from
   the latest package, and writes a new manifest
 - Files not in the manifest are never touched