memory

1# AI DevKit Memory CLI
2 
3Use `npx ai-devkit@latest memory ...` as the durable knowledge layer.
4 
5## Workflow
6 
71. For implementation, debugging, review, planning, or documentation tasks, search before deep work unless the task is trivial:
8   ```bash
9   npx ai-devkit@latest memory search --query "<task, subsystem, error, or convention>" --limit 5
10   ```
11   For broad or risky tasks, search multiple angles: subsystem, error text, framework, command, and task intent.
12 
132. Use results as context:
14   - Trust repo files, tests, fresh command output, and explicit user instructions over memory.
15   - If memory conflicts with verified evidence, use the evidence and update the stale memory.
16   - Mention memory only when it changes the plan or avoids asking the user again.
17 
183. Search before storing:
19   ```bash
20   npx ai-devkit@latest memory search --query "<knowledge to store>" --table
21   ```
22 
234. Store or update only after the quality gate passes.
24 
25## Quality Gate
26 
27Before storing, all must be true:
28 
29- Future sessions are likely to reuse it.
30- It is verified by code, docs, tests, command output, or explicit user instruction.
31- It is not merely a restatement of obvious nearby files unless it prevents repeated agent mistakes.
32- It is scoped narrowly enough.
33- Existing memory does not already cover it.
34- It contains no secrets, credentials, private customer data, personal data, raw logs, or temporary paths.
35 
36Store:
37- Project conventions, user preferences, durable decisions.
38…