Files
rdb-discovery/TASKS.md
T
robbond 21611b7c4e feat(TASK-005): wire project state and agent handoff into start/complete commands
- Add update_project_state() helper: updates Current Task + Last Updated
  in PROJECT_STATE.md via regex sub, preserving all surrounding formatting.
- Add update_agent_handoff() helper: updates Current Stage + Current Task
  sections in AGENT_HANDOFF.md, auto-detected from project_stage().
- Wire both helpers into rdb start TASK-ID and rdb complete TASK-ID CLI
  commands so task lifecycle transitions propagate to all control files.
- ADDING test_status.py with 5 tests: update_project_state task/timestamp
  updates, missing-file false return, agent handoff update and miss.

Acceptance criteria met:
- rdb start/complete now update PROJECT_STATE.md
- rdb start/complete now update AGENT_HANDOFF.md
- RUN_LOG.md already updated (pre-existing)
- Task formatting preserved (regex sub targets single line only)
2026-06-02 10:37:38 +01:00

2.6 KiB

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