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 1d23920..40780f8 100644 Binary files a/secrets/opencode/AGENTS.md and b/secrets/opencode/AGENTS.md differ