svy04/ballast
34 stars · Last commit 2026-08-16
Builds up to a goal in a field you have no expertise in: splits it into the foundations that goal actually needs, mobilizes what you already hold, learns what is missing, and leaves every solved path behind for the next goal. Nothing is called done until a check passes.
README preview
# ballast **[한국어 문서 →](README.ko.md) · [简体中文 →](README.zh-CN.md)**  **ballast is a Claude Code plugin that takes a goal you have no expertise in, builds it up from the foundations, and carries it through — then keeps every solved path so the next goal starts further along.** A few weeks into working with Claude, this piles up: - **You give the same correction again next month** — the rule arrives with the message it fits - **A settled decision reopens, or quietly changes** — decisions are added, never edited over - **You act on an unsourced answer, and find out later** — a claim must survive refutation first - **Your copy names a feature nobody built yet** — outside claims come from an evidence file - **"Done" turns out to mean Claude said so** — done means a check actually passed - **What you shipped stalls its first reader** — someone who knows nothing runs it first - **Another model's tidy summary lands as fact** — it can fetch, but it cannot rule - **You re-research what the project already wrote down** — everything held is swept before the answer All eight have one cause: the weight sits in the conversation and nowhere else. Ships fix this by loading weight low in the hull, under everything else — that weight is called ballast. Here, it is rules, decisions, and verified facts riding in files, under the conversation.