From d3fc5464c7321be14134015abc50b89141110cc5 Mon Sep 17 00:00:00 2001 From: Amolith Date: Sat, 3 Jan 2026 14:45:36 -0700 Subject: [PATCH] feat(lunatask): add tech debt surfacing guidance Assisted-by: Claude Opus 4.5 via Crush --- skills/creating-tasks-through-lunatask/SKILL.md | 9 +++++++++ skills/resuming-work-through-lunatask/SKILL.md | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/skills/creating-tasks-through-lunatask/SKILL.md b/skills/creating-tasks-through-lunatask/SKILL.md index 122b83cc73f2672da99fab2e0a6767379e4c347f..379d8494e15d4504c5d7526e1b101d54209e1443 100644 --- a/skills/creating-tasks-through-lunatask/SKILL.md +++ b/skills/creating-tasks-through-lunatask/SKILL.md @@ -77,6 +77,15 @@ Lunatask only supports full replacement, so reproduce the original note verbatim [New content here] ``` +## Surfacing tech debt + +While 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; ask the user whether you should mention them. + +If the user confirms and it's/they're + +- **relevant to the handoff**: mention briefly in context section so the receiving agent is aware +- **worth tracking separately**: suggest capturing 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. + --- If `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). diff --git a/skills/resuming-work-through-lunatask/SKILL.md b/skills/resuming-work-through-lunatask/SKILL.md index 1eb8f59e15fdb429f36aa3b732edb42df7bdd8bb..61123ddf6422ddb597109daf2a8414cec215bd16 100644 --- a/skills/resuming-work-through-lunatask/SKILL.md +++ b/skills/resuming-work-through-lunatask/SKILL.md @@ -27,6 +27,15 @@ If you find significant differences between what the handoff describes and what Don't try to reconcile the handoff with reality on your own. The user may have context about why things changed. +## Surfacing tech debt + +While 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. + +- Mention them briefly to the user before or after completing the main work +- 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. + +Don't derail the primary task, but don't let useful observations vanish either. + ## Workflow When you begin working on the task, update its status according to the area's workflow. When finished, mark it `complete`.