GEMINI.md

1# EGC: Session Memory Protocol
2 
3This project has persistent cross-session memory via the `egc-memory` MCP server.
4 
5## At the start of every session
6 
7Call `get_state` with no arguments: it uses the current working directory automatically:
8 
9```
10get_state({})
11```
12 
13If the AI is running from outside the project directory, pass the path explicitly:
14 
15```
16get_state({ project_path: "/absolute/path/to/this/project" })
17```
18 
19Read the returned Markdown. It contains the decisions already made, what failed, coding preferences, and what to pick up next. Do not ask the user to re-explain any of that.
20 
21## At the end of every session
22 
23Call `update_state` with a summary of this session:
24 
25```
26update_state({
27  project_path: "/absolute/path/to/project",
28  context: "One sentence: what this project is and its current phase.",
29  decisions: [
30    { what: "What was decided", why: "Why" }
31  ],
32  avoid: [
33    { what: "What failed or was rejected", why: "Why to skip it next time" }
34  ],
35  preferences: [
36    "Coding style or workflow preference discovered this session"
37  ],
38  next: [
39    "First thing to pick up in the next session"
40  ]
41})
42```
43 
44`update_state` merges with existing state: it does not erase previous memory. Only include fields that changed this session. Leave out fields with nothing new.
45 
46## Where state is stored
47 
48`~/.egc/state/<project-slug>/<branch>.md`: one file per project branch (flat `<project-slug>.md` files from older versions are still read). Files are encrypted at rest with AES-256-GCM (key at `~/.egc/encryption.key`); the memory server and session hooks decrypt them transparently.
49 
50## MCP servers required
51 
52Both servers must be registered in your MCP config (`.mcp.json`):
53 
54- `egc-guardian`: `validate_command`, `validate_write`, `reduce_context`, `orchestrate_task`
55- `egc-memory`: `get_state`, `update_state`, `store_decision`, `query_history`, `search_history`
56 
57Run `sh install.sh` to build the servers. Run `egc doctor` to verify they are registered and running.
58 
59## EGC Guardian Protocol — MANDATORY
60 
61These calls are automatic and non-negotiable. Never wait for the user to ask.
62 
63**Start of every task (non-trivial):**
64```
65orchestrate_task({ prompt: "<task description>" })
66```
67 
68**Before every shell/Bash command:**
69```
70validate_command({ command: "<command>" })
71```
72 
73**Before every new file Write or Edit on a file not yet read:**
74```
75validate_write({ filepath: "<path>" })
76```
77 
78Skipping any of these breaks the EGC contract. There are no exceptions for "simple" tasks.
79 
80## EGC Auto-Intuition
81 
82Act on user intent, not keywords. When what the user says implies an EGC action, call the right tool immediately -- no explicit command needed.
83 
84- Session ending (goodbye, break, sleep, done, closing) → call `update_state`
85- Session starting or resuming → call `get_state`
86- Save/remember this decision → call `lesson_save` or `store_decision`
87- What failed? What did we decide? → call `search_history` or `query_history`
88- Review code or a PR → spawn `/review-pr` agents
89- Context is heavy or slow → call `reduce_context`
90 
91Judge by the full conversation context, never by literal words. A remark to someone nearby is not a command. When intent is ambiguous, keep working.
92 
93<!-- egc:start -->
94## EGC Project Memory
95 
96<!-- egc:end -->
97