Files
rdb-discovery/TASKS.md
T
2026-06-02 11:41:27 +01:00

149 lines
3.5 KiB
Markdown

# 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