aibdd-auto-starter

Generate boundary-aware walking skeletons for AIBDD projects from arguments.yml variants.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Starting a new AIBDD project often stalls because the system needs the right starter skeleton, correct variant, and the expected repo layout before any real discovery or implementation can begin.

Core Features & Use Cases

  • Walking skeleton generation from kickoff arguments: Creates the initial backend or frontend structure using the arguments.yml-declared STARTER_VARIANT.
  • Variant dispatch (frontend vs backend): Routes to one of python-e2e, java-e2e, or nextjs-storybook-cucumber-e2e, mapping each to its correct template family.
  • Safety guardrails: Verifies arguments presence and starter templates existence; skips overwriting files when they already exist; performs a variant-specific verification step and reports readiness.
  • Next-step reporting for AIBDD flow: Emits a structured completion report and a clear pointer for what to run next (e.g., discovery).

Quick Start

Run the AIBDD kickoff first to produce .aibdd/arguments.yml, then invoke aibdd-auto-starter so it generates the correct walking skeleton based on STARTER_VARIANT in that arguments file.

Frequently Asked Questions about aibdd-auto-starter

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

FAQPage Schema
How do I generate a walking skeleton for a new AIBDD project?▼

To generate a walking skeleton, run the AIBDD kickoff to create `.aibdd/arguments.yml`, then invoke the starter generator to dispatch on `STARTER_VARIANT` and produce the correct repo layout. The generator executes deterministically, verifies the variant, and emits a completion report.

What starter variants are available for repo scaffolding in AIBDD?▼

Available starter variants for repo scaffolding include `python-e2e`, `java-e2e`, and `nextjs-storybook-cucumber-e2e`. Each variant maps to a specific template family for backend or frontend boundary-aware walking skeletons.

How does the starter generator handle existing files during project setup?▼

The starter generator applies safe non-overwriting file writes during project setup, skipping any files that already exist. This safety guardrail prevents accidental loss of existing code when generating the walking skeleton.

Can I use the starter generator without running the AIBDD kickoff first?▼

No, you cannot use the starter generator without the kickoff because it requires `.aibdd/arguments.yml` to exist. The Skill validates argument presence and reads the `STARTER_VARIANT` from this file to dispatch to the correct template.

What happens after the walking skeleton generation completes?▼

After walking skeleton generation completes, the Skill performs a variant-specific verification step and emits a structured completion report. This report provides a clear pointer for the next action to run, such as the discovery phase.

Does the starter generator modify the AIBDD specifications?▼

No, the starter generator does not modify the AIBDD specifications. It strictly produces the boundary-aware repo layout, verifies the variant, and reports readiness without altering your original spec files.