@c4a/context-cli 0.5.38 → 0.5.39-beta.1

package/templates/aspects/README.md

@@ -29,11 +29,11 @@ Unlike the align/compile pipeline (LLM-driven, designed for unstructured documen
 ├── README.md               ← This file
 ├── code/
 │   ├── aspect.yaml         # Built-in code aspect (generated when selected during init)
-│   └── prompt.md           # Agent/human hint only; CLI does not read it
+│   └── README.md           # Aspect maintainer guide; CLI does not read it
 ├── <your-aspect>/
 │   ├── aspect.yaml         # Required: aspect definition
 │   ├── extract.ts          # Aspect plugin module (local mode)
-│   └── prompt.md           # Optional: hint for humans/agents
+│   └── README.md           # Optional: maintainer guide for humans/agents
 └── <another-aspect>/
     └── ...
 
@@ -199,7 +199,7 @@ export default defineAspect({
         node_slug: "target-node",
         kind: "description",
         summary: doc.title,
-        content: doc.markdown,
+        content: doc.bodyMarkdown,
         source: file,
         artifact: artifactFromRelPath(file.path),
       });
@@ -208,6 +208,8 @@ export default defineAspect({
 });
 ```
 
+Use `doc.bodyMarkdown` for Section content. It removes a leading document title when it matches `doc.title`, then shifts remaining headings under the rendered Section container. The renderer applies the final heading offset again from the actual node depth, so nested child-node Sections stay structurally valid. `doc.markdown` remains available when a plugin needs the full normalized document.
+
 ---
 
 ## Section Projection Protocol (`section-projection.v2`)
@@ -468,14 +470,14 @@ When the user chooses to install the code aspect, `context init` generates `aspe
 # View the current CLI-bundled template (read-only):
 context aspect template code
 
-# Write the latest template to aspects/code/ (overwrites aspect.yaml, preserves prompt.md):
+# Write the latest template to aspects/code/ (overwrites aspect.yaml, preserves README.md):
 context aspect template code --write
 
 # Diff current file against the latest template:
 context aspect template code --diff
 ```
 
-> `--write` will not overwrite `prompt.md` (user-edited agent hints). To reset prompt.md, delete it first, then `--write`.
+> `--write` will not overwrite `README.md` (user-edited maintainer guide). To reset README.md, delete it first, then `--write`.
 
 ---