memory-layer - SKILL.md Agent Skill

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

Query memory before answering project-specific questions.
Use the automatic remember workflow once work is complete.
The remember workflow captures and curates in one step.
Prefer insufficient evidence over unsupported conclusions.
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.