robbond
21611b7c4e
- Add update_project_state() helper: updates Current Task + Last Updated in PROJECT_STATE.md via regex sub, preserving all surrounding formatting. - Add update_agent_handoff() helper: updates Current Stage + Current Task sections in AGENT_HANDOFF.md, auto-detected from project_stage(). - Wire both helpers into rdb start TASK-ID and rdb complete TASK-ID CLI commands so task lifecycle transitions propagate to all control files. - ADDING test_status.py with 5 tests: update_project_state task/timestamp updates, missing-file false return, agent handoff update and miss. Acceptance criteria met: - rdb start/complete now update PROJECT_STATE.md - rdb start/complete now update AGENT_HANDOFF.md - RUN_LOG.md already updated (pre-existing) - Task formatting preserved (regex sub targets single line only)
rdb-discovery
A small CLI-first tool for repeatable software project discovery and delivery.
It creates markdown files that help humans and AI coding agents understand:
- what is being built
- why it exists
- what questions remain open
- what task should be done next
- what stage the project is currently in
Install for local development
python3 -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
Commands
rdb init
rdb discover
rdb status
rdb next
rdb start TASK-001
rdb complete TASK-001
rdb handoff
Bootstrap workflow
- Run
rdb init - Run
rdb discover - Run
rdb status - Run
rdb next - Give the next task to Claude Code or Cline
- Commit after each completed task
Project structure
rdb init creates the following files (skips existing ones):
- context/discovery-log.md
- context/product-brief.md
- context/architecture.md
- context/decisions.md
- context/risks.md
- context/assumptions.md
- context/open-questions.md
- context/repository-context.md
- TASKS.md
- TEST_PLAN.md
- RUN_LOG.md
- PROJECT_STATE.md
- AGENT_HANDOFF.md
- .rdb/project.json
Principle
Markdown files are the source of truth. No database is required.