ClaudeCodeMod

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.

In Claude Code
/plugin install proof9 --marketplace frankbria/codeframe
Open the repo

It 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

A Claude Code session with proof9: asked to make shipping a flat $5 per order, Claude checks the proof ledger, keeps free shipping over $50 because two locked requirements depend on it, and commits with all 4 requirements passing. The status line reads proof9: 4 requirements, 0 failing, and /proof opens the ledger pane.
From the author's repo.

What it hooks into

  • session.startWhen a session starts
  • tool.callAround a tool call, where it can hold onemcp__proof9__captureBash
  • prompt.composeWhile you write a prompt
  • ui.renderDraws into the sessionAbovePromptPane
  • command.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
Repo
frankbria/codeframe
Folder
proof9
Version
0.1.0
License
Apache-2.0
Repo stars
24
Last change
2026-10-22
Language
Python
Files
13

Other mods in Workflow

directorEvolvingAgentsLabsHolds a commandKeeps a team's way of working as linked statements Claude plans from, and draws a status line and a band to run a waiting plan or accept a lesson it learned.bigquery-agent-analytics-modGoogleCloudPlatformStreams each session's prompts, model requests, tool calls, and subagents as rows to your BigQuery table, and says above the prompt when they land.next-stepsbradtraversyAfter each turn, has Haiku suggest two or three next prompts above the prompt, as buttons on the desktop that draft one, or 1, 2, and 3 in the terminal.critical-decisionsMucidaHas Claude record each call it made that you never asked for, with the reason, in a band above the prompt, red or yellow, with ok, rethink, and not critical.painelGabrielPauloTOpens a side panel, in Portuguese, of the running tool, Claude's latest thinking, its plan steps, the files it edited with line counts, subagents, and context.tavernweave-agent-skillsLiarMTTTDraws a Soul switch above the prompt that fills a persona's instruction into the prompt box, beside 23 skills for building SillyTavern character cards.hopper-hqFairMind-Gen-AI-StudioDraws a band above the prompt while another session waits for you or has finished, and opens hopper-hq, a browser office where each session has a desk.taskplannersmekaiOpens a board of the repo's .tasks/ Markdown tasks beside the transcript to move, add, or start one with Claude, and names the one in progress above the prompt.agent-taskskeshrathOpens agent-tasks' stage-gated pipeline in a /pipeline pane beside the conversation: tasks by stage, artifacts and comments, advance, send back, and complete.deltazed-industriesRecords this session and its Git checkout to Delta, asks who should see it on /delta-share, and lets a teammate join the thread from their own Claude Code.ci-lightdavekissDraws a red row above the prompt while the repo's default branch fails CI, with how long and how many pushes since, and a quiet green under it otherwise.swarmery-linkatretyak1985Holds a commandReports this session's turns, tool calls, context, and cost to a local swarmery dashboard, and with options draws the plan phase and holds conflicting writes.
All 396 in Workflow