ln-302-task-replanner

Updates ALL task types (implementation/refactoring/test). Compares IDEAL plan vs existing tasks, categorizes KEEP/UPDATE/OBSOLETE/CREATE, applies changes in Linear and kanban.

⭐25stars🔀7forks📁View on GitHub🕐Updated Jan 10, 2026

When & Why to Use This Skill

The ln-302-task-replanner is a specialized Claude skill designed to automate the synchronization of project tasks with evolving requirements. It intelligently compares an 'IDEAL' project plan against existing task backlogs in Linear or local Markdown files, automatically categorizing actions into KEEP, UPDATE, OBSOLETE, or CREATE. By streamlining task lifecycle management for implementation, refactoring, and testing, it ensures that project boards and kanban files remain accurate, reducing manual administrative overhead for development teams.

Use Cases

  • Requirement Syncing: Automatically update a suite of Linear issues when the core project requirements change, ensuring developers are always working toward the latest functional scope.
  • Refactoring Workflow Automation: Identify obsolete code tasks and generate new refactoring plans with mandatory regression strategies and phase-based execution steps.
  • Hybrid Kanban Maintenance: Keep local documentation like `kanban_board.md` perfectly in sync with cloud-based project management tools (Linear) to maintain a single source of truth.
  • QA & Test Planning: Generate and manage a balanced distribution of E2E, Integration, and Unit test tasks based on risk-based limits and predefined quality templates.
nameln-302-task-replanner
descriptionUpdates ALL task types (implementation/refactoring/test). Compares IDEAL plan vs existing tasks, categorizes KEEP/UPDATE/OBSOLETE/CREATE, applies changes in Linear and kanban.

Universal Task Replanner

Worker that re-syncs existing tasks to the latest requirements for any task type.

Purpose & Scope

  • Load full existing task descriptions from Linear
  • Compare them with orchestrator-provided IDEAL plan (implementation/refactoring/test)
  • Decide operations (KEEP/UPDATE/OBSOLETE/CREATE) and execute
  • Drop NFR items; only functional scope remains
  • Update Linear issues and kanban_board.md accordingly

Task Storage Mode

Aspect Linear Mode File Mode
Load existing get_issue(task_id) per task Read("docs/tasks/epics/.../tasks/T{NNN}-*.md") per task
Update task update_issue(id, description) Edit task file content
Cancel task update_issue(id, state: "Canceled") Edit status to Canceled
Create new create_issue(parentId, state: "Backlog") Write new T{NNN}-{slug}.md

File Mode replan:

  1. Load existing task files via Glob
  2. Compare with IDEAL plan
  3. Edit/Write/Update files as needed
  4. Update kanban_board.md to reflect changes

Invocation (who/when)

  • ln-300-task-coordinator: REPLAN mode when implementation tasks already exist.
  • Orchestrators (other groups): Replan refactoring or test tasks as needed.
  • Not user-invoked directly.

Inputs

  • Common: taskType, teamId, Story data (id/title/description with AC, Technical Notes, Context), existingTaskIds.
  • Implementation: idealPlan (1-6 tasks), guideLinks.
  • Refactoring: codeQualityIssues, refactoringPlan, affectedComponents.
  • Test: manualTestResults, testPlan (E2E 2-5, Integration 0-8, Unit 0-15, Priority ≤15), infra/doc/cleanup items.

Template Loading

Templates: task_template_implementation.md, refactoring_task_template.md, test_task_template.md

Template Selection by taskType:

  • implementation → task_template_implementation.md
  • refactoring → refactoring_task_template.md
  • test → test_task_template.md

Loading Logic (for each template):

  1. Check if docs/templates/{template}.md exists in target project
  2. IF NOT EXISTS: a. Create docs/templates/ directory if missing b. Copy shared/templates/{template}.md → docs/templates/{template}.md c. Replace placeholders in the LOCAL copy:
    • {{TEAM_ID}} → from docs/tasks/kanban_board.md
    • {{DOCS_PATH}} → "docs" (standard)
  3. Use LOCAL copy (docs/templates/{template}.md) for all operations

Rationale: Templates are copied to target project on first use, ensuring:

  • Project independence (no dependency on skills repository)
  • Customization possible (project can modify local templates)
  • Placeholder replacement happens once at copy time

Workflow (concise)

  1. Load templates per taskType (see Template Loading) and fetch full existing task descriptions.
  2. Normalize both sides (IDEAL vs existing sections) and run replan algorithm to classify KEEP/UPDATE/OBSOLETE/CREATE.
  3. Present summary (counts, titles, key diffs). Confirmation required if running interactively.
  4. Execute operations in Linear: update descriptions, cancel obsolete, create missing with state="Backlog", preserve parentId for updates.
  5. Update kanban_board.md: remove canceled, add new tasks under Story in Backlog.
  6. Return operations summary with URLs and warnings.

Type Rules (must hold after update)

taskType Hard rule What to enforce
implementation No new test creation Updated/created tasks must not introduce test creation text
refactoring Regression strategy required Issues + severity, 3-phase plan, regression strategy, preserve functionality
test Risk-based limits Priority ≤15 scenarios; E2E 2-5, Integration 0-8, Unit 0-15, Total 10-28; no framework/library/DB tests

Critical Notes

  • MANDATORY: Always pass state: "Backlog" when creating new tasks (CREATE operation). Linear defaults to team's default status (often "Postponed") if not specified.
  • Foundation-First ordering from IDEAL plan is preserved; do not reorder.
  • Language preservation: keep existing task language (EN/RU).
  • No code snippets; keep to approach/steps/AC/components.
  • If Story reality differs (component exists, column exists), propose Story correction to orchestrator.

Definition of Done

  • Existing tasks loaded and parsed with correct template.
  • IDEAL plan vs existing compared; operations classified.
  • Type validation passed for all updated/created tasks.
  • Operations executed in Linear (updates, cancels, creations) with parentId intact.
  • kanban_board.md updated (Backlog) with correct Epic/Story/indentation.
  • Summary returned (KEEP/UPDATE/OBSOLETE/CREATE counts, URLs, warnings).

Reference Files

  • Templates (centralized): shared/templates/task_template_implementation.md, shared/templates/refactoring_task_template.md, shared/templates/test_task_template.md
  • Local copies: docs/templates/*.md (in target project)
  • Replan algorithm: references/replan_algorithm.md
  • Kanban format: docs/tasks/kanban_board.md

Version: 3.0.0 Last Updated: 2025-12-23