Add workfile memory
project_memory_addAdds a typed memory record—learning, decision, incident, convention, or context—to project memory, capturing knowledge that should alter future behavior.
Instructions
Create a typed learning, decision, incident, convention or temporary context record. For knowledge that should change future behaviour — not for narrating what happened this session.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Markdown body, written below the frontmatter. | |
| tags | No | Free-form tags for filtering. | |
| scope | No | Subject matter this applies to — topics, not file paths. | |
| title | Yes | The knowledge itself, stated as a claim rather than a topic. | |
| owners | No | Who is answerable for keeping this accurate. | |
| status | No | Lifecycle status. Each collection has its own vocabulary — a decision is proposed or accepted, an incident is open or resolved. Project-declared, so the accepted values vary; project_workspace reports them. | |
| expires | No | For context: the date after which this stops being true, YYYY-MM-DD. | |
| related | No | IDs of records worth reading alongside this one. | |
| category | No | Optional sub-classification within the collection. | |
| deciders | No | For decisions: who made the call. | |
| severity | No | For incidents: how bad it was. | |
| collection | Yes | Which kind of memory this is. learnings: something discovered that changes how the next attempt goes. decisions: a choice made, with its rationale (ADR). incidents: something that broke, and what it cost. conventions: a rule the project now follows. context: temporary situational state, which expires. | |
| confidence | No | How well established this is — for learnings, whether it has been seen once or many times. | |
| started_at | No | For incidents: when it began, YYYY-MM-DD. | |
| supersedes | No | IDs of memory records this replaces. Prefer project_memory_supersede, which updates both sides. | |
| occurrences | No | How many times this has been observed. | |
| resolved_at | No | For incidents: when it was resolved, YYYY-MM-DD. | |
| graduated_to | No | IDs of the durable records a learning has been promoted into. | |
| review_after | No | Date after which this should be re-read, YYYY-MM-DD. | |
| corrective_actions | No | For incidents: IDs of the cards that stop it recurring. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| record | Yes | A canonical record with its body, revision and reference graph. |