ln-221-story-creator

SKILL.md

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

Story Creator

Type: L3 Worker
Category: 2XX Planning

Standalone-first worker for Story creation. It may be called directly or as part of a coordinator flow, but its public contract is the same in both cases.

MANDATORY READ

Load these before execution:

references/planning_worker_runtime_contract.md

references/coordinator_summary_contract.md

references/environment_state_contract.md

references/storage_mode_detection.md

references/creation_quality_checklist.md

references/template_loading_pattern.md

Inputs

Core inputs:

epicData

idealPlan or appendMode + newStoryDescription

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_TEMPLATE

PHASE_3_GENERATE_STORIES

PHASE_4_VALIDATE_STORIES

PHASE_5_CONFIRM_OR_AUTOAPPROVE

PHASE_6_APPLY_CREATE

PHASE_7_UPDATE_KANBAN

PHASE_8_WRITE_SUMMARY

PHASE_9_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-221

produced_at

payload

Payload fields:

mode

epic_id

stories_planned

stories_created

stories_updated

stories_canceled

story_urls

warnings

kanban_updated

research_path_used

If summaryArtifactPath is provided:

write the same JSON summary to that path

If 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-221--{identifier}.json

Workflow

Resolve task provider and Epic context if not already provided.

Load the Story template.

Generate Story documents with exactly the template sections.

Insert standards research into Technical Notes only.

Validate INVEST and AC limits before creation.

Show preview unless autoApprove=true.

Create Stories via the configured tracker provider.

Update kanban.

Write story-plan-worker summary.

Return structured summary.

Critical Rules

Keep exactly the template-defined Story structure.

Insert standards research into Technical Notes, not into ACs.

Reject Stories that fail INVEST or exceed AC limits.

STOP before tracker createStory: 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.

Remain standalone-capable.

Never require coordinator runtime state to operate.

Definition of Done

 Story template loaded and respected

 Story documents generated

 INVEST validation passed

 Stories created in provider-specific storage

 kanban updated

 Structured summary returned

 Summary artifact written when summaryArtifactPath is provided

Version: 3.0.0
Last Updated: 2025-12-23