dbreunig

dbreunig / plumb

Public

A tool for keeping things true.

19
2
100% credibility
Found Mar 05, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Plumb is a development tool that intercepts code commits to extract decisions from AI conversations and changes, prompts for review, and automatically updates specifications and tests to maintain synchronization.

How It Works

1
💡 Discover Plumb

You learn about Plumb, a smart helper that keeps your project plans, checks, and actual work always perfectly matched while coding with AI.

2
📦 Add to your project

You simply add Plumb to your coding folder, and it gets ready to watch over your work.

3
🔗 Point to your plans and checks

You tell Plumb where your project plan notes are and where your test checks live.

4
🤖 Code with your AI buddy

You team up with your AI helper to build features, make choices, and tweak your project—it feels smooth and creative.

5
💾 Save your changes

As you save, Plumb gently pauses to highlight the big decisions from your chat and updates.

6
Review key choices
✅
Approve it

You say yes, and it gets added to your plans and checks.

❌
Reject it

You say no, and Plumb tweaks the work to match your plans better.

✏️
Edit it

You refine the choice, and it updates everything accordingly.

🎉 Project stays perfectly synced

Your plans grow with new details, checks cover everything, and your code is always clear and reliable—peace of mind achieved!

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is plumb?

Plumb is a Python git pre-commit hook for AI-assisted development with Claude Code, acting as a housekeeping tool to keep your spec, tests, and code perfectly aligned. It scans staged diffs and conversation history during commits, extracts key decisions like API changes or caching strategies, and pauses for your review—approve to auto-sync updates to specs and generate tests, or reject to revert code. Install via pip, run `plumb init` to set up paths and hooks, then commit as usual; it's your plumber ensuring nothing drifts like a plumb line keeping things true.

Why is it gaining traction?

Unlike generic linters, plumb uniquely bridges AI chats to specs with Claude skills integration, preventing the "spec rot" that plagues LLM-driven coding where decisions vanish into history. Devs love the `plumb review`, `plumb coverage`, and `plumb sync` commands for instant alignment checks across code, spec-to-test, and spec-to-code metrics—no more manual test writing or outdated docs. As a github tool kit staple, it fits workflows on Windows 11 or anywhere git runs, caching analysis smartly without bloat.

Who should use this?

Backend and fullstack devs using Claude for rapid prototyping, especially those maintaining markdown specs and pytest suites in spec-driven teams. Ideal for solo hackers or small squads battling AI-induced drift in feature branches, or anyone in "keeping tool in place" scenarios like evolving APIs. Skip if you're not deep into Anthropic's ecosystem.

Verdict

Promising alpha POC for Claude power users, but 19 stars and 1.0% credibility score signal early days—docs are solid, but expect bugs in edge cases. Try it on a side project if AI dev hygiene matters; otherwise, wait for polish.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.