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.