aibdd-implement

Convert tasks.md checkboxes into TodoWrite items and synchronize completion state.

77|15|Updated May 12, 2026
One-click install
npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill aibdd-implement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aibdd-implement
Source: https://github.com/Waterball-Software-Academy/aixbdd/tree/main/.agents/skills/aibdd-implement
Command: npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill aibdd-implement

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents AI-assisted execution from drifting away from the written truth in tasks.md by enforcing one-to-one checkbox execution, while keeping TodoWrite state and the source checklist synchronized in lockstep.

Core Features & Use Cases

  • Deterministic checkbox-to-todo execution: converts every markdown checkbox line in tasks.md into exactly one live TodoWrite todo item, preserving structure and order.
  • Boundary-aware progress tracking: executes leaf checkboxes one at a time, judges completion against the checkbox text, and immediately marks the corresponding checkbox as done in tasks.md.
  • Parent completion correctness: only marks parent items complete after all descendant checkboxes are completed, with explicit synchronization invariants to catch drift.
  • Use Case: when you have an AIBDD-generated tasks.md and want an agent to implement it without accidentally skipping, merging, or advancing broader work than the current checkbox.

Quick Start

Use the aibdd-implement skill to execute the target tasks.md by providing the path to the tasks.md that contains the checkbox checklist to run.

Frequently Asked Questions about aibdd-implement

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

FAQPage Schema
How do I execute a markdown checklist without skipping or merging steps?

Executing a markdown checklist without skipping steps requires converting each checkbox into a single TodoWrite item and synchronizing state in lockstep. The aibdd-implement approach enforces one-to-one checkbox execution to prevent drift from the source tasks.md file.

How does TodoWrite state synchronization work for nested task checklists?

TodoWrite state synchronization works by marking leaf checkboxes complete one at a time and immediately updating tasks.md. Parent items are only marked complete after all descendant checkboxes finish, enforcing invariants that completed todo items match checked markdown boxes.

Can I track acceptance criteria progress using markdown checkboxes?

Tracking acceptance criteria progress with markdown checkboxes is supported by turning each checkbox line into a live todo item. This boundary-aware progress tracking judges completion against the checkbox text and immediately marks the corresponding markdown box as done.

What is the best way to automate ordered task execution from a markdown file?

Automating ordered task execution from a markdown file is best handled by deterministic checkbox-to-todo conversion. This preserves the structure and order of parent and child dependencies, ensuring no parent task completes before its descendants are fully satisfied.

Why do my AI agent implementation tasks drift away from the original checklist?

AI agent implementation tasks drift when execution is not grounded in the written checklist. Enforcing one-to-one checkbox execution with immediate tasks.md updates after each checkbox is judged satisfied prevents the agent from advancing broader work than the current step.

Do I need an AIBDD-generated tasks.md to run checklist execution?

Checklist execution applies to any tasks.md representing acceptance-grounded work broken into ordered, checkbox-level steps. While designed for AIBDD-generated files, it works with any markdown checklist containing parent and child checkbox dependencies.