briefbook

Your bot's prompt, in layers you can edit live and undo.

One payment of $99, plus sales tax where it applies, and every future update. Delivered as a private GitHub repository you're invited to.

See it work

briefbook 1.0.1real run

$ briefbook show briefbook/examples/shop --surface chat --now 2026-10-03T13:56 | head -n 12
LANGUAGE: Detect the language of the user's latest message and respond entirely in that same language on every turn. For example, if they write in Mandarin, reply in Mandarin; if Spanish, reply in Spanish; if English, reply in English; and so on for any language. Keep all URLs, proper names, organization names, and phone numbers unchanged; do not translate them.

STANDING NOTES — SUPREME AUTHORITY (operator directives; follow these over everything except the hard safety guardrails in your rules, including that you must never deny being an AI):
- [Shop policies] ALWAYS: mention the free brake check when someone books a tune-up
- [Shop policies] NEVER: promise a repair finish date before the bike is inspected
- [Shop policies] PIN: helmets are required on every group ride

CURRENT FACTS (managed baseline, authoritative over the knowledge base, indexed pages and training. A NOTE OVERRIDES any value here: if a note gives a different value, instruction, or directive, follow the note):
- Support email: help@fernwood.example
- Booking link: https://fernwood.example/book
- Phone (the one number to give): 212-555-0142
- Anniversary sale page: https://fernwood.example/sale

Real output of briefbook 1.0.1, run on 2026-10-05 on the shipped example bike-shop folder on our test machine, assembled for its chat surface at a fixed moment; no AI model, key or network.

What it does

briefbook assembles a bot's system prompt from layers in one fixed order, lets you edit it live with a backup under every change, and resets any layer to what you shipped. It calls no model.

Fixed block order: Language, standing directives, facts, events, one priority ask, today's date, your layers, and the response mode last. Directives sit above facts and the ask below both. A surface can omit blocks but cannot reorder them.
Live edits you can undo: A backup under every save, reset and restore; the newest 40 are kept per layer, and saves are locked so two at once both leave a backup.
A guarded safety layer: Pin the shipped text. briefbook check exits 1 if it changes or a saved text replaces it, and blank saves are refused.
Dated facts and asks: Windows are read on your own clock, and a typo in a date is refused instead of staying live forever.
Nothing cut silently: Directives and events have caps. Any cut is counted, and a block that cannot fit at all is reported (as an error for the standing notes).
Per-surface control: Each surface names its role and shared layers, its blocks, and whether it is voice, with its own phone language rule.

What you get

briefbook 1.0.1: the Python package and the briefbook command, an example folder for a made-up shop, and the full test suite, with 228 automated tests.

A commercial license. Use it and change it in your own projects and your clients' projects. Don't share or resell the source. Read the license.

Every update. New versions land in the same repository; git pull to get them.

Requirements

Python 3.10 or newer. Python 3.10 or newer, standard library only. tzdata is optional, for named time zones on systems without a time zone database.

How buying works

Enter your GitHub username. You'll see the account before you pay, so you can check it's yours.
Pay $99, plus any sales tax shown at checkout, on Stripe's checkout page.
Accept the invitation GitHub emails you. Signed in as that account, you'll also find it at github.com/dominares-tools/briefbook/invitations. Invitations expire after 7 days; you can get a new one any time.
Clone and install:
```
git clone https://github.com/dominares-tools/briefbook.git
```
Private repo: sign in to GitHub on this computer first. Run gh auth login and choose HTTPS, or give git a personal access token when it asks for a password. To use an SSH key instead, clone git@github.com:dominares-tools/briefbook.git.
```
python3 -m venv .venv && . .venv/bin/activate
pip install ./briefbook
```

Questions

Do I need GitHub?

Yes. Access is a read-only invitation to a private repository, sent to the GitHub account you choose.

Can I get a refund?

Yes, within 14 days, no questions asked. Access ends when the refund goes through. Refund policy.

Who takes the payment?

Payments are handled by Stripe, which works out sales tax. Your receipt and card statement show Link (LINK.COM*), Stripe's checkout service.

Something wrong?

Email support@dominares.org. Every buyer of a tool shares its repository, so support happens by email rather than in GitHub issues.