ds-memory-update git:20261006.2bb32f6A

Immutable. This exact content never changes and is served at /api/v1/blob/52673e8870cd81b7.

---
name: ds-memory-update
description: "When a project-affecting decision has been confirmed in conversation, the main agent invokes this command with the decision context passed as `$ARGUMENTS`."
user-invocable: true
---
# /ds-memory-update - Memory Protocol: Capture a Decision

> Run the Activation preflight from `METHODOLOGY.md` before proceeding. If inactive, no-op and exit.

When a project-affecting decision has been confirmed in conversation, the main agent invokes this command with the decision context passed as `$ARGUMENTS`.

## Your job (main agent)

**Immediately** spawn a background `general-purpose` Worker via the `Agent` tool. Return to the conversation instantly. Do not report completion to the user unless there is an escalation.

**Before spawning:** The canonical MEMORY.md path is `<cwd>/MEMORY.md` (loaded at session start via the `@MEMORY.md` import in the project root `CLAUDE.md`). Pass this path to the Worker as `$MEMORY_PATH`. `<cwd>/MEMORY.md` is committed by default for consumer projects scaffolded by `/ds-init-project`; in the DinoStack repo itself it is intentionally gitignored (DS-129), so this write is local-only here and never reaches a PR.

**Auto-memory index:** `<cwd>/.agentic/memory/MEMORY.md` is the Claude Code auto-memory index, wired via `autoMemoryDirectory` in `.claude/settings.local.json` and auto-injected into session context by the harness. It is distinct from `<cwd>/MEMORY.md`, the curated project memory file this command manages. The two stores are separate - do not merge them.

**What to pass as context:** A concise summary of the decision - 1-3 sentences covering what was decided, why, and any key tradeoffs.

When spawning the Worker, substitute `$ARGUMENTS` with the actual decision context and `$MEMORY_PATH` with the resolved path before passing the prompt. Do not pass literal placeholder text.

---

## Step 1 - Spawn a single Worker that verifies and writes

Spawn a **background general-purpose Task** with this prompt (substitute `$ARGUMENTS` and `$MEMORY_PATH` with actual values). Every section of this spawn prompt that the conductor composes is a slot per `content/references/subagent-protocol.md` §11 Output Expectations, "**Brief section form**".

---
You are a Memory Worker. Your job is to write an accurate, verified entry to MEMORY.md. You will draft, verify, and write in one pass. Do not return a draft for review - write directly to disk.

**The decision context:** $ARGUMENTS

**MEMORY.md path:** $MEMORY_PATH

### Part 1 - Relevance filter

Only proceed if the decision would matter to a new engineer joining the project tomorrow - architectural choices, technology decisions, scope resolutions, deliberate tradeoffs, deferred decisions. Do NOT update MEMORY.md for conversational agreements, personal preferences, or anything that doesn't affect how the project is built or understood. If the decision does not pass this filter, return: "No-op: decision does not qualify for MEMORY.md."

### Part 2 - Verify your claims

Before drafting, verify any factual claims the entry will make:
- If the entry names specific files, read them to confirm they exist and behave as described.
- If the entry describes a code pattern, read the relevant code to confirm it is accurate.
- If the entry refers to configuration values, check the actual config files.
- Do not assert something as fact without verifying it. If you cannot verify a claim, omit it or soften it to "intended to" / "expected to".

### Part 3 - Draft the entry

1. Read the current MEMORY.md (create it with just `# Memory\n\n` if it does not exist).
2. Assess against what is already there:
   - **Update existing**: decision clarifies or supersedes a prior entry - update that entry in place, adjusting the date (compiled mode: never in place - write a new entry citing the old entry's shard id, see Part 4)
   - **New entry**: decision is not yet captured - draft a new date-stamped bullet
   - **No-op**: decision is already accurately captured - return: "No-op: decision already captured."
3. Entry format - one date-stamped bullet per decision:
   ```
   - **YYYY-MM-DD:** [what was decided and why, in one sentence with rationale]
   ```
4. Do not add section headers beyond the `# Memory` file header.

### Part 4 - Write to disk

Apply the change directly to the file at $MEMORY_PATH:
- New entry: append the bullet
- Update existing: replace the prior bullet in place
- If MEMORY.md does not exist: create it with the header `# Memory\n\n` then write the bullet

**Compiled mode** - if `ds-memory-capture detect --dir <project root>` reports `two-tier` or `two-tier-unresolved` (or, without that tool, `grep -l '^index:' .agentic/memory-shards/*.md` finds a hit), never edit MEMORY.md: append the bullet as one line of `<project root>/.agentic/memory-capture-inbox.md`, then run `ds-memory-capture flush --dir <project root>` and return its `captured:` line (exit 1: the entry stays queued; say so). See `content/references/memory-shard-convention.md` §Two-tier capture.

Do not commit - committing is the user's responsibility. Return confirmation when done.
---

## Step 2 - When the Worker returns

If the Worker returned "No-op" or "Abort": complete silently. No further action.

Otherwise: complete silently - do NOT report back to the user.

## Memory retrieval

To query existing memory without rewriting it, use `bin/ds-memory`:

```bash
# Find recent Skeptic spawns
ds-memory query --type spawn_complete --agent skeptic --last 5

# Find decisions about a topic
ds-memory query --source MEMORY.md --topic "context budget"

# Show recent turns
ds-memory turns --last 5
```

This is a permitted direct action — the conductor may run it inline without spawning a subagent.