asermax Delta Summary
Display a summary table of all deltas with optional filtering by status, priority, or show recommended next deltas to work on.
Input
Filter: $ARGUMENTS (optional)
- No filter: Show all deltas sorted by priority
- Status filter: Partial match on status (e.g., "Spec", "Implementation", "Not Started")
- Priority keywords: "critical", "high", "medium", "low", "backlog" → filter by priority level
- "next work": Show top 5 recommended deltas using the
nextcommand
Context
You must load the following skills and read the following files before proceeding.
Skills
katachi:framework-core- Workflow principles
Delta inventory
docs/planning/DELTAS.md- Delta inventory
Pre-Check
Verify framework is initialized:
- If
docs/planning/doesn't exist, suggest/katachi:init-frameworkfirst - If DELTAS.md missing, explain what's needed
Process
1. Validate Framework
Check for required files:
docs/planning/DELTAS.md
If missing, suggest /katachi:init-framework first.
2. Parse Input and Determine Mode
Analyze $ARGUMENTS to determine which command to run:
| Input Pattern | Command | Behavior |
|---|---|---|
| (empty) | summary |
Show all deltas, sorted by priority |
| "next work" or "next" or "recommended" | next --top 5 |
Show top 5 recommended deltas |
| "critical" | summary --priority 1 |
Show only Critical priority |
| "high" | summary --priority 2 |
Show only High priority |
| "medium" | summary --priority 3 |
Show only Medium priority |
| "low" | summary --priority 4 |
Show only Low priority |
| "backlog" | summary --priority 5 |
Show only Backlog priority |
| "ready" | summary --ready |
Show only deltas ready to implement |
| Anything else | summary <filter> |
Treat as status filter |
3. Execute Appropriate Command
Mode: Next Work (Recommended Deltas)
When user asks for "next work", "next", or "recommended":
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py next --top 5
This shows the top 5 deltas recommended to work on next, ranked by:
- Priority level (Critical/High first)
- Impact (how many other deltas are blocked)
- Complexity (prefer easier wins)
Mode: Ready (Unblocked Deltas)
When user asks for "ready":
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py summary --ready
This shows only deltas whose dependencies are all complete, meaning they can be started immediately.
Mode: Priority Filter
When user specifies a priority keyword:
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py summary --priority <level>
Mode: Status Filter (Default)
For any other filter:
python ${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py summary $ARGUMENTS
4. Display Results
The command outputs directly to the console:
- Summary mode: Formatted table with ID, Name, Status, Priority, Complexity, and Impact
- Next mode: Numbered list of top recommended deltas with rationale
Error Handling
Framework not initialized:
- Suggest
/katachi:init-frameworkfirst - Don't attempt to create files manually
No matching deltas:
- The command will display "No deltas found matching..."
- This is expected behavior when filter doesn't match any deltas
Invalid input:
- If the user types an unrecognized filter, treat it as a status filter
- The underlying command will handle unknown filters gracefully
Examples
# Show all deltas (sorted by priority)
/katachi:delta-summary
# Show recommended next deltas (top 5)
/katachi:delta-summary next work
# Show only Critical priority deltas
/katachi:delta-summary critical
# Show only High priority deltas
/katachi:delta-summary high
# Show only Spec-related deltas (status filter)
/katachi:delta-summary Spec
# Show only Implementation-related deltas
/katachi:delta-summary Implementation
# Show only deltas ready to implement (unblocked)
/katachi:delta-summary ready
# Show only "Not Started" deltas
/katachi:delta-summary "Not Started"
Workflow
This is a read-only command for viewing delta status:
- No modifications to framework files
- No user iteration required
- Displays current state and exits
- Smart parsing: detects priority keywords and "next work" automatically