This is the record of an abcd-managed repository

abcdBetav0.16.2 · 2026-11-06

abcd — Agent-Based Configuration for Development

For people who know what they want to build and need help shipping it.

A single Go binary that carries the why from idea to shipped reality, usable as a plugin in compatible agent harnesses.

Press Release

abcd helps a product thinker realise an intent as a high-fidelity prototype or demonstrator — carrying the why from idea to shipped reality. State what should exist, why, for whom, and what good looks like, as a press-release intent (/abcd:intent "<text>"); abcd holds that why through planning (/abcd:intent plan), the readiness gate (/abcd:intent ready) and delivery, and when the work lands it is audited against the intent's own acceptance criteria (/abcd:intent audit), with the verdict recorded on the intent, so what was promised and what was delivered are read side by side. The lifeboat is a key capability of the same product: point /abcd:disembark pack <source-repo> <dest> at any repository — one that has grown unwieldy, or one that died years ago and that abcd never managed — and abcd reads it without writing a single byte back, packing its hard-won knowledge — decisions, principles, pitfalls, the graveyard of what failed, the spine of what was built and why — into a portable lifeboat artefact at <dest>, alongside a coverage report that names what it could not ground and the questions a human must answer. /abcd:disembark probe <source-repo> renders that coverage verdict on its own, and /abcd:embark from <path> unpacks a lifeboat into a clean foundation with the same wisdom but none of the cruft. A small command surface rounds out the workflow: install (/abcd:ahoy install) and public release (/abcd:launch ship); /abcd:capture keeps discovered issues structured as the project evolves; and /abcd:library keeps the documents you consult and curates a queryable knowledge substrate from those same sources. Bare invocation of any command shows status + suggested next actions; state-mutating actions require an explicit sub-verb (the universal abcd convention).

"I know what I want built and I can tell in a minute whether a prototype got it right. What I could never do was hold that line through the engineering. abcd takes the why as I wrote it, builds against it, and shows me what was promised next to what was delivered," said Iris, a product thinker.

"I'd hit the wall on a side project three times this year — every rebuild from scratch lost the lessons I'd already learned the hard way. abcd is the first tool that treats those lessons as the output worth saving, not just the code," said Maya, an AI/agent researcher.

intents

itd-2611012048006057 · shipped · v0.16.1from the record

A preflight never starts on a machine that is out of memory. When several agent sessions build, review and test on one machine at once, abcd's load gate already waits for the processor load to fall and refuses when the disk is nearly full; now it also reads how much memory pressure the machine is under. When the system reports memory pressure at or above the floor the person set (macOS's own pressure level, or on Linux the share of recent time tasks stalled waiting for memory), a preflight or a gated test run waits at the gate, bounded as the load wait is, instead of starting a test stage that would push the machine past its memory and stall every session on it. The wait says what it is waiting for, and a reading abcd cannot take lets the work through and says so, so the floor never wedges a run.

itd-2610290746077716 · shipped · v0.16.0from the record

A person running several repositories with abcd can see, in one read-only report, how each repository's GitHub settings differ from a safe baseline: one line per setting, saying what it is now and what it should be. Secret scanning off on a public repository shows up. So does a default branch anyone can force-push, or a required check that no workflow runs. When the person says yes, abcd turns on what is missing and writes down what it changed. It never changes whether a repository is public or private, and it never requires a check the repository's own workflows do not run. A setting the plan does not offer is listed as owed, so it applies once the repository goes public. A repository that wants a setting left alone says so in its own reviewed config.

itd-2610161617096084 · shipped · v0.16.0from the record

After a plugin update, abcd says what changed in words a person can use. When the next session notices that the abcd plugin was updated, the agent's first reply gives one line per release saying what changed, with the full summary one command away: what waits on this repository, and anything that now needs the person to act. Alice, a solo founder, sees: abcd 0.16.0, live brief sessions are new and need setup here; ask for details. They know what changed without reading the whole changelog. The summary comes from a short digest each release carries inside abcd itself, never fetched from the internet.

releases

all releases · CHANGELOG.md