/dr-status

Overview

/dr-status is a read-only command that shows you the current state of your Datarim workspace at a glance. It displays all active tasks with their complexity levels and pipeline stages, the overall backlog summary, recently completed tasks, and suggests the next action.

Usage

/dr-status
/dr-status --recent 10
/dr-status <TASK-ID> what's next?

What It Shows

1. All Active Tasks — from the thin one-liners in ## Active Tasks of activeContext.md (or ## Active in tasks.md). For each task: ID, status, priority, complexity level, and title. Shown as a numbered list for easy reference. If no active tasks, says so explicitly.
2. Backlog Summary — counts of pending, blocked-pending, and cancelled one-liners in backlog.md.
3. Recently Completed — computed at runtime from the newest documentation/archive/**/archive-*.md files (--recent N, default 5); no stored section.
4. Next Steps — suggestion for what command to run next based on the current state.

Arguments

Optional. --recent N (1–50) sets how many recently completed tasks to list. A task ID plus a free-form question (for example what's next?) switches to the pull-mode oracle: it answers what to do next on that task from its stage snapshot, falling back to the task’s status. Both modes are read-only.

Output

Display only. This command does not modify any files.

Files Read

• datarim/activeContext.md — active tasks
• datarim/tasks.md — task details and implementation plans
• datarim/backlog.md — pending, blocked, and cancelled items
• documentation/archive/ — recently completed tasks
• datarim/snapshots/{TASK-ID}.snapshot.md — stage snapshot (pull-mode oracle)

Example Session

> /dr-status

=== ACTIVE TASKS ===
  1. <TASK-ID> · in_progress · P1/L3 · Implement user authentication
  2. UI-NNNN · not_started · P2/L2 · Dashboard dark mode

=== BACKLOG ===
  pending: 5 items
  blocked-pending: 1 item
  cancelled: 0 items

=== RECENTLY COMPLETED ===
  2026-04-15 · <TASK-ID> · Deploy pipeline setup

=== NEXT STEPS ===
  Continue <TASK-ID>: /dr-next
  Check task progress: /dr-do

Related Commands

• /dr-next — resume work on a specific task
• /dr-init — start a new task from the backlog
• /dr-help — full command reference

Reporting the result

Apply Human Outcome Reporting before a human-facing update or result. Explain the user-visible outcome, the original conditions, checks and evidence, and open limitations. A stage result does not mean the entire task is complete. Keep exact protocols and technical records intact. To explain again without continuing work, use /dr-explain.