complete-stories

Automate Scrum story completion in markdown with strict validation gates.

5|1|Updated Sep 23, 2025
One-click install
npx skills add https://github.com/RDEWAI/Redefining-DataEngineering-With-AI --skill complete-stories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complete-stories
Source: https://github.com/RDEWAI/Redefining-DataEngineering-With-AI/tree/main/chapter-6/developer-plugin/skills/complete-stories
Command: npx skills add https://github.com/RDEWAI/Redefining-DataEngineering-With-AI --skill complete-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually tracking Scrum story completion often leads to marking work as Done prematurely, with unchecked acceptance criteria, incomplete dependencies, or missing deliverables going unnoticed. This Skill eliminates that risk by enforcing strict, atomic validation gates before any edits are made.

Core Features & Use Cases

  • Strict Atomic Gate: Blocks story completion if any acceptance criteria is unchecked, any dependent story is incomplete, any referenced deliverable is missing, or any automated verifier fails, ensuring no partial or incorrect Done statuses.
  • Automatic Status Rollup: Once a story is marked Done, automatically updates its parent epic's status if all child stories are complete, and updates the backlog status if all epics are Done.
  • Dual Gating Support: Works with both modern plan-validated stories (gated on plan status and task completion) and legacy markdown stories (gated on AC checkboxes and deliverable presence).
  • Use Case: For Agile teams using markdown-based story tracking, use this Skill to safely mark stories Done without missing incomplete work, and automatically propagate status up to epics and backlogs when all child items are finished.

Quick Start

Use the complete-stories skill to mark STORY-02-004 as Done and automatically roll up its parent epic and backlog status.

Frequently Asked Questions about complete-stories

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

FAQPage Schema
How do I prevent incomplete Scrum stories from being marked as Done?

To prevent incomplete Scrum stories from being marked as Done, use strict gate validation that blocks completion if acceptance criteria are unchecked, dependencies are incomplete, deliverables are missing, or automated verifiers fail. This atomic approach ensures no partial work receives a Done status.

Can I automatically roll up story status to epics and backlogs in markdown?

Yes, you can automatically roll up story status to epics and backlogs in markdown. When a story is marked Done, the parent epic status updates if all child stories are complete, and the backlog status updates when all epics are finished.

Does gate validation work with legacy markdown stories and checkbox acceptance criteria?

Gate validation works with both legacy markdown stories gated on acceptance criteria checkboxes and deliverable presence, and modern plan-validated stories gated on plan status and task completion, ensuring broad coverage across different markdown tracking formats.

How do I automate Scrum story completion safely without side effects?

Automate Scrum story completion safely by running atomic, side-effect-free completion workflows that only apply edits when all gate conditions pass. If any acceptance criteria, dependencies, deliverables, or verifiers fail, the process blocks and leaves files unchanged.

What happens if a referenced deliverable is missing during story completion?

If a referenced deliverable is missing during story completion, the strict validation gate blocks the process and prevents the story from being marked Done. The atomic workflow ensures no edits are applied until all missing deliverables are resolved.

When do I need strict gate validation for Agile story tracking?

You need strict gate validation for Agile story tracking when manually marking work as Done risks overlooking unchecked acceptance criteria, incomplete dependencies, or missing deliverables. It enforces atomic completion runs that block on failed automated verifiers to ensure quality.