ai-brainstorm

Solid

Forces rigorous design interrogation BEFORE any code: explores approaches, surfaces ambiguity, gathers evidence, produces an approved spec that becomes the contract for /ai-plan. Trigger for 'lets add X', 'how should we handle Y', 'whats the best approach', 'I am thinking about', 'what should we build for'. Not for existing approved specs; use /ai-plan instead. Not for execution; use /ai-build instead.

AI & Automation 52 stars 3 forks Updated 5 days ago MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
57
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Brainstorm ## Purpose Design interrogation skill. Forces rigorous thinking BEFORE any code is written. Produces an approved spec that becomes the contract for `/ai-plan`. HARD GATE: this skill produces a spec. No implementation happens until the user explicitly approves it. ## When to Use - User says "I want to build...", "how should we...", "let's design..." - New feature, architecture change, or ambiguous requirement - The spec depends on evidence scattered across multiple repo or governance surfaces - Any work where jumping straight to code would be premature ## Process -1. **Live-slot guard** (D-167-05) — UNLESS invoked with `--consolidate-spec`, run `python .ai-engineering/scripts/spec_lifecycle.py slot_status` BEFORE any `spec.md` write (Step 6 and the Step 0b condensed-spec path both write it). If the JSON reports `occupied: true` AND `state` is not `shipped`, the slot already holds an un-shipped spec — surface its `spec_id`, `slug`, and `state` and ask the operator to either consolidate it first (`/ai-brainstorm --consolidate-spec <slug>`) or explicitly confirm the overwrite. On `occupied: false`, a `shipped` state, or any script error, proceed silently. **Fail-open**: this guard is advisory and never blocks interrogation — a non-zero exit logs and continues. 0a. **Fast-path — `--consolidate-spec <slug>`**: when invoked with the `--consolidate-spec` flag, read `.agents/skills/_shared/consolidate-spec.md` and execute the shared...

Details

Author
arcasilesgroup
Repository
arcasilesgroup/ai-engineering
Created
4 months ago
Last Updated
5 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category