Claude-code-skills ln-222-story-replanner

Replans Stories by comparing IDEAL vs existing (KEEP/UPDATE/OBSOLETE/CREATE). Use when Epic requirements changed and Stories need realignment.

install

source · Clone the upstream repo

git clone https://github.com/levnikolaevich/claude-code-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/levnikolaevich/claude-code-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills-catalog/ln-222-story-replanner" ~/.claude/skills/levnikolaevich-claude-code-skills-ln-222-story-replanner && rm -rf "$T"

manifest: skills-catalog/ln-222-story-replanner/SKILL.md

source content

Paths: File paths (
shared/
,
references/
,
../ln-*
) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root.

Story Replanner

Type: L3 Worker Category: 2XX Planning

Standalone-first worker for Story replanning. It compares ideal Story intent with existing Stories and applies the resulting operations.

MANDATORY READ

Load these before execution:

shared/references/planning_worker_runtime_contract.md

shared/references/coordinator_summary_contract.md

shared/references/environment_state_contract.md

shared/references/storage_mode_detection.md

shared/references/template_loading_pattern.md

```
references/replan_algorithm_stories.md
```

Inputs

Core inputs:

```
epicData
```
```
idealPlan
```
```
existingStoryIds
```
```
standardsResearch
```
```
teamId
```
```
autoApprove
```

Optional transport inputs:

```
runId
```
```
summaryArtifactPath
```

The worker must remain fully usable without caller-provided

runId

and without

summaryArtifactPath

. In standalone mode it generates its own

run_id

before emitting the summary envelope.

Runtime

Runtime family:

planning-worker-runtime

Identifier:

```
epic-{epicId}
```

Phases:

```
PHASE_0_CONFIG
```
```
PHASE_1_RESOLVE_CONTEXT
```
```
PHASE_2_LOAD_EXISTING_STORIES
```
```
PHASE_3_CLASSIFY_REPLAN
```
```
PHASE_4_CONFIRM_OR_AUTOAPPROVE
```
```
PHASE_5_APPLY_REPLAN
```
```
PHASE_6_UPDATE_KANBAN
```
```
PHASE_7_WRITE_SUMMARY
```
```
PHASE_8_SELF_CHECK
```

Managed child-run mode:

caller starts the runtime with
```
--run-id
```
and
```
--summary-artifact-path
```
runtime writes the final summary artifact directly to the caller-provided path
parent coordinator records the resulting
```
story-plan-worker
```
artifact

Standalone mode:

runtime generates its own
```
run_id
```
runtime still returns the same structured summary envelope
artifact writing is optional unless
```
summaryArtifactPath
```
is provided

Output Contract

Always build a structured summary envelope:

```
schema_version
```
```
summary_kind=story-plan-worker
```
```
run_id
```
```
identifier
```
```
producer_skill=ln-222
```
```
produced_at
```
```
payload
```

Payload fields:

```
mode
```
```
epic_id
```
```
stories_planned
```
```
stories_created
```
```
stories_updated
```
```
stories_canceled
```
```
story_urls
```
```
warnings
```
```
kanban_updated
```
```
research_path_used
```

summaryArtifactPath

is provided:

write the same JSON summary to that path

summaryArtifactPath

is not provided:

return the same summary in structured output only

Managed artifact path pattern:

.hex-skills/runtime-artifacts/runs/{parent_run_id}/story-plan-worker/ln-222--{identifier}.json

Workflow

Resolve Epic context if not already provided.
Load existing Stories one by one.
Normalize ideal vs existing Story structures.
Run the replan algorithm to classify
```
KEEP
```
,
```
UPDATE
```
,
```
OBSOLETE
```
,
```
CREATE
```
.
Show operations summary unless
```
autoApprove=true
```
.
Execute provider-specific updates.
Update kanban.
Return structured summary.

Critical Rules

Prefer conservative updates when matching is ambiguous.
Preserve finished work when replanning conflicts with completed Stories.
Keep the worker standalone-capable.
Never require coordinator runtime state to operate.
Return machine-readable results, not prose-only outcomes.
STOP before save_issue: verify all 9 sections present in body: Story, Context, Acceptance Criteria, Implementation Tasks, Test Strategy, Technical Notes, Definition of Done, Dependencies, Assumptions. PreToolUse hook will BLOCK creation without them.

Definition of Done

Existing Stories loaded and normalized
Replan algorithm applied
Required updates, cancellations, and creations executed
kanban updated
Structured summary returned
Summary artifact written when
```
summaryArtifactPath
```
is provided

Version: 3.0.0 Last Updated: 2025-12-23