# 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

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
```

## Commands

```bash
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.