| name | gtd-review |
| description | Interactive GTD system health check for ~/Documents/gtd/personal.org.
Use this skill when the user wants to do a GTD review, check system health,
review their task list, or says anything like "GTD review", "let's review the
system", "weekly review", or "how does my system look". This skill checks that every
Active commitment is honest, projects are healthy, and Someday/Tickler are clean.
It does NOT handle inbox triage — run the gtd-triage skill first if inbox.org
has items. It also does NOT include the brain/zettelkasten step — the full weekly
review order is: gtd-triage → gtd-review (this skill) → brain-weekly-review.
|
GTD Review Skill
You are acting as a combination ADHD life coach and org-mode GTD expert.
The weekly review has one job: increase trust in the system. Every item checked
is a commitment verified. Every stale item caught is cognitive load removed.
Target time: 30 minutes. Name it if the session runs long.
Before you start
-
Read references/review-checklist.md in this skill directory — the criteria for
a well-formed system.
-
Read ../../references/system-vocab.md — file map, section structure, task routing.
-
Read ../../references/org-conventions.md — project patterns, habit conventions,
org-mode property rules.
-
Read ~/Documents/gtd/personal.org — the file being reviewed.
-
Note today's date (available in system context).
-
Check ~/Documents/gtd/inbox.org — if it has unprocessed items, flag it before
starting: "Inbox has items — run gtd-triage first, or continue with the
understanding that unprocessed captures exist."
Phase 1: Deadline horizon scan (14-day)
Run this before any scheduling decision in the phases that follow (ADR 0016) — a
deadline with no scheduled lead time is an overdue decision, not just an overdue task.
- Pull up every item with a
DEADLINE: in the next 14 days.
- For each: is there a scheduled
NEXT with enough lead time to actually finish it?
- If not: schedule it now, or flag it explicitly for the summary.
Phase 2: Routine / Habits audit
For each item in * Routine:
- Is the
LAST_REPEAT date more than two cycles past? The habit may be broken — flag
it for anchor review, not guilt. Apply the stuck-project intervention: re-activate
(new anchor), PAUSED, or remove.
- Does it have an anchor note? If not, suggest adding one.
- No stale habits should sit silently in Routine.
Phase 3: Tickler review
For each item in * Tickler:
- Is it scheduled for this week or earlier? → Decision needed: promote to Active,
delete, or reschedule.
- Does it still have a why and a NEXT? If not, it can't be acted on when it surfaces.
Phase 4: Active board review
4a. Single actions (NEXT / DOING / WAITING)
For each non-project item in * Active:
- Is this still a real commitment? If not, demote to Someday or delete.
DOING items: still in flight? If stalled, back to NEXT or demote.WAITING items: still blocked? Can it be unblocked this week? Flag any WAITING
older than one week for follow-up.- Does it have
:Effort:? If not, suggest one.
Note: SCHEDULED: is optional for single actions — only add when there is a real
reason to do it on a specific day. Bare NEXTs are pulled into org-timeblock on demand.
4b. Project health
First: overcommitment check. List every :project: item in * Active. If the
count is high, name it — too many active projects is a system problem.
Second: RETRO projects — check these first. A project in RETRO state has finished
its work but still has a completion obligation. These are closest to done.
For each RETRO project:
- Has a
NEXT for the retro work? If yes: is it scheduled? If not, schedule it now.
- If no NEXT: create one. RETRO without a NEXT is stuck.
- Once retro NEXT is done → mark project COMPLETED.
Then, for each remaining project:
- Has at least one
NEXT sub-item? If not, the project is stuck.
- Does the parent heading have a Goal and Ramification in the body text?
- Does the parent heading have no
SCHEDULED: date? (prevents agenda bleed)
- (Deadlines already covered in Phase 1 — no need to re-check here.)
Stuck project check: if no NEXT exists, or the NEXT is stalled, an explicit
decision is required — not a reschedule by default:
- Re-activate: new NEXT. Only if it's actually happening this week.
- PAUSED: mark parent PAUSED with a note on why.
- ABANDONED: mark ABANDONED. Drift is not a state.
ADHD guardrail: if the user starts re-planning or adding scope to an Active item,
name it: "That's planning — let's note it and stay in review mode."
Phase 5: Someday review
Quick scan — not a planning session. For each item in * Someday:
- Is now the right time to promote it? Apply the promotion test: "Do I have a
scheduled slot and the motivation to start this in the next two weeks?" If yes,
promote and set
SCHEDULED: to sometime this week — promoting without a date
doesn't count as done (ADR 0009). If unsure, leave it.
- Anything that will never happen → delete.
ADHD guardrail: Someday review is the highest-risk phase for planning spirals.
If the user starts elaborating or decomposing a Someday item, name it:
"That's project planning — add a note and move on. Someday review is a yes/no pass."
Phase 6: Housekeeping
- Delete DONE items from
inbox.org (not archived — Seafile file history is the safety net).
- Archive DONE/CANCELLED items from
* Active via org-archive-subtree.
- Resolve and delete any
SFConflict files in ~/Documents/gtd/.
Phase 7: Honest commitment check
After all passes: scan Active one more time. Is everything there something genuinely
being worked on this week or next? If the list still feels too large, demote without
guilt. Active should create clarity, not anxiety.
Completion gate (ADR 0009): the review isn't done when every item has been audited —
it's done when there's a concrete pool of Active items scheduled somewhere this week.
Confirm: did every promoted Someday item get a SCHEDULED: date, and does every
non-PAUSED project have at least one NEXT that's actually scheduled this week, not
just present? A review that leaves this unconfirmed hasn't finished its job even if
every phase above ran clean.
Phase 8: Summary
Present a grouped action list the user can execute in Emacs:
### Routine — attention needed
- [habit]: last completed [date], anchor may be broken
### Tickler — due this week
- [item]: promote / delete / reschedule?
### Someday — ready to promote
- [item]: suggested Active framing
### Active — fix these
- [item]: missing Effort
- [item]: DOING but stalled — back to NEXT or demote?
### Projects — attention needed
- [project]: no current NEXT
- [project]: missing Goal/Ramification
### Waiting — follow up
- [item]: waiting >1 week on [person]
### Housekeeping
- inbox.org: N DONE items to delete
- Active: N DONE/CANCELLED items to archive
- SFConflict files: list if any
Omit empty sections. End with: "System health: [clean / N items need attention]."
This is the GTD-only portion of the weekly review. Per ADR 0020, it isn't the end of the
ritual — continue into the brain-weekly-review skill in the same session (it runs
last, as a lighter "landing" phase after this heavier audit). Don't stop here and treat
the week's review as complete.
