45 lines
818 B
Markdown
45 lines
818 B
Markdown
# 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.
|