feat(aidd-context): let learn ingest host-native memory as a source
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 45/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- typescript
Research direction
Start at the aidd-context:10-learn source-selection and gather workflow, then compare the existing conversation, file, diff, and review sources. Read #455 and the Claude/Codex validation context to understand the host-agnostic boundary. Done means memory is an explicit source with confirmation and destination routing preserved, explicit failure when unavailable, unchanged existing sources, and validation on two supported hosts.
Written by the indexing model from the issue text.
Description
Problem
aidd-context:10-learn can currently learn from conversation, file, diff, and review sources.
AI coding hosts may maintain durable project knowledge across sessions. For example, a host may retain project facts, decisions, corrections, constraints, or session learnings in its own persistent memory.
That knowledge can contain exactly the kind of durable learning that 10-learn is designed to assess and promote into project memory, decisions, rules, contracts, or skills.
Today, once that knowledge only exists in the host's persistent memory and is no longer present in the current conversation, 10-learn has no source kind for consuming it.
This also creates a portability concern: host-native memory mechanisms differ between tools, while 10-learn is intentionally tool-agnostic
Scope
- Add host-native persistent memory as a supported source kind for
aidd-context:10-learn. - Keep the source semantic generic (
memory), without exposing a Kilo-, Codex-, Claude-, or other host-specific source kind to10-learn. - Resolve the source through the current host's available persistent-memory mechanism when one exists and is readable.
- Feed the retrieved content into the existing
gather → assess → write → syncworkflow. - Fail explicitly when the current host exposes no readable persistent memory; never silently substitute another source.
- Preserve the existing confirmation and destination-routing behavior: retrieved memories are candidates, not automatically promoted project knowledge.
Acceptance criteria
-
10-learnacceptsmemoryas a source in addition to its existing source kinds. - On a host with readable persistent project memory,
10-learn memorycan gather durable learnings from that memory and pass them through the existing assessment flow. - The
10-learnworkflow does not contain a host-specific source kind such askilo-memory,codex-memory, orclaude-memory. - Retrieved host memories are assessed with the same scoring, reconciliation, destination, and user-confirmation rules as other learn sources.
- A memory candidate can be routed to the existing destinations, including project memory, decision/ADR, contract, rule, or skill as applicable.
- No host memory is automatically promoted or written into AIDD artifacts without the existing confirmation step.
- If the active host has no readable persistent-memory mechanism, the source fails explicitly rather than falling back to conversation or another source.
- Existing
conversation,file,diff, andreviewsource behavior is unchanged. - The implementation is validated on at least two supported hosts that expose persistent memory, so the source contract does not depend on one host's storage format.
Prior art in this repo
aidd-context:10-learnalready separates source selection from gathering and supportsconversation,file,diff, andreview.- #278 introduced the requirement for
10-learnto consume material outside the current conversation. - #455 implemented that direction by splitting
sourcefromgatherand validating the workflow across Claude and Codex. - #282 deliberately keeps
10-learntool-agnostic: host/tool-specific placement of generated rules and skills belongs to their generators rather than to10-learn. aidd-context:02-project-memoryalready separates canonical AIDD project memory from the wiring used to expose it to different AI tools.
This proposal applies the same separation in the opposite direction: host-native memory is an input source; AIDD project memory, decisions, rules, contracts, and skills remain the controlled destinations.
Out of scope
- Defining a new canonical AIDD memory format.
- Replacing
aidd-context:02-project-memory. - Synchronizing AIDD project memory back into every host's private memory store.
- Automatically scanning host memory on every prompt or session.
- Automatically converting host memories into rules, ADRs, contracts, or skills without user confirmation.
- Making
10-learnunderstand the internal storage format of individual hosts. - Requiring every supported AI tool to provide persistent memory; hosts without readable memory may report the source as unavailable.
- Dominant language
- TypeScript
- Stars
- 481
- Forks
- 45
- Avg merge
- 14h 36m
- Merged PRs (30d)
- 110
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from ai-driven-dev/framework
-
refactor(aidd-orchestrator): the check zone says when to stop, and reviews its axes in one round Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#887 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
ai-driven-dev/framework#873 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
ai-driven-dev/framework#872 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
ai-driven-dev/framework#625 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#467 · 1 comment ·
All issues in ai-driven-dev/framework
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
copse-dev/agent-pane#2953 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Eynzof/Hermes-CN-Desktop#610 ·
-
bug clawsweeper:linked-pr-open clawsweeper:needs-live-repro clawsweeper:no-new-fix-pr impact:message-loss issue-rating: 🐚 platinum hermit P2 regression
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
calcite-components needs triage refactor
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Esri/calcite-design-system#15203 ·