Research Learn
Read ../researchstack/references/memory.md first.
This skill manages the durable memory layer for researchstack.
Use it to:
- inspect current project memory,
- inspect or update cross-project researcher preferences,
- record important decisions after a session,
- prune stale or low-confidence memories,
- summarize what the pack already knows before a new workstream.
Default workflow:
- Determine the project slug.
- Do not use only the repo directory name.
- Prefer
<repo-name>-<short-stable-id> so similarly named repos do not share memory by accident.
- Use the first 6 lowercase hex characters of
sha256(normalized-remote-or-root-path) as the stable id.
- If the user wants a concrete initializer, suggest
bun run memory:init -- --root <repo-root>.
- Read
~/.researchstack/projects/<slug>/memory.jsonl if it exists.
- Read
~/.researchstack/profile/preferences.json if it exists.
- Group what is known into:
- stable program topic and paper portfolio,
- thesis and scope,
- topic state, method state, and rejected method candidates,
- venue and reviewer risks,
- experiment rules,
- artifact or reproducibility rules,
- writing and framing preferences.
- If the user wants updates, append or merge only durable items.
- If memory is stale or contradictory, call it out and recommend pruning.
When writing memory:
- prefer 1 to 3 high-signal entries over bulk dumping,
- keep titles short and searchable,
- store decisions, not meeting transcript noise,
- distinguish a program-level decision from a one-paper thesis,
- mark
source honestly,
- use
confidence: low for tentative inferences.
When updating existing project memory:
- append a new entry, do not rewrite old history,
- make the update explicit when it supersedes a prior decision,
- prefer the newest high-confidence entry when summarizing conflicts,
- point out contradictions instead of pretending they do not exist.
When reading memory into a later task, explicitly distinguish:
- remembered fact,
- current inference,
- new uncertainty that still needs verification.
If there is any doubt that two repos might collide, say so and pick a more specific slug before writing memory.
1---2name: researchstack-learn-23description: Research memory skill for long-lived projects and researcher preferences. Use when Codex should record, inspect, prune, or apply durable knowledge about a paper project, venue strategy, experiment policy, writing weaknesses, reviewer risks, or repeated user preferences so later sessions become more context-aware.4---56<!-- AUTO-GENERATED for codex from researchstack v0.3.0. Edit source SKILL.md files, then regenerate from the source checkout. -->78# Research Learn910Read [../researchstack/references/memory.md](../researchstack/references/memory.md) first.1112This skill manages the durable memory layer for `researchstack`.1314Use it to:1516- inspect current project memory,17- inspect or update cross-project researcher preferences,18- record important decisions after a session,19- prune stale or low-confidence memories,20- summarize what the pack already knows before a new workstream.2122Default workflow:23241. Determine the project slug.25 - Do not use only the repo directory name.26 - Prefer `<repo-name>-<short-stable-id>` so similarly named repos do not share memory by accident.27 - Use the first 6 lowercase hex characters of `sha256(normalized-remote-or-root-path)` as the stable id.28 - If the user wants a concrete initializer, suggest `bun run memory:init -- --root <repo-root>`.292. Read `~/.researchstack/projects/<slug>/memory.jsonl` if it exists.303. Read `~/.researchstack/profile/preferences.json` if it exists.314. Group what is known into:32 - stable program topic and paper portfolio,33 - thesis and scope,34 - topic state, method state, and rejected method candidates,35 - venue and reviewer risks,36 - experiment rules,37 - artifact or reproducibility rules,38 - writing and framing preferences.395. If the user wants updates, append or merge only durable items.406. If memory is stale or contradictory, call it out and recommend pruning.4142When writing memory:4344- prefer 1 to 3 high-signal entries over bulk dumping,45- keep titles short and searchable,46- store decisions, not meeting transcript noise,47- distinguish a program-level decision from a one-paper thesis,48- mark `source` honestly,49- use `confidence: low` for tentative inferences.5051When updating existing project memory:5253- append a new entry, do not rewrite old history,54- make the update explicit when it supersedes a prior decision,55- prefer the newest high-confidence entry when summarizing conflicts,56- point out contradictions instead of pretending they do not exist.5758When reading memory into a later task, explicitly distinguish:5960- remembered fact,61- current inference,62- new uncertainty that still needs verification.6364If there is any doubt that two repos might collide, say so and pick a more specific slug before writing memory.