gtd

Files (28)

• DESIGN.md
• SKILL.md
• TODO.md
• beads.md · docs/backends/
• clarify-decision-tree.md · references/
• clarify-flowchart.md · references/
• common-mistakes.md · references/
• complementary-skills.md · references/
• daily-review.md · references/
• migrate-github-to-beads.sh · references/examples/
• github-limitations.md · references/
• gtd-workflow.md · references/
• horizons.md · references/
• label-taxonomy.md · references/
• quarterly-review.md · references/
• weekly-review.md · references/
• yearly-review.md · references/
• gtd · scripts/
• __init__.py · scripts/gtdlib/
• __init__.py · scripts/gtdlib/backends/
• beads.py · scripts/gtdlib/backends/
• github.py · scripts/gtdlib/backends/
• taskwarrior.py · scripts/gtdlib/backends/
• config.py · scripts/gtdlib/
• history.py · scripts/gtdlib/
• metadata.py · scripts/gtdlib/
• reviews.py · scripts/gtdlib/
• storage.py · scripts/gtdlib/

SKILL.md (first lines)

<essential_principles>

## GTD Core Workflow

1. **Capture** - Get it out of your head into the system
2. **Clarify** - Is it actionable? What's the next action?
3. **Organize** - Add context, energy, status, horizon labels
4. **Reflect** - Daily/weekly/quarterly/yearly reviews keep system trusted
5. **Engage** - Work from filtered lists, not full backlog

## Running the CLI

All GTD operations go through the `gtd` CLI.

The `gtd` script is at `scripts/gtd` **relative to this SKILL.md file** (not the working directory).
Derive the absolute script path from this file's location:

- If this SKILL.md is at `/path/to/gtd/SKILL.md`
- Then the CLI is at `/path/to/gtd/scripts/gtd`

```bash
# Derive path from SKILL.md location, then run:
scripts/gtd <command>
```

**Setup is automatic**: The CLI will detect if labels are missing and create them on first use.

## Label Taxonomy (12 Fixed Labels)

Never create new labels. See [label-taxonomy.md](references/label-taxonomy.md).

- **Context**: focus, meetings, async, offsite (where/when)
- **Energy**: high, low (cognitive load)
- **Status**: active, waiting, someday (workflow state)
- **Horizon**: action, project, goal (GTD altitude)

## GTD Horizons of Focus

The system supports David Allen's 6 Horizons:

| Horizon | Name | Implementation |
|---------|------|----------------|
| Ground | Actions | `horizon/action` label via gtd CLI |
| H1 | Projects | `horizon/project` label + project grouping |
| H2 | Areas of Focus | Ongoing responsibilities without end dates |
| H3 | Goals | `horizon/goal` label via gtd CLI |
| H4 | Vision | `HORIZONS.md` at vault root |
| H5 | Purpose | `HORIZONS.md` at vault root |

**Setup:** Copy the template to your vault root:

```bash
cp references/horizons.md HORIZONS.md  # path relative to this SKILL.md
```

</essential_principles>

<intake>
What would you like to do?

1. Capture something new
2. Process inbox (clarify items)
3. Find tasks to work on
4. Do a review (daily/weekly/quarterly/yearly)
5. Manage projects

**Wait for response before proceeding.**
</intake>

<routing>

| Response | Command |
|----------|---------|
| 1, "capture", "add something" | `scripts/gtd capture "<text>"` |
| 2, "inbox", "process", "clarify" | `scripts/gtd inbox` then `scripts/gtd clarify <id>` |
| 3, "list", "find", "work", "tasks" | `scripts/gtd list --status active --context <context>` |
| 4a, "daily review" | `scripts/gtd daily` |
| 4b, "weekly review" | `scripts/gtd weekly` |
| 4c, "quarterly review" | `scripts/gtd quarterly` |
| 4d, "yearly review" | `scripts/gtd yearly` |
| 4e, "review status", "when did I" | `scripts/gtd reviews` |
| 5, "projects" | `scripts/gtd projects` or `scripts/gtd project list` |
| 5a, "create project" | `scripts/gtd project create "<title>"` |
| 5b, "show project", "project details" | `scripts/gtd project show "<title>"` |
| 5c, "delete project" | `scripts/gtd project delete "<title>"` |

**After determining intent, execute commands using `scripts/gtd` (path relative to this SKILL.md).**
</routing>

<quick_start>

```bash
# Derive GTD path from this SKILL.md location
GTD="scripts/gtd"

# Capture something (goes to inbox)
$GTD capture "Review PR for plugin architecture"

# See what needs clarifying
$GTD inbox

# Clarify an item (interactive)
$GTD clarify 42

# Add a pre-clarified action
$GTD add "Write RFE draft" --context focus --energy high --status active

# Add a project
$GTD add "Promotion to Senior Principal" --horizon project

# Add an action to a project
$GTD add "Schedule skip-level with director" --horizon action --project "Promotion to Senior Principal"

# Add a yearly goal
$GTD add "2026: Improve fitness" --horizon goal

# Find morning focus work
$GTD list --context focus --energy high --status active

From durandom/skills, GPL-3.0.

More from durandom/skills