Review
Quick status review across all work areas. Read-only - does not modify memory bank.
Usage
/review # Full review with all sections
/review brief # One-line status per work area
/review time # Focus on time tracking summary
Argument provided: "$ARGUMENTS"
Step 0: Parse Arguments
Parse $ARGUMENTS to determine mode:
- •Empty or
full→ Full review mode - •
brief→ Brief mode (compact output) - •
time→ Time tracking focus
Step 1: Read State (All Modes)
Read memory bank files:
- •
.claude/memorybank/session.md- Current focus, recent work, next steps - •
.claude/memorybank/progress.md- Work history, decisions, blockers - •
.claude/memorybank/overview.md- Work areas, project identity
Also read:
4. logs/log_index.yaml - Session timing information
5. Current log file (if session active) - Today's work entries
Important: Do NOT modify any files. This is a read-only operation.
Mode: Brief (/review brief)
Compact single-screen overview.
Output Format
code
## Status: [Project Name] | Area | Status | Progress | Updated | |------|--------|----------|---------| | [area-1] | ● active | [████████░░] 80% | 2h ago | | [area-2] | ◐ in-progress | [████░░░░░░] 40% | 1d ago | | [area-3] | ○ not started | [░░░░░░░░░░] 0% | - | | [area-4] | ✓ complete | [██████████] 100% | 3d ago | **Focus**: [current focus from session.md] **Session**: [active/inactive] | [duration if active] **Blockers**: [count] ([brief list or "None"]) → `/plan` to update plan | `/document` to record progress
Mode: Time (/review time)
Focus on time investment and session history.
Output Format
code
## Time Review: [Project Name] ### Current Session - **Status**: [Active / Not active] - **Started**: [timestamp or "No active session"] - **Duration**: [Xh Ym] (ongoing) - **Entries**: [N] logged items ### Project Totals - **Total tracked time**: [Xh Ym] - **Sessions**: [N] sessions - **Average session**: [Xh Ym] ### Recent Sessions | Date | Duration | Title/Summary | |------|----------|---------------| | [date] | [Xh Ym] | [title from frontmatter] | | [date] | [Xh Ym] | [title] | | [date] | [Xh Ym] | [title] | ### Time by Work Area (estimated) Based on session content analysis: | Area | Time | % of Total | |------|------|------------| | [area-1] | [Xh] | [██████░░░░] 60% | | [area-2] | [Xh] | [████░░░░░░] 40% | --- → `/logwork start` to begin tracking | `/logwork end` to close session
Mode: Full (/review)
Comprehensive status review.
Process
- •Read all memory bank files
- •Extract work areas from overview.md
- •Calculate progress for each area from progress.md
- •Get current focus and blockers from session.md
- •Get time tracking info from logs/
- •Format and display
Output Format
code
## Session Review: [Project Name] *Review generated: [timestamp]* *Memory bank last updated: [session.md timestamp]* --- ### Quick Stats | Metric | Value | |--------|-------| | Work areas | [N] total ([X] active, [Y] complete) | | Current focus | [focus area] | | Session status | [Active: Xh Ym / Not active] | | Total project time | [Xh Ym] across [N] sessions | | Blockers | [N] ([High/None]) | --- ### Work Areas Status | Area | Status | Progress | Last Activity | |------|--------|----------|---------------| | [area-1] | ● active | [████████░░] 80% | [relative time] | | [area-2] | ◐ paused | [████░░░░░░] 40% | [relative time] | | [area-3] | ○ pending | [░░░░░░░░░░] 0% | Not started | | [area-4] | ✓ complete | [██████████] 100% | [relative time] | **Legend**: ● active | ◐ paused | ○ pending | ✓ complete | ⊘ blocked --- ### Current Focus **Area**: [from session.md] **Recent Work** ([date]): - [item 1 from session.md] - [item 2] - [item 3] **Next Steps** (from session.md): - [ ] [next step 1] - [ ] [next step 2] - [ ] [next step 3] --- ### Blockers & Open Questions | # | Blocker | Area | Severity | Since | |---|---------|------|----------|-------| | 1 | [description] | [area] | High | [date] | | 2 | [description] | [area] | Medium | [date] | *Or: "No active blockers"* --- ### Recent Decisions From progress.md (last 5): | Date | Decision | Rationale | |------|----------|-----------| | [date] | [decision] | [brief rationale] | *Or: "No recent decisions recorded"* --- ### Session History (Last 5) | Date | Duration | Focus | Key Accomplishments | |------|----------|-------|---------------------| | [date] | [Xh Ym] | [area] | [brief summary] | --- ### Suggested Actions Based on current state: | Condition | Suggestion | |-----------|------------| | No active session | → `/logwork start` to begin tracking | | Blockers exist | → `/clarify [blocker]` to resolve | | Stale session.md | → `/document` to update progress | | Ready to work | → Continue with: [next step] | | Need direction | → `/plan` to create/update plan |
Status Indicators
Work Area Status
| Symbol | Status | Meaning |
|---|---|---|
| ● | active | Currently being worked on |
| ◐ | paused | Started but temporarily stopped |
| ○ | pending | Not yet started |
| ✓ | complete | Finished |
| ⊘ | blocked | Cannot proceed |
Progress Bars (10 characters)
code
[░░░░░░░░░░] 0% [█░░░░░░░░░] 10% [██░░░░░░░░] 20% [███░░░░░░░] 30% [████░░░░░░] 40% [█████░░░░░] 50% [██████░░░░] 60% [███████░░░] 70% [████████░░] 80% [█████████░] 90% [██████████] 100%
Calculating Progress
Progress percentage is estimated from progress.md content:
- •Count completed items for each work area
- •Compare to total expected items (from plan or overview.md)
- •If no explicit tracking, estimate from milestone descriptions
Staleness Detection
Check how current the memory bank is:
| Staleness | Condition | Indicator |
|---|---|---|
| Fresh | Updated within 1 hour | ✓ Current |
| Recent | Updated within 4 hours | Updated [X]h ago |
| Stale | Updated more than 4 hours ago | ⚠ Updated [X]h ago |
| Very stale | Updated more than 24 hours ago | ⚠ Updated [X]d ago - consider /document |
Display staleness in header:
code
*Memory bank last updated: 2h ago (Recent)*
Information Sources
| Information | Source | Fallback |
|---|---|---|
| Project name | overview.md "Project Identity" | Directory name |
| Work areas | overview.md "Work Areas" table | "No work areas defined" |
| Current focus | session.md "Focus Area" | "Not specified" |
| Recent work | session.md "Recent Work" | "No recent work recorded" |
| Next steps | session.md "Next Steps" | "No next steps defined" |
| Blockers | session.md "Blockers" + progress.md | "None" |
| Decisions | progress.md "Decisions" sections | "No decisions recorded" |
| Time tracking | logs/log_index.yaml | "No time tracking data" |
Error Handling
Missing Memory Bank
If .claude/memorybank/ doesn't exist:
code
## Review Error Memory bank not found at `.claude/memorybank/`. Run `/onboard-claude` to initialize the memory bank for this project.
Partial Memory Bank
If some files are missing, show what's available:
code
## Partial Review ⚠ Some memory bank files are missing: - [x] overview.md - Found - [ ] progress.md - Missing - [x] session.md - Found Showing available information...
No Log Data
If logs/log_index.yaml doesn't exist or is empty:
code
### Time Tracking No time tracking data available. Run `/logwork start` to begin tracking.
Examples
Example 1: Full Review
code
User: /review Claude: 1. Reads all memory bank files 2. Finds: 3 work areas, 1 active, session running for 2h 3. Calculates progress percentages 4. Identifies 1 blocker 5. Shows full formatted review 6. Suggests: "Continue with [current task]"
Example 2: Brief Check
code
User: /review brief Claude: 1. Reads memory bank files 2. Outputs compact table 3. Shows one-line focus and blocker count 4. Suggests next action
Example 3: Time Focus
code
User: /review time Claude: 1. Reads log_index.yaml and recent log files 2. Calculates session statistics 3. Shows time breakdown by area 4. Shows recent session history
Skill Chaining
After review, suggest appropriate next action:
| State | Suggestion |
|---|---|
| No active session | /logwork start |
| Blockers present | /clarify [blocker] |
| Memory bank stale (>4h) | /document |
| No plan or outdated plan | /plan |
| Ready to continue | "Continue with: [next step from session.md]" |
Checklist
- • Parsed arguments to determine mode
- • Read all available memory bank files
- • Handled missing files gracefully
- • Calculated progress for each work area
- • Retrieved time tracking information
- • Detected memory bank staleness
- • Used consistent status indicators
- • Formatted output for selected mode
- • Suggested appropriate next action
- • Did NOT modify any files (read-only)