mirror of
https://github.com/cupcakearmy/nix-macos.git
synced 2026-11-22 11:03:42 +00:00
Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
bc8bf41580 | ||
|
|
1d2e23a964 | ||
|
|
3ea100a66a |
@@ -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
|
||||||
|
|
||||||
|
<!-- Durable, non-obvious facts. Max 40 lines. One per line. -->
|
||||||
|
|
||||||
|
- [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
|
||||||
|
|
||||||
|
<!-- One line per meaningful change. Max 60 lines. Newest last. -->
|
||||||
|
|
||||||
|
- [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 <fact>`)
|
||||||
|
|
||||||
|
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.
|
||||||
Generated
+12
-12
@@ -7,11 +7,11 @@
|
|||||||
]
|
]
|
||||||
},
|
},
|
||||||
"locked": {
|
"locked": {
|
||||||
"lastModified": 1794715309,
|
"lastModified": 1795268568,
|
||||||
"narHash": "sha256-awkBBs5ctFKgEYjpNGpi3t/VqF589n5EWfdinRb2gNI=",
|
"narHash": "sha256-1RJm4DEu7YHJv94sjSY7sjqT+kHx/AUwmtUN4dtFBUo=",
|
||||||
"owner": "nix-community",
|
"owner": "nix-community",
|
||||||
"repo": "home-manager",
|
"repo": "home-manager",
|
||||||
"rev": "a1293da7dd8e497e08d26173f97e2976b36a31ea",
|
"rev": "6857c7f7c338ad181729c52071386b0d3afa24bc",
|
||||||
"type": "github"
|
"type": "github"
|
||||||
},
|
},
|
||||||
"original": {
|
"original": {
|
||||||
@@ -25,11 +25,11 @@
|
|||||||
"nixpkgs": "nixpkgs"
|
"nixpkgs": "nixpkgs"
|
||||||
},
|
},
|
||||||
"locked": {
|
"locked": {
|
||||||
"lastModified": 1794799779,
|
"lastModified": 1795272803,
|
||||||
"narHash": "sha256-ASX2PlNoMvZuf9o/mZQw9+qwbqPw/SMU2a8DIZQDO6k=",
|
"narHash": "sha256-v/AlZwJYPvjQ5to1dpQJb8nx5hmTUCVW+SMkL5nxxkM=",
|
||||||
"owner": "tw93",
|
"owner": "tw93",
|
||||||
"repo": "mole",
|
"repo": "mole",
|
||||||
"rev": "ee7be609c70a568d7bc386b1442963f47c6a33ed",
|
"rev": "5c2edd1a17880d3ace0ad0f158863f8b029a92a3",
|
||||||
"type": "github"
|
"type": "github"
|
||||||
},
|
},
|
||||||
"original": {
|
"original": {
|
||||||
@@ -46,11 +46,11 @@
|
|||||||
]
|
]
|
||||||
},
|
},
|
||||||
"locked": {
|
"locked": {
|
||||||
"lastModified": 1793418699,
|
"lastModified": 1795302518,
|
||||||
"narHash": "sha256-+RpTlcdh9KqZ+ZiLkNSTvibQWm935EcIdBzRPCTFsrQ=",
|
"narHash": "sha256-HJKykg05SUTzWyGpbkGeBuLxJJUYx713ZSu3780YW2Y=",
|
||||||
"owner": "LnL7",
|
"owner": "LnL7",
|
||||||
"repo": "nix-darwin",
|
"repo": "nix-darwin",
|
||||||
"rev": "ff0e21a414d4547183396da1b44a66f2577b65e9",
|
"rev": "bcf051043c8c6e6473eb44245ed81bca90856523",
|
||||||
"type": "github"
|
"type": "github"
|
||||||
},
|
},
|
||||||
"original": {
|
"original": {
|
||||||
@@ -77,11 +77,11 @@
|
|||||||
},
|
},
|
||||||
"nixpkgs_2": {
|
"nixpkgs_2": {
|
||||||
"locked": {
|
"locked": {
|
||||||
"lastModified": 1794644783,
|
"lastModified": 1795249095,
|
||||||
"narHash": "sha256-3GnIGIy15bMduoS9RnWqKTmsJLWThla42UFtm0S7+us=",
|
"narHash": "sha256-8JDgyVvWUZg5m9hNlL8Ge9aT647ng3Ukc8NPMiKNTPQ=",
|
||||||
"owner": "NixOS",
|
"owner": "NixOS",
|
||||||
"repo": "nixpkgs",
|
"repo": "nixpkgs",
|
||||||
"rev": "5d2b81a7a3be3e2f832879028e4d60abbf58e9a0",
|
"rev": "93a9ed0a866099a230ed5146a5bb7d16fd5c9b14",
|
||||||
"type": "github"
|
"type": "github"
|
||||||
},
|
},
|
||||||
"original": {
|
"original": {
|
||||||
|
|||||||
@@ -26,6 +26,7 @@
|
|||||||
"blender"
|
"blender"
|
||||||
"freelens"
|
"freelens"
|
||||||
"tailscale-app"
|
"tailscale-app"
|
||||||
|
"kicad"
|
||||||
];
|
];
|
||||||
pkgs =
|
pkgs =
|
||||||
pkgs: with pkgs; [
|
pkgs: with pkgs; [
|
||||||
|
|||||||
Binary file not shown.
Reference in New Issue
Block a user