Tools/README.md
Tools
Apparatus. Not truth, not history, not motion — the things that read and write those three. Nothing in here is ever the source of a fact (ADR-29).
Atlas is what is true. Calendar is what happened. Efforts is what is moving. A tool is none of them, which is why it does not live inside any of them.
What may live here
A tool earns a directory when a ritual that already runs by hand has become the bottleneck. Not before — that is anti-pattern 8, and this directory was refused once on exactly those grounds, on 13 September, correctly.
Every tool here:
- reads the vault directly and keeps no second copy of anything;
- binds to localhost, holds no credentials, and reaches no external account (ADR-04, ADR-20);
- writes only where its ADR says it may, with one git commit per action;
- is deleted when it stops being used. The quarterly tool audit applies here.
What is here
| Tool | ADR | What it does |
|---|---|---|
review-surface/ | ADR-29 | Turns the disposition-needed lines of a brief or a weekly review into three buttons. Localhost, one page. |
A second tool needs a reason that was felt, not anticipated — and, per ADR-29’s Reverse if, not before the first has run four Sundays.
Markdown source
# Tools
Apparatus. Not truth, not history, not motion — the things that read and write
those three. **Nothing in here is ever the source of a fact** (ADR-29).
Atlas is what is true. Calendar is what happened. Efforts is what is moving. A
tool is none of them, which is why it does not live inside any of them.
## What may live here
A tool earns a directory when a ritual that already runs by hand has become the
bottleneck. Not before — that is anti-pattern 8, and this directory was refused
once on exactly those grounds, on 13 September, correctly.
Every tool here:
- reads the vault directly and keeps no second copy of anything;
- binds to localhost, holds no credentials, and reaches no external account
(ADR-04, ADR-20);
- writes only where its ADR says it may, with one git commit per action;
- is deleted when it stops being used. The quarterly tool audit applies here.
## What is here
| Tool | ADR | What it does |
|---|---|---|
| `review-surface/` | ADR-29 | Turns the disposition-needed lines of a brief or a weekly review into three buttons. Localhost, one page. |
**A second tool needs a reason that was felt, not anticipated** — and, per ADR-29's
*Reverse if*, not before the first has run four Sundays.