story-planning

Generate TDD implementation plans from approved stories in the story-tree database.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Mharbulous/SyncoPaid --skill story-planning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-planning
Source: https://github.com/Mharbulous/SyncoPaid/tree/main/.claude/skills/story-planning
Command: npx skills add https://github.com/Mharbulous/SyncoPaid --skill story-planning

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill transforms approved user stories into zero-context, copy-paste-ready implementation plans with exact file paths and complete code examples, eliminating ambiguity and enabling seamless handoff to developers or AI.

Core Features & Use Cases

  • TDD Plan Generation: Creates detailed test-driven development plans with RED-GREEN-COMMIT cycles.
  • Zero-Context Design: Assumes implementer knows nothing about the codebase for maximum clarity.
  • Dependency Analysis: Scores and prioritizes stories based on complexity and readiness.
  • Codebase Research: Automatically studies existing patterns to ensure consistency.
  • Use Case: When you have an approved feature but need a detailed implementation guide, use this Skill to generate a step-by-step TDD plan that anyone (or any AI) can execute without questions.

Quick Start

Use the story-planning skill to create an implementation plan for the highest-priority approved story.

Frequently Asked Questions about story-planning

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a user story into a step-by-step implementation plan?

Story planning converts approved user stories into granular, executable implementation plans with exact file paths and complete code. It queries your story database, prioritizes by readiness, and generates 2-5 minute tasks structured for test-driven development without requiring context about your codebase.

What is test-driven development planning and when do I need it?

TDD planning breaks feature work into RED-GREEN-COMMIT cycles, starting with failing tests. Use it when you have an approved story but need detailed, unambiguous steps that any developer or AI can execute immediately without questions about your codebase structure.

Can I generate implementation plans that work with CI and interactive modes?

Yes. Story planning supports both CI and interactive execution modes, enforcing TDD cadence with zero-context assumptions and frequent commits. Plans include exact commands and file paths suitable for automated or manual handoff.

How does story planning prioritize which feature to implement first?

Story planning scores and prioritizes approved stories by dependency complexity and readiness depth, researching existing codebase patterns to ensure consistency. It surfaces the highest-priority story for immediate implementation planning.

What format do I need my stories in to use story planning?

Stories must be stored as approved nodes in a .claude/data/story-tree.db database. Story planning queries this SQLite database directly using Python sqlite3, eliminating ambiguity by generating zero-context, copy-paste-ready implementation guides with complete code examples.

Does story planning enforce any coding discipline or constraints?

Yes. Story planning enforces TDD cadence (RED-GREEN-COMMIT), DRY and YAGNI principles, and zero-context assumptions. It generates plans with frequent commits and precise commands, ensuring implementation stays focused and maintainable without assumptions about prior knowledge.