memory-write

name	memory-write
description	Create or update pi-memory-md memory files using the native write/edit tools plus the bundled template script. Use whenever writing, creating, or updating memory files.

Memory Write

Use this skill to safely create or update pi-memory-md memory files while preserving valid frontmatter.

Workflow

1. Find the memory directory

Use scripts/memory-write.sh to resolve the project memory directory. Use the printed path as <memory-dir>.

Critical: DO NOT CREATE, UPDATE, or WRITE any memory file until <memory-dir> has been resolved and verified by scripts/memory-write.sh.

2. Create a new memory file

Before creating a memory file, infer a proposed relative path, description, and tags from the user's request, then ask the user to confirm them unless they already provided these values explicitly.

Use scripts/memory-write.sh to create the file template. The script prints the created absolute file path. Read or edit that file next.

3. Update an existing memory file

1. Use read on the existing file.
2. Use edit for targeted body changes when possible.
3. Preserve existing YAML frontmatter.
4. Refresh updated with scripts/memory-write.sh.

If a full rewrite is necessary, include the complete frontmatter and body in native write, then refresh updated.

Placement rules

• Put always-needed context under core/.
• Put project-specific auto-delivered memories under core/project/.
• Use root-level folders like docs/, archive/, research/, or references/ for non-core references.
• Never create a root-level project/ folder; use core/project/.

Frontmatter shape

The script creates:

---
description: "Human-readable description"
tags:
  - "tag"
created: "YYYY-MM-DD"
updated: "YYYY-MM-DD"
---