1---
2name: deferring-work-through-lunatask
3description: Captures findings, suggestions, and deferred work items in Lunatask with rich context for future sessions. Use when user says "we'll tackle this later", when you suggest improvements the user wants to defer, or when identifying issues to address separately.
4compatibility: Requires Lunatask MCP tools or CLI access
5license: AGPL-3.0-or-later
6metadata:
7 author: Amolith <amolith@secluded.site>
8---
9
10## Formatting
11
12### Title
13
14Titles must be:
15
16- Useful and concise
17- Conversational
18- Include the project name
19
20Example: `Implement FunctionSignature(Args) in go-lunatask`
21
22### Status
23
24New tasks usually get status `later`.
25
26### Note structure
27
28Use `[Title](lunatask://...)` syntax if deep links are needed.
29
30```markdown
31> [Warm, direct message to user—make them smile when they find this later]
32
33---
34
35Hello, future me! o/
36
37[Thorough description of the work: what needs doing, why it matters, relevant context discovered during the session]
38
39[Follow our slow and methodical planning approach: read relevant source code, documentation, and APIs before acting]
40
41When starting this task, update status according to workflow. When finished, mark `complete`.
42
43ID: PLACEHOLDER_ID
44```
45
46After creation, update the note to replace `PLACEHOLDER_ID` with the actual task ID from the creation response.
47
48### References trailer
49
50When user references external resources (issues, commits, PRs, tickets), append a `References:` section:
51
52```markdown
53References:
54
55- https://github.com/user/repo/issues/123
56- project-name/commit/abc123
57- project-name/todo/456
58```
59
60Prefer web links; fall back to `project-name/type/id` format.
61
62## Appending to existing notes
63
64Only append—never overwrite unless explicitly asked.
65
66Lunatask only supports full replacement, so reproduce the original note verbatim, then add:
67
68```markdown
69---
70
71[New content here]
72```
73
74Use well-formed markdown with proper whitespace between sections.
75
76## CLI fallback
77
78If `lunatask` or `lune` MCP tools are unavailable, see [cli.md](references/cli.md).