@lh8ppl/claude-memory-kit 0.3.5 → 0.4.1

package/template/.claude/skills/memory-write/SKILL.md

@@ -1,6 +1,18 @@
 ---
 name: memory-write
-description: Captures a durable fact to project memory through the kit's safe write path (Poison_Guard secret/injection screening + home-path sanitization + dedup + conflict detection) — preferring the cmk MCP tools (mk_remember / mk_forget / mk_trust) when connected, falling back to the cmk CLI. Use when the user says "remember this", "note this", "save this", "from now on", "going forward", "I prefer", "I don't like", "we decided", "we agreed", or otherwise states a durable preference, decision, or environment fact worth carrying across sessions. Also covers correcting a saved fact ("update memory: X is now Y"), removing one ("forget about X"), and adjusting how much a saved fact is trusted ("trust this", "that's important — keep it", "that's not important / I'm not sure about that / low priority"). Skip throwaway chatter and facts that only matter to the current task.
+description: >-
+  Captures a durable fact to project memory through the kit's safe write path
+  (Poison_Guard secret/injection screening + home-path sanitization + dedup +
+  conflict detection) — preferring the cmk MCP tools (mk_remember / mk_forget /
+  mk_trust) when connected, falling back to the cmk CLI. Use when the user says
+  "remember this", "note this", "save this", "from now on", "going forward",
+  "I prefer", "I don't like", "we decided", "we agreed", or otherwise states a
+  durable preference, decision, or environment fact worth carrying across
+  sessions. Also covers correcting a saved fact ("update memory: X is now Y"),
+  removing one ("forget about X"), and adjusting how much a saved fact is trusted
+  ("trust this", "that's important — keep it", "that's not important / I'm not
+  sure about that / low priority"). Skip throwaway chatter and facts that only
+  matter to the current task.
 allowed-tools: mcp__cmk__mk_remember mcp__cmk__mk_forget mcp__cmk__mk_trust Bash(cmk remember *) Bash(cmk forget *) Bash(cmk trust *) Read
 ---
 
@@ -85,6 +97,30 @@ Adjust how much a saved fact is trusted (`<id>` comes from `cmk search`):
 cmk trust <id> <low|medium|high>
 ```
 
+## Write the fact body as clean markdown
+
+Memory files are **committed to the repo**, so a teammate's CI may lint them. When
+you write a fact body (the `--why` / `--how` text, or any prose you capture), keep
+it lint-clean markdown so it doesn't trip a default linter:
+
+- **Nested list items: indent 4 spaces, not 2** (markdownlint MD007). A sub-bullet
+  under a bullet uses four spaces:
+
+  ```
+  - top-level point
+      - sub-point (4-space indent)
+  ```
+
+- **Wrap URLs** in `<https://example.com>` or `[text](https://example.com)` — never
+  a bare `https://…` in prose (MD034).
+- **Blank line above and below any heading** you write in a body (MD022), and don't
+  leave **two blank lines** in a row (MD012).
+- Keep it short, declarative prose — the body is a fact, not an essay.
+
+This is guidance for the body TEXT you pass. The kit's own structure (the bullet
+line, the provenance comment, the frontmatter) is already lint-clean by
+construction — you only control the prose.
+
 ## What NOT to capture
 
 - Throwaway chatter ("user said hi").

package/template/project/memory/INDEX.md.template

@@ -5,7 +5,7 @@ This file lists every per-fact memory file in `context/memory/`. **NOT auto-load
 ## Purpose vs. the bounded scratchpad
 
 | File | Purpose | Loaded at startup? | Cap |
-|---|---|---|---|
+| --- | --- | --- | --- |
 | `../MEMORY.md` | Hot working state (current threads, environment, pending decisions) | Yes | 2,500 chars |
 | `../USER.md` | User profile and preferences | Yes | 1,375 chars |
 | `./<type>_<slug>.md` (this dir) | Durable typed facts with reasoning | No | none |