Metadata-Version: 2.4
Name: rdb-discovery
Version: 0.1.0
Summary: Markdown-first discovery and delivery workflow CLI for software projects.
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.12.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"

# 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.
