review-priorities

What this skill does

# Review Priorities

A conversational discovery session to assess and assign delta priorities holistically.

## Purpose

When you have multiple deltas and need to determine what to work on, this command helps you:
- Assess current priorities against your goals
- Identify priority inconsistencies
- Assign or reassign priorities based on current context
- Get recommendations for what to focus on

## Context

**You must load the following skills and read the following files before proceeding.**

### Skills
- `katachi:framework-core` - Workflow principles and priority tracking

### Delta inventory
- `docs/planning/DELTAS.md` - All deltas with current status and priority

## Pre-Check

Verify framework is initialized:
- If `docs/planning/` doesn't exist, suggest `/katachi:init-framework` first
- If DELTAS.md missing, explain what's needed

## Process

### 1. Load Current State

Gather the full picture:

```bash
# Get summary of all deltas
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py summary

# Get priority breakdown
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py priority list

# Get ready deltas
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py ready
```

### 2. Present Initial Analysis

Summarize the current state for the user. Always refer to deltas by their title with the ID in parentheses — never by bare ID.

```
"Here's your current delta landscape:

**Status:**
- X ready to work on
- Y in progress
- Z blocked by dependencies

**Priority Distribution:**
- Critical (1): N deltas
- High (2): N deltas
- Medium (3): N deltas [includes X at default]
- Low (4): N deltas
- Backlog (5): N deltas

**Observations:**
- [High-impact blockers: deltas that block many others, referenced by title (ID)]
- [Deltas without explicit priority: still at default 3, referenced by title (ID)]
- [Any obvious inconsistencies]

Let's discuss your current priorities."
```

### 3. Discovery Questions

Ask about the user's current context. Ask ONE question at a time and wait for the answer.

**Goal-oriented questions:**
- "What are you trying to achieve this week/sprint?"
- "Are there any external deadlines or commitments?"
- "Which part of the system needs the most attention right now?"

**Constraint-oriented questions:**
- "Is there anything blocking you from working on certain areas?"
- "Are there any deltas you want to explicitly defer?"
- "Any dependencies on external factors (other teams, APIs, etc.)?"

**Clarification questions (as needed):**
- "You mentioned [X] - does that mean [specific deltas] should be higher priority?"
- "How urgent is [specific capability]?"

### 4. Propose Priority Assignments

Based on the conversation, draft a priority proposal:

```
"Based on our discussion, I suggest:

**Critical (1):**
- User authentication (DLT-015) - blocks 5 other deltas, aligns with your deadline

**High (2):**
- API refactor (DLT-008) - needed before auth, currently blocking
- Error handling (DLT-012) - you mentioned reliability focus

**Medium (3):** (unchanged)
- Email validation (DLT-003), Session management (DLT-007)

**Low (4):**
- UI polish (DLT-001) - nice to have, no urgency

**Backlog (5):**
- Advanced analytics (DLT-002) - explicitly deferred

Does this align with your thinking? Any adjustments?"
```

### 5. Validate Priorities

Dispatch the priority-reviewer agent to check for inconsistencies:

```python
Task(
    subagent_type="katachi:priority-reviewer",
    prompt=f"""
Review these priority assignments for consistency.

## Proposed Priorities
{priority_assignments}

## Dependency Matrix
{dependency_info}

## User Goals
{stated_goals}

Check for:
- Priority inversions (high priority blocked by low priority)
- Bottlenecks (high-impact deltas with low priority)
- Goal alignment
"""
)
```

If the reviewer finds issues, present them to the user and iterate.

### 6. Iterate Based on Feedback

- Apply user corrections
- Re-validate if significant changes
- Repeat until user approves

### 7. Apply Priority Updates

Once confirmed, apply the changes:

```bash
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py priority set DLT-015 1
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py priority set DLT-008 2
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py priority set DLT-012 2
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py priority set DLT-001 4
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py priority set DLT-002 5
```

### 8. Summary

Present the final state:

```
"Priorities updated:

**Changes made:**
- User authentication (DLT-015): 3 → 1 (Critical)
- API refactor (DLT-008): 3 → 2 (High)
- Error handling (DLT-012): 3 → 2 (High)
- UI polish (DLT-001): 3 → 4 (Low)
- Advanced analytics (DLT-002): 3 → 5 (Backlog)

**Suggested next delta:**
[Run `next` command and show result]

**Next actions:**
- Start work: /katachi:spec-delta [suggested delta]
- Review later: /katachi:review-priorities
"
```

## Workflow Principles

**This is a discovery session, not a checklist:**
- One question at a time
- Let the user's answers guide the conversation
- Don't go delta-by-delta; work at a strategic level
- Agent proposes, user confirms
- Always refer to deltas by their title with the ID in parentheses (e.g., "User authentication (DLT-015)"), never by bare ID

**Focus on understanding context:**
- Goals and deadlines matter more than individual deltas
- Dependencies create implicit priorities
- Bottlenecks deserve attention

**Validate before applying:**
- Use priority-reviewer agent to catch inconsistencies
- Present issues to user, don't auto-fix
- User has final say on all assignments

## Error Handling

**No deltas exist:**
- Explain that priorities require deltas
- Suggest `/katachi:init-framework` or `/katachi:add-delta`

**User is unsure about goals:**
- That's OK - help them think through it
- Ask concrete questions: "What would success look like next week?"
- Suggest deferring explicit priority assignment until clearer

**Too many changes:**
- If adjusting 10+ priorities, confirm user wants to proceed
- Offer to focus on top-priority changes first