@ -14,34 +14,34 @@ Run once in the project root. Creates `.nbd/tickets/`. Safe to run multiple time
```sh
```sh
# Create a new ticket (use --ftype md for a human-readable body)
# Create a new ticket (use --ftype md for a human-readable body)
nbd create --title "Add OAuth login" --type feature --priority 7 --ftype md
nbd create --title "Add OAuth login" --type feature --priority 7 --ftype md --json
# List all open tickets (sorted by priority)
# List all open tickets (sorted by priority)
nbd list
nbd list --json
# Read a specific ticket
# Read a specific ticket
nbd read < id >
nbd read < id > --json
# Update a ticket
# Update a ticket
nbd update < id > --status in_progress
nbd update < id > --status in_progress --json
nbd update < id > --status done
nbd update < id > --status done --json
```
```
### Finding what to work on
### Finding what to work on
```sh
```sh
# All tickets that are unblocked and ready to start
# All tickets that are unblocked and ready to start
nbd ready
nbd ready --json
# The single highest-priority unblocked ticket
# The single highest-priority unblocked ticket
nbd next
nbd next --json
```
```
### Workflow
### Workflow
1. **Before starting** — create a ticket: `nbd create --title "..." -- json`
1. **Before starting** — create a ticket: `nbd create --title "..." -- ftype md -- json`
2. **When starting** — mark it in progress: `nbd update <id> --status in_progress `
2. **When starting** — mark it in progress: `nbd update <id> --status in_progress --json `
3. **When done** — mark it complete: `nbd update <id> --status done `
3. **When done** — mark it complete: `nbd update <id> --status done --json `
### Guidelines
### Guidelines