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

1. Run rdb init
2. Run rdb discover
3. Run rdb status
4. Run rdb next
5. Give the next task to Claude Code or Cline
6. 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.