# 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

## Principle

Markdown files are the source of truth. No database is required.