ln-302-task-replanner

What this skill does

> **Paths:** File paths (`references/`, `../ln-*`) are relative to this skill directory.

# Task Replanner

**Type:** L3 Worker
**Category:** 3XX Planning

Standalone-first worker for task replanning. It compares the ideal task plan with existing tasks and applies the required operations.

**MANDATORY READ:** Load `references/coordinator_summary_contract.md` and `references/task_plan_worker_runtime_contract.md`
**MANDATORY READ:** Load `references/environment_state_contract.md`, `references/storage_mode_detection.md`, `references/template_loading_pattern.md`, and `references/destructive_operation_safety.md`
**MANDATORY READ:** Load `references/replan_algorithm.md`

## Inputs

Core inputs:
- `storyId`
- `taskType`
- `storyData`
- `existingTaskIds`
- `idealPlan`
- `teamId`

Transport inputs:
- standalone: omit `runId` and `summaryArtifactPath`
- managed: pass both `runId` and `summaryArtifactPath`

## Runtime

Runtime family: `task-plan-worker-runtime`

Phase profile:
1. `PHASE_0_CONFIG`
2. `PHASE_1_LOAD_INPUTS`
3. `PHASE_2_LOAD_EXISTING_TASKS`
4. `PHASE_3_NORMALIZE_AND_CLASSIFY`
5. `PHASE_4_CONFIRM_OR_AUTOAPPROVE`
6. `PHASE_5_APPLY_REPLAN`
7. `PHASE_6_UPDATE_KANBAN`
8. `PHASE_7_WRITE_SUMMARY`
9. `PHASE_8_SELF_CHECK`

Summary artifact rules:
- emit `summary_kind=task-plan`
- standalone runs generate their own `run_id` and write the default worker-family artifact path
- managed runs require both `runId` and `summaryArtifactPath` and must write the summary to the exact provided path
- always write the validated summary artifact before terminal outcome

## Output Contract

Always build a structured `task-plan` summary envelope per:
- `references/coordinator_summary_contract.md`
- `references/task_plan_worker_runtime_contract.md`

Payload fields:
- `mode`
- `story_id`
- `task_type`
- `tasks_created`
- `tasks_updated`
- `tasks_canceled`
- `task_urls`
- `kanban_updated`
- `dry_warnings_count`
- `warnings`

Always write the validated summary before terminal outcome.

## Workflow

1. Resolve Story context if needed.
2. Load existing tasks.
3. Normalize ideal vs existing task structures.
4. Classify `KEEP`, `UPDATE`, `OBSOLETE`, `CREATE`.
5. If classification is empty, emit a verified no-op summary and stop.
6. Show summary if interactive.
7. Execute provider-specific updates.
8. Update kanban only when provider mutations occurred.
9. Return structured summary.

## Critical Rules

- Remain standalone-capable.
- Do not require coordinator runtime state.
- Preserve type-specific rules after replanning.
- Return machine-readable output every time.
- **Fast path for no-op replans:** when no task changes survive normalization, do not mutate provider state or kanban; return a summary with zero changes.
- **STOP before tracker createTask/updateBody:** verify all 7 sections present in body: Context, Implementation Plan, Technical Approach, Acceptance Criteria, Affected Components, Existing Code Impact, Definition of Done. PreToolUse hook will BLOCK creation without them.

## Definition of Done

- [ ] Existing tasks loaded and compared
- [ ] Replan operations classified
- [ ] Updates, cancellations, and creations executed
- [ ] kanban updated
- [ ] Structured summary returned
- [ ] Summary artifact written to the managed or standalone runtime path

---
**Version:** 3.0.0
**Last Updated:** 2025-12-23