aibdd-plan

Transform AIBDD discovery truth into operation contracts, state schemas, and design diagrams.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

AIBDD Plan converts raw product intent and discovery truth into a boundary-aware, acceptance-driven implementation plan so agents stop guessing and start producing verifiable artifacts.

Core Features & Use Cases

  • Strict boundary-aware planning SOP: Enforces CWD-anchored artifact output and a hard artifact write contract to prevent spec drift.
  • Contracts & state delegation by specifier skills: Derives operation contracts and state targets via delegated specifier skills instead of hand-authoring formats.
  • Implementation-ready design artifacts: Generates sequence diagrams and a unified class diagram skeleton for downstream tasking and DSL synthesis.
  • Safety against missing truth: Delegates structured clarification to /clarify-loop when upstream discovery is insufficient.

Quick Start

Run the aibdd-plan skill to produce implementation sequence diagrams and a class diagram design skeleton from your existing AIBDD discovery artifacts, then proceed to the next phase for feature test scenario enumeration.

Frequently Asked Questions about aibdd-plan

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

FAQPage Schema
How do I generate sequence diagrams and class diagrams from acceptance criteria?

Sequence diagrams and class diagrams are generated by transforming accepted AIBDD discovery truth into a boundary-aware implementation design model. This process derives operation contracts and state schemas to produce implementation-ready design artifacts for downstream tasking.

What is boundary-aware planning in acceptance-driven delivery?

Boundary-aware planning enforces strict CWD-anchored artifact output and a hard artifact write contract to prevent spec drift. It ensures operation contracts and state targets are derived via delegated specifier skills rather than hand-authoring formats.

How do I create operation contracts from product discovery artifacts?

Operation contracts are derived by delegating to specifier skills using accepted discovery truth as read-only input. This prevents manual formatting errors and ensures contracts align with boundary-aware operation constraints and state schemas.

What should I do when upstream discovery truth is insufficient for implementation planning?

When upstream discovery truth is insufficient, structured clarification is delegated to a clarify-loop to identify and resolve gaps. This safety mechanism ensures missing requirements are addressed before deriving operation contracts and design artifacts.

Does the aibdd-plan workflow require Python3 to generate design models?

Python3 is required to run the aibdd-plan workflow scripts that transform discovery truth into implementation design models. The scripts handle boundary-aware artifact generation, contract derivation, and sequence diagram output within the current working directory.

What are the limitations of using boundary-aware planning for software engineering?

Boundary-aware planning requires accepted AIBDD discovery artifacts as read-only input and cannot operate without them. It relies on specifier skills for contract formats and clarify-loop delegation, meaning incomplete upstream discovery will interrupt the planning workflow.