1---
2name: resuming-work-through-lunatask
3description: Resumes previously deferred work from Lunatask. Use when user pastes a task note, shares a lunatask:// deep link, says "let's pick this up", or references continuing earlier work.
4compatibility: Requires Lunatask MCP or CLI tools
5license: GPL-3.0-or-later
6metadata:
7 author: Amolith <amolith@secluded.site>
8---
9
10## Purpose
11
12Handoff notes are **navigation aids**, not solutions. They point you toward relevant code and context, but the codebase may have changed since the handoff was written. Your job is to explore the current state and form your own understanding.
13
14## Before acting
15
161. Read the actual files: entry points in the handoff tell you where to look, but always read the current source. Any code snippets in the handoff may be stale.
172. Verify the plan still applies: check that the goal is still relevant and the suggested approach still makes sense given the current code.
183. If present, follow the references: external links, commits, and docs in the handoff were included for a reason. Skim them for context.
19
20## If the code has diverged
21
22If you find significant differences between what the handoff describes and what the code actually looks like:
23
24- Stop
25- Summarize what changed
26- Wait for user input before proceeding
27
28Don't try to reconcile the handoff with reality on your own. The user may have context about why things changed.
29
30## Surfacing tech debt
31
32While working, you may notice code smells, outdated patterns, missing tests, or other improvement opportunities related _or unrelated_ to the current task. We might also intentionally introduce tech debt, aware of the trade-offs. Don't let these observations or introductions disappear with the session.
33
34- Mention them briefly to the user before or after completing the main work
35- Offer to capture them as standalone task(s) so the user can pick up or hand off to another agent later. Even as standalone tasks, make sure to include enough context that another agent could pick it up.
36
37Don't derail the primary task, but don't let useful observations vanish either.
38
39## Workflow
40
41When you begin working on the task, update its status according to the area's workflow. When finished, mark it `completed`.
42
43New tasks usually get status `later`, then `in-progress`, then lastly `completed`. Different workflows might have other stages, but those are core.
44
45## Working around a Lunatask bug
46
47At the very very end of task notes or note contents, include `[editor_v2]::` on its own line.
48
49---
50
51If `lunatask` or `lune` MCP tools are unavailable, see [cli.md](references/cli.md). If the CLI is also unavailable, see [installing-lune.md](references/installing-lune.md).