review
Quick status review across all modules (read-only)
SKILL.md
| Name | review |
| Description | Quick status review across all modules (read-only) |
name: review description: Quick status review across all modules (read-only)
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
## 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
## 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
## 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)
[░░░░░░░░░░] 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:
*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:
## 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:
## 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:
### Time Tracking
No time tracking data available. Run `/logwork start` to begin tracking.
Examples
Example 1: Full Review
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
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
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)