ProjectBoard: a SQLite tree for agent work, with a lifecycle that refuses illegal moves

说明与用途

ProjectBoard 是一个轻量级工具，将工作项存储在单个 SQLite 文件中，强制执行严格的状态机，并自动附加提交，简化代理工作流程跟踪。

问题

Managing agent work products as markdown files leads to difficulty tracking what is in flight, who owns it, and what actually happened, requiring manual grepping.

结果

ProjectBoard provides a single SQLite file that enforces a state machine, records evidence, and offers multiple interfaces, reducing manual tracking and preventing illegal state transitions.

工作流

• Initialize database with pb init
• Seed demo project with pb seed
• View tree with pb tree
• Serve dashboard and MCP with pb serve
• Use CLI commands to create, move, assign, verify, and search nodes

证据

ProjectBoard is my attempt at the smallest thing that answers those: one SQLite file, one tree, one typed lifecycle, and three faces on top of it (CLI, MCP, read‑only dashboard).

来源

Illegal transitions are errors, not silent writes. todo → done is refused. So is blocked → review.

来源

review → done is a separate operation that requires evidence.

来源

Commits attach themselves. Put a node id in the commit message, e.g. #PROJ/REQ-AUTH/ISSUE-LOGIN-TIMEOUT, and the post‑commit hook calls pb commit attach with the sha.

来源