memory-processor — daily transcript → cards + summary
Turn one day of raw conversation into durable, navigable memory.
This skill is judgment-first: the model (you) does the classification, tagging,
and linking. The autograph Python scripts are used only for mechanical work
(enforce schema, repair links, generate MOCs, decay, touch). enrich.py is never
used — you are the enrichment.
Inputs
daily/YYYY-MM-DD.md — the day's raw two-sided transcript
(## HH:MM [text|voice|video|photo|forward from: …] for the user,
## HH:MM [iva] for Iva's replies; older days may use legacy [eva]).
See scripts/memory/instructions/rules/daily-format.md.
schema.json — the vault schema (types, domains, decay).
- Existing cards under
cards/** and prior summaries under summaries/,
weekly|monthly|yearly/ — for linking and dedup.
Outputs
- Zero or more entity/decision/idea cards under
cards/<kind>/.
- One daily-summary card at
summaries/daily/YYYY-MM-DD.md.
- A processing marker appended to the raw daily file (never edit existing entries).
Layout & types (from schema.json)
| What |
Folder |
type |
| Raw transcript (read-only log) |
daily/YYYY-MM-DD.md |
— (not a card) |
| Daily summary |
summaries/daily/YYYY-MM-DD.md |
daily-summary |
| Weekly / monthly / yearly summary |
weekly/, monthly/, yearly/ |
*-summary |
| Knowledge note / thought |
cards/notes/ |
note |
| Person / org |
cards/contacts/ |
contact |
| Project |
cards/projects/ |
project |
| Idea / proposal |
cards/ideas/ |
idea |
| Decision |
cards/decisions/ |
decision |
Always pick type and status from schema.json → node_types. Never invent a status.
Flow (4 phases)
- CAPTURE (
phases/capture.md) — read the transcript, segment it, and decide
what is noteworthy: which entities, decisions, ideas, and topics the day produced.
- PROCESS (
phases/process.md) — create / update cards for the noteworthy items,
choosing exactly one ADD | UPDATE | SUPERSEDE | NOOP operation, then type +
description-snippet + tags + status; dedup against existing cards.
- LINK (
phases/link.md) — wire every new card to its domain hub + 2–3 neighbors.
- SUMMARIZE (
phases/summarize.md) — write the daily-summary card: the day's
TOPICS plus a MOC linking up to the week, down to the created cards, and down to
the raw daily transcript. Then run the mechanical autograph pass.
Mechanical pass (after writing cards & summary)
Run from the project root (Iva's working directory) — the scripts are part of the repo, not
of the vault, and take the vault directory as an argument (vault = $ASSISTANT_VAULT_DIR):
# dry-run first, then --apply
uv run scripts/autograph/cleanup.py vault --apply # bounded repair before whole-file readers
uv run scripts/autograph/enforce.py vault vault/schema.json --apply # schema compliance + autofix
uv run scripts/autograph/graph.py fix vault vault/schema.json --apply # repair broken wiki-links
uv run scripts/autograph/engine.py touch vault/summaries/daily/YYYY-MM-DD.md
uv run scripts/autograph/moc.py generate vault vault/schema.json # regenerate domain MOCs
uv run scripts/autograph/engine.py decay vault # recompute relevance/tiers
uv run scripts/autograph/graph.py health vault vault/schema.json # confirm score
Read .graph/enforce-report.json after enforce.py. Every path in
compile_candidates needs semantic repair during the next rollup pass: reread the
card, decide its current truth, and use write_card to leave one coherent card.
The mechanical pass deliberately refuses to guess when duplicate ## Related
sections contain prose.
If uv / Python is unavailable, still produce the cards and summary (they are plain
Markdown) and let the nightly Brain run the mechanical pass later.
Hard rules
- Never modify existing transcript entries. Append only a processing marker (see
scripts/memory/instructions/rules/daily-format.md).
- No orphans. Every card created here must link to a hub and ≥2 neighbors before
you finish (
phases/link.md).
- description is a search snippet, not the title. One line, what/why, ~150 chars.
- tags: 2–5, lowercase, kebab-case.
- Idempotent. If the daily file already carries a processing marker and a
summaries/daily/YYYY-MM-DD.md exists, only reconcile new entries; do not duplicate cards.
- One structure per card. Exactly one
## Log and one ## Related; never emit
dated ## Обновление / ## Update headings. Pass relations only through the
write_card.related argument, never inside body.
- Verify writes. Reread every created or updated card before finishing. Confirm
one Log, one Related, no empty/dated update headings, and that Compiled Truth says
what is true now. A failed invariant keeps the rollup unfinished.
- Quiet days are fine. No noteworthy entities → still write a short daily-summary
with topics and the MOC down to the raw transcript. Do not manufacture cards.
References
references/classification.md — what becomes a card vs. stays in the transcript.
references/card-templates.md — frontmatter templates per type.
references/linking.md — hub + neighbor linking protocol.
references/daily-summary.md — the daily-summary card spec (topics + MOC).
scripts/autograph/docs/SKILL.md — the typed vault engine (graph, decay, MOC, dedup).
scripts/memory/instructions/rules/{daily,weekly,monthly,yearly}-format.md — format +
rollup chain navigation rules.
1---2name: memory-processor3description: >-4 Iva's daily-memory processor. Reads the day's two-sided transcript5 (daily/YYYY-MM-DD.md), distills noteworthy entities / decisions / ideas6 into typed autograph cards, links them into the graph, and produces a7 daily-summary card (topics + MOC) that navigates down to the raw transcript and8 up to the week. Model-agnostic — runs on any LLM driving the vault (Iva uses9 DeepSeek). Triggered by the daily rollup (scripts/memory/rollup.ts daily).10depends_on: [autograph]11metadata:12 source: https://skillmd.com/skills/smixs/memory-processor13---1415# memory-processor — daily transcript → cards + summary1617Turn one day of raw conversation into durable, navigable memory.1819This skill is **judgment-first**: the model (you) does the classification, tagging,20and linking. The autograph Python scripts are used only for mechanical work21(enforce schema, repair links, generate MOCs, decay, touch). `enrich.py` is **never**22used — you are the enrichment.2324## Inputs2526- `daily/YYYY-MM-DD.md` — the day's raw two-sided transcript27 (`## HH:MM [text|voice|video|photo|forward from: …]` for the user,28 `## HH:MM [iva]` for Iva's replies; older days may use legacy `[eva]`).29 See `scripts/memory/instructions/rules/daily-format.md`.30- `schema.json` — the vault schema (types, domains, decay).31- Existing cards under `cards/**` and prior summaries under `summaries/`,32 `weekly|monthly|yearly/` — for linking and dedup.3334## Outputs35361. Zero or more **entity/decision/idea cards** under `cards/<kind>/`.372. One **daily-summary card** at `summaries/daily/YYYY-MM-DD.md`.383. A processing marker appended to the raw daily file (never edit existing entries).3940## Layout & types (from schema.json)4142| What | Folder | type |43| --------------------------------- | -------------------------------- | --------------- |44| Raw transcript (read-only log) | `daily/YYYY-MM-DD.md` | — (not a card) |45| Daily summary | `summaries/daily/YYYY-MM-DD.md` | `daily-summary` |46| Weekly / monthly / yearly summary | `weekly/`, `monthly/`, `yearly/` | `*-summary` |47| Knowledge note / thought | `cards/notes/` | `note` |48| Person / org | `cards/contacts/` | `contact` |49| Project | `cards/projects/` | `project` |50| Idea / proposal | `cards/ideas/` | `idea` |51| Decision | `cards/decisions/` | `decision` |5253Always pick `type` and `status` from `schema.json` → `node_types`. Never invent a status.5455## Flow (4 phases)56571. **CAPTURE** (`phases/capture.md`) — read the transcript, segment it, and decide58 what is noteworthy: which entities, decisions, ideas, and topics the day produced.592. **PROCESS** (`phases/process.md`) — create / update cards for the noteworthy items,60 choosing exactly one `ADD | UPDATE | SUPERSEDE | NOOP` operation, then type +61 description-snippet + tags + status; dedup against existing cards.623. **LINK** (`phases/link.md`) — wire every new card to its domain hub + 2–3 neighbors.634. **SUMMARIZE** (`phases/summarize.md`) — write the daily-summary card: the day's64 TOPICS plus a MOC linking up to the week, down to the created cards, and down to65 the raw daily transcript. Then run the mechanical autograph pass.6667## Mechanical pass (after writing cards & summary)6869Run from the project root (Iva's working directory) — the scripts are part of the repo, not70of the vault, and take the vault directory as an argument (`vault` = `$ASSISTANT_VAULT_DIR`):7172```bash73# dry-run first, then --apply74uv run scripts/autograph/cleanup.py vault --apply # bounded repair before whole-file readers75uv run scripts/autograph/enforce.py vault vault/schema.json --apply # schema compliance + autofix76uv run scripts/autograph/graph.py fix vault vault/schema.json --apply # repair broken wiki-links77uv run scripts/autograph/engine.py touch vault/summaries/daily/YYYY-MM-DD.md78uv run scripts/autograph/moc.py generate vault vault/schema.json # regenerate domain MOCs79uv run scripts/autograph/engine.py decay vault # recompute relevance/tiers80uv run scripts/autograph/graph.py health vault vault/schema.json # confirm score81```8283Read `.graph/enforce-report.json` after `enforce.py`. Every path in84`compile_candidates` needs semantic repair during the next rollup pass: reread the85card, decide its current truth, and use `write_card` to leave one coherent card.86The mechanical pass deliberately refuses to guess when duplicate `## Related`87sections contain prose.8889If `uv` / Python is unavailable, still produce the cards and summary (they are plain90Markdown) and let the nightly Brain run the mechanical pass later.9192## Hard rules9394- **Never modify existing transcript entries.** Append only a processing marker (see95 `scripts/memory/instructions/rules/daily-format.md`).96- **No orphans.** Every card created here must link to a hub and ≥2 neighbors before97 you finish (`phases/link.md`).98- **description is a search snippet, not the title.** One line, what/why, ~150 chars.99- **tags:** 2–5, lowercase, kebab-case.100- **Idempotent.** If the daily file already carries a processing marker and a101 `summaries/daily/YYYY-MM-DD.md` exists, only reconcile new entries; do not duplicate cards.102- **One structure per card.** Exactly one `## Log` and one `## Related`; never emit103 dated `## Обновление` / `## Update` headings. Pass relations only through the104 `write_card.related` argument, never inside `body`.105- **Verify writes.** Reread every created or updated card before finishing. Confirm106 one Log, one Related, no empty/dated update headings, and that Compiled Truth says107 what is true now. A failed invariant keeps the rollup unfinished.108- **Quiet days are fine.** No noteworthy entities → still write a short daily-summary109 with topics and the MOC down to the raw transcript. Do not manufacture cards.110111## References112113- `references/classification.md` — what becomes a card vs. stays in the transcript.114- `references/card-templates.md` — frontmatter templates per type.115- `references/linking.md` — hub + neighbor linking protocol.116- `references/daily-summary.md` — the daily-summary card spec (topics + MOC).117- `scripts/autograph/docs/SKILL.md` — the typed vault engine (graph, decay, MOC, dedup).118- `scripts/memory/instructions/rules/{daily,weekly,monthly,yearly}-format.md` — format +119 rollup chain navigation rules.