Skip to content

Commit 991abc9

Browse files
author
Focaxis Dev
committed
chore: dogfood Deja Vu project memory
1 parent 4e68986 commit 991abc9

7 files changed

Lines changed: 88 additions & 1 deletion

File tree

AGENTS.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# Deja Vu Project Memory Rules
2+
3+
## Memory Identity
4+
5+
- Protocol: Deja Vu Protocol v0.4
6+
- Scope: `project:deja-vu`
7+
- Memory root: `memory/`
8+
9+
## Recall Before Substantial Work
10+
11+
Before substantial planning, coding, release preparation, or documentation changes:
12+
13+
1. Inspect `memory/impressions.jsonl` for familiar cues.
14+
2. If there is no familiarity, do not load memory by default.
15+
3. If familiarity is weak, read `memory/summary.md`.
16+
4. If familiarity is strong, read only the 1-3 linked records needed for the task.
17+
5. Do not load the whole memory tree unless the user explicitly asks.
18+
19+
## Durable Writeback Only
20+
21+
Write back only durable project memory:
22+
23+
- accepted product positioning
24+
- protocol or starter-kit decisions
25+
- CLI scope decisions
26+
- release readiness notes
27+
- unresolved follow-ups
28+
- safety or privacy constraints
29+
30+
Never store secrets, full transcripts, PII, raw logs, low-signal chatter, or disposable exploration noise.

encoding-status.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,6 +124,9 @@
124124
| `starter-kit/prompts/gemini-cli.md` | 編碼正常(新建,UTF-8) | New Gemini CLI startup prompt. |
125125
| `package.json` | 編碼正常(已檢查) | Updated in UTF-8; clean script is now cross-platform for CI and pack verification. |
126126
| `.github/workflows/ci.yml` | 編碼正常(新建,UTF-8) | New GitHub Actions workflow for source tests, memory checks, build, and pack verification. |
127+
| `AGENTS.md` | 編碼正常(新建,UTF-8) | New repo-root dogfood Deja Vu project memory rules. |
128+
| `memory/summary.md` | 編碼正常(新建,UTF-8) | New repo-root dogfood project summary with stable v0.6.0 positioning and boundaries. |
129+
| `memory/impressions.jsonl` | 編碼正常(新建,UTF-8) | New repo-root dogfood impression cues for positioning, starter kit, protocol/engine boundary, CLI scope, safety, and release readiness. |
130+
| `memory/recall-feedback.jsonl` | 編碼正常(新建,UTF-8) | New empty repo-root dogfood recall feedback ledger. |
127131
| `README.md` | 編碼正常(已檢查) | Updated in UTF-8; added public repo and doctor limitation safety note. |
128132
| `starter-kit/README.md` | 編碼正常(已檢查) | Updated in UTF-8; added public repo and doctor limitation safety note. |
129-

memory/decisions/.gitkeep

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+

memory/impressions.jsonl

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{"schema_version":1,"id":"positioning-three-file-memory","scope":"project:deja-vu","title":"Three-file memory positioning","keywords":["positioning","three-file","memory","coding-agent","repo-local"],"aliases":["3-file","product-positioning"],"record_path":"memory/summary.md","updated":"2026-05-17","weight":0.9,"status":"active"}
2+
{"schema_version":1,"id":"starter-kit-main-product","scope":"project:deja-vu","title":"Starter kit is the main product","keywords":["starter-kit","copy-first","AGENTS","summary","impressions"],"aliases":["three-file-starter"],"record_path":"memory/summary.md","updated":"2026-05-17","weight":0.85,"status":"active"}
3+
{"schema_version":1,"id":"protocol-first-not-engine-first","scope":"project:deja-vu","title":"Protocol-first, not engine-first","keywords":["protocol","engine","optional","framework","typescript"],"aliases":["engine-first","protocol-first"],"record_path":"memory/summary.md","updated":"2026-05-17","weight":0.85,"status":"active"}
4+
{"schema_version":1,"id":"cli-helper-scope","scope":"project:deja-vu","title":"CLI is an optional helper","keywords":["cli","init","doctor","explain","optional","helper"],"aliases":["deja-vu-cli"],"record_path":"memory/summary.md","updated":"2026-05-17","weight":0.8,"status":"active"}
5+
{"schema_version":1,"id":"safety-privacy-boundary","scope":"project:deja-vu","title":"Safety privacy boundaries","keywords":["safety","privacy","secrets","PII","transcripts","noise"],"aliases":["memory-safety"],"record_path":"memory/summary.md","updated":"2026-05-17","weight":0.85,"status":"active"}
6+
{"schema_version":1,"id":"v060-release-readiness","scope":"project:deja-vu","title":"v0.6.0 release readiness","keywords":["v0.6.0","release","readiness","checklist","candidate"],"aliases":["release-candidate"],"record_path":"memory/summary.md","updated":"2026-05-17","weight":0.8,"status":"active"}

memory/open-loops/.gitkeep

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+

memory/recall-feedback.jsonl

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+

memory/summary.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
id: summary
3+
title: Deja Vu Project Summary
4+
status: active
5+
scope: project:deja-vu
6+
updated: 2026-05-17
7+
---
8+
9+
# Deja Vu Project Summary
10+
11+
## Product positioning
12+
13+
Deja Vu is positioned as "A 3-file memory system for any capable AI coding agent."
14+
15+
## Product structure
16+
17+
- Protocol is the spec.
18+
- Starter-kit is the main product.
19+
- CLI is an optional helper.
20+
21+
## Core promise
22+
23+
Deja Vu provides repo-local, low-cost, human-readable, git-friendly, cross-agent project memory.
24+
25+
Base use does not require a database, vector store, embeddings, SaaS, daemon, or npm install.
26+
27+
## v0.6.0 focus
28+
29+
v0.6.0 focuses on adoption:
30+
31+
- README landing page
32+
- starter-kit
33+
- per-agent prompts
34+
- `deja-vu init`, `deja-vu doctor`, and `deja-vu explain`
35+
- comparison and compatibility docs
36+
- visual diagram
37+
- launch copy
38+
- demo walkthrough
39+
- release checklist
40+
41+
## Boundaries
42+
43+
- Say "any capable coding agent can follow the protocol."
44+
- Do not overclaim that all agents automatically support Deja Vu.
45+
- Do not turn Deja Vu into a heavy memory framework.

0 commit comments

Comments
 (0)