From 3ea100a66a436d59cdf1a47a478fb439316e10c5 Mon Sep 17 00:00:00 2001 From: cupcakearmy Date: Sat, 21 Nov 2026 22:34:26 +0100 Subject: [PATCH] tembo memory --- files/agents/skills/tembo/SKILL.md | 120 +++++++++++++++++++++++++++++ secrets/opencode/AGENTS.md | Bin 634 -> 1022 bytes 2 files changed, 120 insertions(+) create mode 100644 files/agents/skills/tembo/SKILL.md diff --git a/files/agents/skills/tembo/SKILL.md b/files/agents/skills/tembo/SKILL.md new file mode 100644 index 0000000..26f92a7 --- /dev/null +++ b/files/agents/skills/tembo/SKILL.md @@ -0,0 +1,120 @@ +--- +name: Tembo +description: Tembo is the project memory (elephant never forgets). Reads .tembo/notes.md facts and .tembo/log.md change log. Use at session start, after discovering a non-obvious project fact, or when flushing a session before pausing. +--- + +# Tembo + +Project memory. Elephant never forgets, but keep it small: + +``` +.tembo/notes.md durable facts, read at session start +.tembo/log.md short chronological log of meaningful changes +``` + +Project root = `git rev-parse --show-toplevel`, else the current directory. If +there is no `.tembo/` yet, create it only when there is something worth +writing. Never write memory outside the project root. + +## Budgets + +Hard limits, enforced on every write: + +| File | Limit | Overflow | +|---|---|---| +| `notes.md` | 40 lines | merge duplicates, then drop the least useful | +| `log.md` | 60 lines | drop oldest | + +If you cannot fit a fact, it is not worth keeping. + +## Format + +One line per entry, newest last, `- [YYYY-MM-DD] tag: text`. Tags: `hardware`, +`build`, `cmd`, `api`, `gotcha`. + +`notes.md`: + +```markdown +# Tembo memory + + + +- [2026-11-21] gotcha: KiCad 10 pin-header footprints put pad 1 at the origin, not the centre. +- [2026-11-21] cmd: KiCad python bindings only run under the bundled 3.9 interpreter. +``` + +`log.md`: + +```markdown +# Tembo log + + + +- [2026-11-21] Routed the carrier, DRC 0/0, exported gerbers. +``` + +## Read + +At the start of work in a project with `.tembo/`: + +1. Read `notes.md` in full. +2. Read the last ~20 lines of `log.md` for recent context. + +Do not announce that you read them. Use them silently. + +## Write + +Append a `notes.md` line when a fact passes this test: + +> Would this have saved 10 minutes if I had known it at the start? + +Good: non-obvious tool behaviour, hardware/board quirks, commands that are not +in the README, decisions with a reason, traps. + +Bad, do not write: +- anything obvious from the code, `git log`, README or AGENTS.md +- secrets, tokens, personal data, customer data +- code blocks, stack traces, file dumps, long URLs +- "created X" unless the *why* or a non-obvious constraint matters +- plans, TODOs, speculation + +Append a `log.md` line when a meaningful unit of work is done: feature landed, +bug root-caused, board routed, dependency swapped. Not every file edit. + +Never rewrite or reorder existing entries. Pruning to budget is the only edit +allowed. + +## Remember (`/tembo `) + +When invoked with an argument, treat it as a fact to keep: + +1. Read both files. +2. Rewrite the argument into one line: `- [YYYY-MM-DD] tag: text`. +3. Pick the closest tag; write it as stated, do not invent context. +4. Dedupe against existing lines; append. +5. Prune to budget. Confirm in one short line. + +If the argument is too vague to be useful later, ask once for the missing +detail instead of guessing. + +## Flush (`/tembo` with no argument) + +Run this before pausing or ending a session. + +1. Review the session: what was discovered, what changed, what was verified. +2. Read both files. +3. Pick 0-5 facts that pass the test above and are not already recorded. +4. Pick 0-4 log lines for meaningful changes. +5. Dedupe against existing lines; merge near-duplicates. +6. Append, prune to budget, keep one blank line after the HTML comment. +7. Report two lines: facts added, log lines added. If nothing qualified, say + `tembo: nothing worth keeping` and write nothing. + +Do not ask for confirmation. Do not paste file contents back; a short summary +is enough. + +## Safety + +- Never store secrets or credentials. +- Never delete `.tembo/` or another author's facts wholesale. +- If `.tembo/` is gitignored, still follow the same format; it is just local. diff --git a/secrets/opencode/AGENTS.md b/secrets/opencode/AGENTS.md index 1d239203d4bcfe7c1ab2bd35af772fc4c2d1090b..40780f88f5e6d78d74d82ad989f02ecdbb9601f6 100644 GIT binary patch literal 1022 zcmVTIcV{a<-{xGC(t}pLT zrpTUQYL(ccReWA+d9!*K_Mhue=wGLqnYc}b&lvXj3e0Td&#s~j2RA`~l7hEe-Iwe- z74luONkGS*#uOVp^+>V;2W7{73j~^e#x8*gwLU8?SJ@peDUn+>4V-l|o0bHc^r=dc z_Qg4V?aPw1qm_+#99`m38biy#fdYfg(+)@vM@jMIQ5qHUZ&KTsIhslxiFw*^e!YIP z0-!{H=eZW$cs-{*tG3tQX;lV54Z56;jfneNY< zM|6AFFF31y69VNVk7Cz-_jhJYKFT(Zpo*-SwYocf^twZ?=sl9dX$m=`*lm`6eKXdU z(os!OWv2j7CTa2ceQ<)vF5+4PaOi3pmrUEAT{LNE_6zb{jJGL=dSfvzCQ!!)P<`=q z!&zFJHu@@BGWhf|`V8AGOr{8(i|YIE8J+`XfOFw7(r>0T-rb8%6tTD~gm6}5&UAqb zjgt6jBxd%hraAPDdL|Xkhtv)bE@yvw`YSQ$s7j&0lqvKcLNem5+zT_i+0$cE4L|v2X s9Gz?dSbW2$iUv;&jcX(UZ99)1DWMXW1NXgOsd#vDX#fBK literal 634 zcmV-=0)_nmM@dveQdv+`0BhK#0qdP{AFTDZ5?p!y`qf{csc-r-Fyc`QnNQr&mKsyX z2Yn;OIIz6d76Bv@CXeQFNgs^6kLU=e0TkY9r($e9Q8c9>>>BMg<$`bF=Ktp^l$z5g zscQT+=M%0ivly=!P}K3dcDR6>l>De5mggbEg9=1>8AEDS%tv5^6<8}0}wLdDRUm=PzM4)Ss`>gzMWYiKc zTjm2545siDy5#Cwf|gFYv549#*Ss$Xc&kX9md_vEv-v0s;<#Mv4lmpe?7t`78I_sZ zuY{~wiy*|h9Ya9bsx;=0GgVlL6WV3QBqK#VqTEW0kZkB|SOV3shbXt2*q~}M9pCig zPu=T+$QjvQ6CEs|{=9V}J4Q|a6c$r)6(Q4eVJL(%Tf?Dlpng`PrRNeJcelNY?4gmk z3^(jZ%6)2y%p(lM70zsUMEq|(DPk+rekUjRD;+yOu~cGXd>El{b=~l}PR@W6i>XNp zs`8CTy5YNZWXs5<4X*e)4^I96>0d$zvjAD0GY`v}*NX8qQ-hPT*Egi}mu0REJqSf} zo#Yn!`I@s>N}&LL(Jr6mSk2V1R&zhjA{nX;HE3q(xy`U6a*ES1-zU z)se0%VA&Y2FF~v&+S1vX>@>S*?-2f@)kAhLIPhf{ukmQNpP`l{g;?p#-kd&lOhi}; z<~9yQz7mDB!t)4pA8jE|ikdRb(c7NM|M*iEAmo!qm#|vJ?;Y~{?OovW3F3jS-q4d{ U>0&wyYy86#Te4Z8rc1f6bZV?Z761SM