skills.rest
pkirsanov
pkirsanovCOMMUNITY
Explore all skills by this author →
GitHub

bubbles-feature-template

Generates canonical Bubbles feature artifacts including spec, design, scopes, and state files.

1|Updated Mar 17, 2026
Search Tags:#certification#spec#gherkin#state.json#control plane#feature template#artifact lint
One-click install
npx skills add https://github.com/pkirsanov/bubbles --skill bubbles-feature-template-pkirsanov
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bubbles-feature-template
Source: https://github.com/pkirsanov/bubbles/tree/main/skills/bubbles-feature-template
Command: npx skills add https://github.com/pkirsanov/bubbles --skill bubbles-feature-template-pkirsanov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Feature folders in the Bubbles framework fail artifact lint and state-transition guards when spec.md, design.md, scopes.md, report.md, or state.json are missing required sections or control-plane fields, forcing manual rework. ## Core Features & Use Cases - Canonical artifact structure: Defines the required files (spec.md, design.md, scopes.md, report.md, uservalidation.md, state.json) with their owning roles and content rules. - v3 control-plane fields: Documents policySnapshot, scenario-manifest.json, certification., executionHistory, and followUps requirements for state.json. - Anti-pattern detection: Lists rejected patterns such as placeholder content marked done, missing per-DoD-item evidence, and dropped SCN- scenario IDs. - Use Case: When starting a new feature under specs/NNN-feature-name/ or refreshing one flagged MAJOR_DRIFT by bubbles.spec-review, apply this template so artifact-lint.sh passes without exemptions. ## Quick Start Create a new feature folder for the booking feature using the canonical Bubbles feature template with all required artifacts and control-plane fields.

Frequently Asked Questions about bubbles-feature-template

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

FAQPage Schema
How do I create a new Bubbles feature folder?▼

Create a directory under specs/NNN-feature-name/ containing spec.md, design.md, scopes.md, report.md, uservalidation.md, and state.json. Follow the canonical template so the state-transition guard and artifact lint pass without exemptions.

What files are required in a Bubbles feature spec?▼

Every feature requires spec.md, design.md, scopes.md (or a scopes/ directory with per-scope files), report.md, uservalidation.md, and state.json. Each file has an owning role, such as analyst for spec.md and design for design.md.

What is policySnapshot in state.json?▼

policySnapshot is a v3 control-plane field holding the effective defaults snapshot with provenance, written when the spec enters in_progress. It must be present once the feature status moves beyond specs_scoped, or the artifact lint rejects it.

Why does artifact lint reject my feature report?▼

Common causes are placeholder spec or design content committed as done, per-scope reports lacking inline evidence of at least 10 lines per DoD item, or tests referencing dropped SCN-* scenario IDs without explicit invalidation.

When should I refresh a stale Bubbles feature?▼

Refresh a feature when bubbles.spec-review returns MAJOR_DRIFT or OBSOLETE. Apply the canonical template to bring artifacts back into the required shape, preserving SCN-* scenario IDs across revisions.

Related Skills

Explore More Software Engineering Skills→
naopensedoit2-designnaopensedoit2-design

product-manager

Generate PRDs, user stories, acceptance criteria, and roadmaps from product ideas.

Community
Intermediate
Ben2pcBen2pc
1

verification-before-completion

Enforce verification steps before declaring task completion in software workflows.

Official
Advanced
AlphaBitCoreAlphaBitCore
21

openapi-review

Audit OpenAPI specs against control-plane handler implementations for semantic drift.

Official
Advanced
SylvainChabaudSylvainChabaud
10

factory-quick

Orchestrate minor code changes with lightweight gate checks and spec validation.

Community
Intermediate