# TASKS

## TASK-000 — Bootstrap RDB project standards

Status: Done

Goal: Add the project control files used by RDB agent workflows.

Acceptance Criteria:

- PROJECT_STATE.md exists
- AGENT_HANDOFF.md exists
- .rdb/project.json exists
- context/repository-context.md exists
- TEST_PLAN.md exists
- RUN_LOG.md exists
- README.md explains the structure

## TASK-001 — Implement rdb init

Status: Done

Goal: Create the command that initialises the standard RDB project structure.

## TASK-002 — Generate agent prompts

Status: Done

Goal: Add a command that generates a ready-to-paste implementation prompt for the next Todo task.

Acceptance Criteria:

- `rdb prompt` reads the next Todo task from TASKS.md
- The prompt tells the agent to read README.md, TASKS.md, PROJECT_STATE.md, AGENT_HANDOFF.md, and context/agent-guidelines.md
- The prompt says to implement one task only
- The prompt includes the task title, status, goal, and acceptance criteria
- The prompt includes validation instructions
- The prompt includes reporting instructions
- Add or update tests

## TASK-003 — Improve discovery workflow

Status: Done

Goal:
Improve `rdb discover` so it records structured answers into the discovery ledger.

Acceptance Criteria:

- Ask the 10 core discovery questions
- Record:
  - Question
  - Answer
  - Confidence
  - Follow-up needed
  - Linked decision
  - Linked task
  - Date
- Append answers safely
- Preserve existing discovery history
- Add/update tests
- Update RUN_LOG.md

## TASK-004 — Implement ask-more command

Status: Done

Goal: Add a command that finds weak answers and asks deeper follow-up questions.

Acceptance Criteria:

- command reads discovery-log.md
- low-confidence answers are detected
- follow-up answers are appended to discovery-log.md

## TASK-005 — Task lifecycle commands

Status: Done

Goal:
Allow tasks to be managed from the CLI rather than manually editing TASKS.md.

Acceptance Criteria:

- `rdb start TASK-ID`
  - Marks task In Progress

- `rdb complete TASK-ID`
  - Marks task Done

- Updates PROJECT_STATE.md
- Updates AGENT_HANDOFF.md
- Updates RUN_LOG.md
- Preserves task formatting
- Add/update tests
- Run python -m pytest

## TASK-006 — Agent execution guardrails

Status: Done

Goal:
Detect agent stalls, repeated reads, long reasoning loops, and non-progressing execution.

Acceptance Criteria:

- `rdb guardrails` command exists ✓
- Detects repeated file reads via AGENT_HANDOFF.md analysis ✓
- Detects repeated command entries in RUN_LOG.md ✓
- Flags project files not modified in >48 hours ✓
- Flags missing test run records in RUN_LOG.md ✓
- Checks TASKS.md ↔ RUN_LOG.md consistency ✓
- Produces clear human-readable report with overall status ✓
- All existing tests still pass (33 → 51) ✓
- Guardrail-specific tests added (18 new tests) ✓

## TASK-007 — Improve generated agent prompts

Status: Todo

Goal:
Make `rdb prompt` produce smaller, more direct prompts for Claude Code/local LLM agents.

Acceptance Criteria:

- Prompt includes exact known implementation gap when available
- Prompt includes existing test command from CLAUDE.md
- Prompt tells agent not to repeatedly reread unchanged files
- Prompt tells agent to inspect first, then edit
- Prompt limits scope to one small implementation step
- Add/update tests

## TASK-012 — Agent telemetry

Goal:
Capture actual agent actions rather than inferring behaviour
from documentation and run logs.

Examples:

- file reads
- file writes
- command execution
- test execution
- git activity

Output:
.rdb/session-log.jsonl