| name | review |
| description | Generate weekly or monthly review reports. Analyzes log.jsonl, actions progress, and knowledge growth. Use when the user wants a periodic review. |
/review
Run periodic reviews to reflect on progress and plan ahead.
Usage
/review weekly — generate a weekly review/review monthly — generate a monthly review
Weekly Review
Step 1: Gather data
Read log.jsonl and filter for entries from the past 7 days.
Step 2: Analyze
Calculate:
- Inbox: current backlog count (files in
inbox/)
- Ingested: count of ingest operations this week
- Actions completed: count of items checked off in
wiki/actions/ this week (check git log for changes to action files)
- Actions added: new items added to action files this week
- Actions deferred: items moved to
someday.md this week
- Pages created: new wiki pages this week (from log.jsonl
created fields)
- Pages updated: modified wiki pages this week (from log.jsonl
updated fields)
Step 3: Generate report
Create wiki/reviews/weekly/YYYY-WNN.md:
---
type: review
title: "Weekly Review YYYY-WNN"
tags: [review, weekly]
sources: []
related: []
created: YYYY-MM-DD
updated: YYYY-MM-DD
---
Report sections:
- Summary — one paragraph overview of the week
- Inbox — backlog count, any stale items (older than 7 days)
- Actions — completed, added, deferred counts with details
- Knowledge Growth — new pages, updated pages, notable new connections
- Focus Suggestions — recommended priorities for next week based on patterns
Step 4: Update indexes
Update wiki/index.md Recent Activity section.
Step 5: Log
{"ts":"<now>","op":"review","title":"Weekly Review YYYY-WNN","report":"wiki/reviews/weekly/YYYY-WNN.md","stats":{"inbox_backlog":N,"ingested":N,"actions_completed":N,"actions_added":N,"pages_created":N,"pages_updated":N}}
Step 6: Git commit
git add wiki/reviews/weekly/YYYY-WNN.md wiki/index.md log.jsonl
git commit -m "[review] weekly YYYY-WNN
- created: wiki/reviews/weekly/YYYY-WNN.md
- updated: wiki/index.md"
Monthly Review
Step 1: Gather data
Read log.jsonl for the past 30 days. Also read all weekly reviews from this month.
Step 2: Analyze
Calculate everything in weekly review, plus:
- Knowledge growth trends — compare page counts week over week
- PARA archival candidates — projects in
raw/projects/ with no recent ingest activity (>30 days)
- Long-term patterns — most active topics, emerging themes
- Knowledge gaps — topics referenced but with thin wiki coverage
Step 3: Generate report
Create wiki/reviews/monthly/YYYY-MM.md:
---
type: review
title: "Monthly Review YYYY-MM"
tags: [review, monthly]
sources: []
related: []
created: YYYY-MM-DD
updated: YYYY-MM-DD
---
Report sections:
- Summary — one paragraph overview of the month
- Knowledge Growth — trends, new themes, page count progression
- Actions Overview — completion rate, chronic deferrals, stale items
- PARA Health — archival suggestions, areas needing attention
- Gaps & Opportunities — thin areas worth researching, promising connections to explore
Step 4: Apply PARA maintenance
For each archival candidate:
- Move the project directory from
raw/projects/ to raw/archives/
- Update any wiki pages that reference the moved paths
Step 5: Update indexes and log
Same as weekly review steps 4-5, with monthly in the log entry.
Step 6: Git commit
git add wiki/reviews/monthly/YYYY-MM.md wiki/index.md raw/ log.jsonl
git commit -m "[review] monthly YYYY-MM
- created: wiki/reviews/monthly/YYYY-MM.md
- updated: wiki/index.md
- moved: raw/projects/done-project/ → raw/archives/done-project/"
