Claude-Mind: Skill for Claude Code

/backlog-report — Sprint Planning Backlog

Generates a complete, copy-pasteable markdown backlog of all aspirations, goals, scores, blockers, and user action items. Writes agents/<agent>/BACKLOG.md and displays a compact terminal summary.

Hybrid skill: user-invocable AND agent-callable. Valid from ANY state. Safe: read-only with respect to agent state (only writes the output file).

Sub-commands

/backlog-report              — Generate full backlog report

Phase 0: Load Conventions

Step 0: Load Conventions — Bash: load-conventions.sh with each name from the conventions: front matter. Read only the paths returned (files not yet in context). If output is empty, all conventions already loaded — proceed to next step.

Phase 1: Gather Data

Run these in parallel where possible:

1. Active aspirations (full detail)
   Bash: aspirations-read.sh --active
   → Parse JSON → store as aspirations[]

2. Scored goal rankings
   Bash: goal-selector.sh select
   → Parse JSON → store as scored_goals[]

3. Blocked goals with diagnostics
   Bash: goal-selector.sh blocked
   → Parse JSON → store as blocked_data

4. Pending questions (user review items)
   Read: agents/<agent>/session/pending-questions.yaml
   → Parse YAML → filter status == "pending" → store as pending_questions[]
   → IF file missing or empty: pending_questions = []

5. Active hypotheses
   Bash: pipeline-read.sh --stage active
   → Parse JSON → store as active_hypotheses[]

6. OHS-delta rollup per aspiration (g-245-03)
   Bash: meta-read.sh improvement-velocity.yaml
   → Parse YAML → for each entry, record {goal_id, ohs_delta_since_previous_ohs_run}
   → Build velocity_map[goal_id] = ohs_delta (float OR 'no_ohs_data')
   → IF field missing from entry: treat as 'no_ohs_data' (pre-schema entries)

Phase 2: Build Indexes

1. SCORE MAP — For each goal in scored_goals[]:
     score_map[goal_id] = {score, breakdown, category, recurring, recurring_urgency}

2. BLOCKED MAP — For each goal in blocked_data.blocked_goals[]:
     blocked_map[goal_id] = {reason_group, block_detail}

3. USER GOALS — Scan all goals across aspirations[]:
     # Two passes: (a) all user-routed goals (for the historical-count note),
     # (b) only actionable goals (pending|deferred|blocked) for the dashboard.
     # Without the status filter, the renderer reports completed historical
     # records as "needing you" — observed pollution: 22 of 24 entries
     # were status=completed (g-115-210 / rb-526). Status filter applies
     # ONLY to the "Goals Needing You" surface in section 3b — completed
     # records remain queryable via aspirations-read.sh for audit.
     ACTIONABLE_STATUSES = {"pending", "in-progress", "deferred", "blocked"}
     all_user_goals = [g for g in <all goals> if "user" in g.participants]
     user_goals = [g for g in all_user_goals if g.status in ACTIONABLE_STATUSES]
     # Counts for the render-time note (used in section 3b):
     total_user_routed = len(all_user_goals)
     historical_user_routed = total_user_routed - len(user_goals)
     # Each user_goals entry includes: goal_id, aspiration_id, aspiration_title,
     # title, priority, score (from score_map), category, status

4. RECURRING HEALTH — Scan all goals across aspirations[]:
     IF goal.recurring == true:
       IF lastAchievedAt is null: overdue_by = infinity (never completed — always most overdue)
       ELSE: overdue_by = max(0, hours_since(lastAchievedAt) - interval_hours)
       Add to recurring_list[]: goal_id, title, interval_hours, lastAchievedAt, overdue_by, currentStreak
     Sort recurring_list by overdue_by descending

5. TESTABLE HYPOTHESES — Filter active_hypotheses[]:
     IF resolves_no_earlier_than is null/missing OR resolves_no_earlier_than <= today:
       add to testable_hypotheses[]
     Sort by confidence descending

6. OHS_DELTA_MAP — For each active aspiration, sum OHS deltas of its completed goals:
     ohs_delta_map[asp_id] = {"sum": float_or_na, "scored": int, "total_completed": int}
     FOR EACH asp in aspirations[]:
       numeric_deltas = []
       completed_count = 0
       FOR EACH goal in asp.goals WHERE status == "completed":
         completed_count += 1
         delta = velocity_map.get(goal.id, 'no_ohs_data')
         IF isinstance(delta, (int, float)):
           numeric_deltas.append(delta)
       IF numeric_deltas:
         ohs_delta_map[asp.id] = {"sum": round(sum(numeric_deltas), 2), "scored": len(numeric_deltas), "total_completed": completed_count}
       ELSE:
         ohs_delta_map[asp.id] = {"sum": "n/a", "scored": 0, "total_completed": completed_count}
     # Display: "+0.45 (3/12)" when scored > 0; "n/a" when no OHS-tracked goals yet