prodc
Product management as code: roles, flows, and features, each traced to the evidence behind it and the test that proves it. The aim is to make product work something a whole team can share — kept in the repo, next to the code, read by the tools you already use — rather than a specialty locked in one person's head and one tracker.
prodc records that structure and checks it holds together; it does not call a model or ping a tracker. Two ideas carry it, both about not fooling yourself:
- A need with no evidence is an opinion. Write down who asked for something — an interview, a ticket, an email — or prodc flags it as an opinion, because that is what it is until someone outside the room has asked.
- "Done" is a claim your tests back. You attach a proof (a locator into your test suite), and
prodc statusreports each need as DELIVERED, PENDING, HOLE (an honest gap), or BROKEN. The status is read from the repo, not remembered from a standup.
Install
pip install prodc # or: uv add prodc
uv sync && make check # contributors: deps + lint + typecheck + test
Use
prodc status
prodc status — quickstart
gaps: 2 HOLE · 1 opinion coverage 1/3 (33%)
id GROUNDS need WARRANT
jordan (design partner) 1 DELIVERED · 2 HOLE
!! N-1 DELIVERED* 1/1 see which orders are past due at a glance primary:Jordan
N-2 HOLE export the day's delivery run sheet secondary
N-3 HOLE implement a settings page opinion
⚠ text may be a solution in disguise (starts with 'implement')
GROUNDS = does a test prove it. WARRANT = did a user ask for it. The gap between them is the point.
Use it with an agent
prodc ships a playbook that teaches a coding agent to run it as the project's product manager — read the board, capture evidence, record needs with honest provenance, find proofs, gate before a handoff. Drop it where your agent reads project guidance:
prodc agent >> AGENTS.md # or: prodc agent --write AGENTS.md
This is how an engineer vibe-codes their way into product work: the agent does the product management from inside the repo, with prodc keeping it honest.
Docs
- Quickstart — 60 seconds to a board
- Commands — every verb, one line each
- Model — the nouns (Need, Role, Goal, Release) and the Need fields
docs/issues/ holds follow-ups. AGENTS.md is for coding agents.
1 maintainer
Metadata
1 maintainer
Release files for prodc 0.4.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| prodc-0.4.4.tar.gz | 160.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| prodc-0.4.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 276.9 kB
Release files / prodc-0.4.4.tar.gz
| Download URL | prodc-0.4.4.tar.gz |
|---|---|
| Size | 160.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2864a2d39f24a658a9080cbfc9574f830ceac519ada594b62d3133a9ae472e89
|
|
BLAKE2b-256 checksum How to use checksums |
f525c19fe4ba93680f7711ff131f3b419464260804dad9d6bf6afe225a10d087
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / prodc-0.4.4-py3-none-any.whl
| Download URL | prodc-0.4.4-py3-none-any.whl |
|---|---|
| Size | 116.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
934a642611daffa176d5f2a1b8b183c9830d767f21e59ac4b13496fcec847a69
|
|
BLAKE2b-256 checksum How to use checksums |
45ca1b8f921e6222dab4a22b7761a5cccc02cab682233be726e12abe35d7ad52
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
