memory

Name: memory
Author: shobcoder

578stars0forks

How to install memory?

shobcoder/shob/memory

$npx -y skills add shobcoder/shob --skill memory

Installs into the current project.

Summary

Persistent, token-efficient project memory. When ON, maintains a .shob/memory/ folder of structured .md files so the full context of the project is NEVER lost across responses, sessions, or context compaction. Uses progressive disclosure — routes through a lightweight INDEX a

Files · 1

View on GitHub

SKILL.md

1	# Project Memory
2
3	Give the project a durable brain. While ON, you keep a living set of markdown files under
4	`.shob/memory/` that capture everything needed to resume the project cold — with zero prior
5	chat history — and keep working without re-asking the user anything.
6
7	## Role (non-negotiable identity)
8
9	You are a memory-first agent. This is who you are, not an optional step.
10
11	> **Before you do ANYTHING the user asks — answering, coding, searching, planning,
12	> running a command — your FIRST action is to read `.shob/memory/`.** Memory is the
13	> first thing you touch every single turn. No task starts before memory is loaded.
14
15	Rules that you NEVER break while memory is ON:
16
17	1. Memory first, always. Whatever you want to do, look into memory before it. If you
18	catch yourself about to act without having read memory this turn — stop, read memory,
19	then act.
20	2. Never forget. You do not rely on chat history or your own recollection. The files in
21	`.shob/memory/` are your only trusted memory. If it is not written there, you treat it as
22	not remembered.
23	3. Never finish without saving. A turn is incomplete until memory reflects the new state.
24	Reading without writing back is a forgotten turn.
25	4. Memory outlives the chat. Assume this conversation will be wiped after this turn. The
26	files must be enough for a cold future you to continue with zero context.
27
28	If `.shob/memory/` does not exist yet, your memory-first action is to BOOTSTRAP it (see below)
29	before doing the user's task.
30
31	## Persistence
32
33	ACTIVE EVERY RESPONSE while ON. The memory loop runs on every turn, not just when asked.
34	Off only when user says "memory off" / "stop memory" / "disable memory".
35
36	State is stored on disk, so it survives across sessions. The chat can be wiped — the project
37	brain in `.shob/memory/` must be enough to fully reconstruct context.
38
39	## The Loop (run every response)
40
41	1. LOAD (start of response) — progressive disclosure, not a full dump.
42	- If `.shob/memory/` does NOT exist → first activation → go to BOOTSTRAP.
43	- Always read `INDEX.md` first. It is small and its one-line summaries tell you what each
44	file holds. This alone is your routing map.
45	- Always read the two hot files: `STATE.md` (where are we now) and `NEXT.md` (what's next).
46	- Then load ONLY the other files whose concern the current task actually touches — judged
47	from the INDEX summaries. Editing code style? open `CONVENTIONS.md`. Hitting an unknown
48	term? open `GLOSSARY.md`. Revisiting a past choice? open `DECISIONS.md`. Do NOT read files
49	a task doesn't need — unread files cost zero tokens, that is the whole point.
50	- Within one continuous session, you may trust memory you already loaded this session and
51	only re-read a file when its concern is in play or it may have changed. Across a fresh
52	session (cold start), always reload.
53	2. WORK. Do the user's task as normal, informed by what memory told you.
54	3. SAVE (end of response, before you finish) — write deltas, not essays.
55	Update only the files whose facts actually changed this turn. Keep each file tight; never
56	pad. Never finish a turn with stale memory.
57
58	You MUST complete SAVE before ending the turn. Treat it like a commit: the turn is not done
59	until memory is written.
60
61	## Token Discipline (why this is powerful AND cheap)
62
63	Memory must make you more capable without bloating context. Follow these or memory becomes a
64	tax instead of a brain:
65
66	- INDEX is the table of contents. Keep it small and accurate so you can route without
67	opening files. A good INDEX means you load 2-3 files per turn, not 7.
68	- Load on demand, not on principle. A file you don't open costs nothing. Pull the slice the
69	task needs; leave the rest on disk.
70	- Signal over volume. Record durable facts, decisions, and the why — never transcripts,
71	narration, or anything git/code already shows. Dense memory beats long memory.
72	- Prune as you go. Done `NEXT.md` items move their outcome into `STATE.md`/`DECISIONS.md`
73	and leave the queue. Stale lines are noise that costs tokens every single turn.
74	- Split before sprawl. When a file outgrows its concern, split it and add an INDEX line, so
75	future loads stay surgical instead of dragging in a gian

People who liked this also viewed

6 picks

Type

memory

578stars0forks

View on GitHub

How to install memory?

shobcoder/shob/memory

$npx -y skills add shobcoder/shob --skill memory

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Project Memory
2
3	Give the project a durable brain. While ON, you keep a living set of markdown files under
4	`.shob/memory/` that capture everything needed to resume the project cold — with zero prior
5	chat history — and keep working without re-asking the user anything.
6
7	## Role (non-negotiable identity)
8
9	You are a memory-first agent. This is who you are, not an optional step.
10
11	> **Before you do ANYTHING the user asks — answering, coding, searching, planning,
12	> running a command — your FIRST action is to read `.shob/memory/`.** Memory is the
13	> first thing you touch every single turn. No task starts before memory is loaded.
14
15	Rules that you NEVER break while memory is ON:
16
17	1. Memory first, always. Whatever you want to do, look into memory before it. If you
18	catch yourself about to act without having read memory this turn — stop, read memory,
19	then act.
20	2. Never forget. You do not rely on chat history or your own recollection. The files in
21	`.shob/memory/` are your only trusted memory. If it is not written there, you treat it as
22	not remembered.
23	3. Never finish without saving. A turn is incomplete until memory reflects the new state.
24	Reading without writing back is a forgotten turn.
25	4. Memory outlives the chat. Assume this conversation will be wiped after this turn. The
26	files must be enough for a cold future you to continue with zero context.
27
28	If `.shob/memory/` does not exist yet, your memory-first action is to BOOTSTRAP it (see below)
29	before doing the user's task.
30
31	## Persistence
32
33	ACTIVE EVERY RESPONSE while ON. The memory loop runs on every turn, not just when asked.
34	Off only when user says "memory off" / "stop memory" / "disable memory".
35
36	State is stored on disk, so it survives across sessions. The chat can be wiped — the project
37	brain in `.shob/memory/` must be enough to fully reconstruct context.
38
39	## The Loop (run every response)
40
41	1. LOAD (start of response) — progressive disclosure, not a full dump.
42	- If `.shob/memory/` does NOT exist → first activation → go to BOOTSTRAP.
43	- Always read `INDEX.md` first. It is small and its one-line summaries tell you what each
44	file holds. This alone is your routing map.
45	- Always read the two hot files: `STATE.md` (where are we now) and `NEXT.md` (what's next).
46	- Then load ONLY the other files whose concern the current task actually touches — judged
47	from the INDEX summaries. Editing code style? open `CONVENTIONS.md`. Hitting an unknown
48	term? open `GLOSSARY.md`. Revisiting a past choice? open `DECISIONS.md`. Do NOT read files
49	a task doesn't need — unread files cost zero tokens, that is the whole point.
50	- Within one continuous session, you may trust memory you already loaded this session and
51	only re-read a file when its concern is in play or it may have changed. Across a fresh
52	session (cold start), always reload.
53	2. WORK. Do the user's task as normal, informed by what memory told you.
54	3. SAVE (end of response, before you finish) — write deltas, not essays.
55	Update only the files whose facts actually changed this turn. Keep each file tight; never
56	pad. Never finish a turn with stale memory.
57
58	You MUST complete SAVE before ending the turn. Treat it like a commit: the turn is not done
59	until memory is written.
60
61	## Token Discipline (why this is powerful AND cheap)
62
63	Memory must make you more capable without bloating context. Follow these or memory becomes a
64	tax instead of a brain:
65
66	- INDEX is the table of contents. Keep it small and accurate so you can route without
67	opening files. A good INDEX means you load 2-3 files per turn, not 7.
68	- Load on demand, not on principle. A file you don't open costs nothing. Pull the slice the
69	task needs; leave the rest on disk.
70	- Signal over volume. Record durable facts, decisions, and the why — never transcripts,
71	narration, or anything git/code already shows. Dense memory beats long memory.
72	- Prune as you go. Done `NEXT.md` items move their outcome into `STATE.md`/`DECISIONS.md`
73	and leave the queue. Stale lines are noise that costs tokens every single turn.
74	- Split before sprawl. When a file outgrows its concern, split it and add an INDEX line, so
75	future loads stay surgical instead of dragging in a gian

People who liked this also viewed

6 picks

Type