memory-layer

name	memory-layer
description	Query project memory before answering project-specific questions; capture completed task context; curate raw captures into durable canonical memory with provenance.

Memory Layer Skill

Use this skill when:

• the user asks how this repository works
• you discover a durable convention, decision, or debugging lesson
• you complete meaningful work in this repository
• the user explicitly asks to store or query memory

Do not use this skill for:

• generic questions with no project-specific context
• speculative facts without provenance
• trivial temporary notes

Scripts

Query memory:

./.agents/skills/memory-layer/scripts/query-memory.sh "<question>"

Remember task context automatically:

./.agents/skills/memory-layer/scripts/remember-task.sh \
  --title "<task title>" \
  --prompt "<user prompt>" \
  --summary "<what changed>" \
  --note "<durable fact>"

Workflow

1. Query memory before answering project-specific questions.
2. Use the automatic remember workflow once work is complete.
3. The remember workflow captures and curates in one step.
4. Prefer insufficient evidence over unsupported conclusions.
5. Never invent provenance.

Mandatory post-task rule

After any meaningful repository work, run the remember workflow before sending the final response unless one of these is true:

• no durable knowledge was produced
• the work was purely trivial
• the user explicitly asked not to store memory

This skill should default to storing durable project knowledge, not waiting for the user to ask again.

Remember guidance

The automatic remember workflow should be used after meaningful work. It:

• defaults the project slug from the current directory
• auto-detects changed files from git status when possible
• captures task context
• immediately curates it into canonical memory

Provide:

• one or more --note values for durable facts

Optionally provide:

• --title
• --prompt
• --summary
• --test-passed "<command>"
• --test-failed "<command>"
• --command-output-file <path>

Only store verified outcomes and durable lessons.

If title, prompt, or summary are omitted, the remember command derives sensible defaults from the current project and changed files. Use that defaulting so memory capture stays lightweight and automatic.