Manage work state, Linear issues, and task context across session boundaries. Use when updating current-task.md, tracking phase progress, logging decisions, or recovering from context compaction.
Load this skill when you need to:
Common triggers:
/task:start)/task:continue)/task:complete)| Asset |
|---|
| Location |
|---|
| Purpose |
|---|
| Survives |
|---|
| current-task.md | .claude/work/ | Project-level task state, Linear link | Everything (git) |
| Plan files | ~/.claude/plans/ | Detailed implementation steps | Compaction ✅ |
| Todos | ~/.claude/todos/ | Real-time session tracking | Compaction ✅ |
| Linear issue | Linear API | Source of truth for work items | External ✅ |
| Hook | When | Action |
|---|---|---|
| SessionStart | Session begins/resumes | Reminds to read current-task.md |
| PreCompact | Before compaction | Reminds to update current-task.md |
| git-commit-reminder | git commit | Quality checklist (tests, docs) |
Discovered → Refining → Approved → In Progress → In Review → Dev → Test → Live
│ │ │ │ │ │ │ │
backlog started unstarted started started ←── completed ──→
Phase mapping:
| Status | Type | AgentFlow Phase |
|---|---|---|
| Discovered | backlog | Discovery |
| Refining | started | Refinement |
| Approved | unstarted | Refinement complete, ready for delivery |
| In Progress | started | Delivery |
| In Review | started | Delivery (PR created) |
| Dev/Test/Live | completed | Deployed |
Command: /task:start <LINEAR-ID>
Actions:
.claude/work/current-task.mdTodoWrite tracks real-time progress (survives compaction).
Plan files capture detailed implementation steps:
~/.claude/plans/[random-name].mdcurrent-task.md maintains project-level state:
PreCompact hook reminds you to update current-task.md.
After compaction:
Command: /task:complete
Precondition: Work has been deployed (Linear status should already be "Live" via CI/CD automation).
Actions:
Note: /task:complete is for cleanup after deployment, not status changes. The status flow (In Review → Dev → Test → Live) is handled by CI/CD webhooks.
---
linear_issue: JCN-4
linear_url: https://linear.app/juncan/issue/JCN-4