All shelves / Mods / Workflow
proof9
By frankbria
proof9 is a Claude Code workflow mod by frankbria.
Turns a bug into a CodeFRAME requirement and checks the ledger before each git commit Claude makes, warning by default or denying in block mode.
DrawsHolds a command
Install
The marketplace name is codeframe.
/plugin install proof9 --marketplace frankbria/codeframeIt runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.1.0
- License
- Apache-2.0
- Repo stars
- 24
- Last change
- 2026-10-22
What it can reach
- Draws in the session
- Holds a command
- Sees tool calls
- Runs a command when you press
- Calls another program on this machine
Needs the CodeFRAME CLI, version 0.9.7 or later, installed with uv tool install codeframe-ai. Every command runs cf proof with --json, so the ledger and its rules live in the CLI. From a shell the install is claude plugin install proof9 --marketplace frankbria/codeframe. /proof followed by what went wrong captures a requirement for the whole repository, with test stubs for its obligations, and /proof with text selected in the transcript captures that. /proof ratchet locks in every test that passes today. Claude can capture too, through a capture tool that goes through the normal permission prompt. When Claude runs git commit, proof9 runs cf proof run first. In warn mode, the default, a failing requirement shows a warning, Claude reads which one failed, and the commit goes ahead. In block mode it denies the commit, naming the requirement and the test, and it also denies when the check cannot run. The check covers the whole working tree, untracked files included. Commits made outside Claude's Bash tool are not checked. The status line shows the requirements and how many fail. /proof alone opens the ledger pane, with Run proof, Run full, and Ask Claude to fix. A failing requirement brings a band above the prompt with Ask Claude to fix, Show evidence, Waive, and Dismiss. mode and timeoutSeconds, 120 by default, are in /config.
The marketplace name is codeframe, and the marketplace source is ./proof9. The ledger band and pane are why this page files it under workflow. test-hud draws each test run on the status line, with a pane of the tests that failed. trailhead draws a ticket map beside the chat and refuses a bad commit, a secret, or an unvetted install. This one turns a fixed bug into a requirement each commit has to pass, and denies the commit only in block mode.
Demo

What it hooks into
session.startWhen a session startstool.callAround a tool call, where it can hold onemcp__proof9__captureBashprompt.composeWhile you write a promptui.renderDraws into the sessionAbovePromptPanecommand.runWhen you run its slash command/proof
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/proofRecord a bug so it stays fixed (or: /proof ratchet to lock in passing tests)
Files
The author's README and source, 5 files. They load when you open them.
Facts
- Author
- frankbria
- Category
- Workflow
- Marketplace
- codeframe
- Folder
- proof9
- Version
- 0.1.0
- License
- Apache-2.0
- Repo stars
- 24
- Last change
- 2026-10-22
- Language
- Python
- Files
- 13