# ai-workflow

> Claude/Codex skill by [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars · Updated 2026-10-16

This skill should be used when explaining why Bee follows spec-first TDD workflows, or when teaching mode is on. Contains the reasoning behind spec → plan → test → code ordering.

## Install

```sh
git clone https://github.com/incubyte/ai-plugins /tmp/ai-plugins && ln -s /tmp/ai-plugins/bee/skills/ai-workflow ~/.claude/skills/ai-workflow
```

## From README

AI-Assisted Development Workflow Why Specs Matter for AI The \#1 reason AI-generated code misses the mark is ambiguous requirements. "Add authentication" forces the AI to guess 100 decisions — session vs JWT, cookie vs header, redirect vs 401, password rules, lockout policy. Each guess compounds. A spec with clear acceptance criteria eliminates guessing. The AI gets unambiguous targets and nails them on the first pass. The tradeoff: 10 minutes writing a spec saves hours of rework. Without a spec, you'll spend that time anyway — just spread across debugging, re-prompting, and rewriting. Why Tests Define "Done" for AI AI doesn't know when it's finished. It will keep generating code until you stop it. Tests give it a concrete finish line. A failing test is the clearest possible prompt: "Make this pass." The AI doesn't need to interpret requirements — the test IS the requirement in executable form. Red-green-refactor with AI: RED: Write a failing test. The AI now has a precise target.

## Links

- HTML page: https://omgskills.com/library/incubyte/ai-plugins/bee/skills/ai-workflow/
- GitHub: https://github.com/incubyte/ai-plugins
- Author: [@incubyte](https://omgskills.com/library/incubyte/index.md)

## More from this repo

- [ai-ergonomics](https://omgskills.com/library/incubyte/ai-plugins/bee/skills/ai-ergonomics/index.md) — This skill should be used when evaluating how well code supports LLM-assisted development.
   - [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars
- [architecture-patterns](https://omgskills.com/library/incubyte/ai-plugins/bee/skills/architecture-patterns/index.md) — This skill should be used when evaluating architecture options, checking dependency direction, or deciding between...
   - [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars
- [brainstorming](https://omgskills.com/library/incubyte/ai-plugins/bee/skills/brainstorming/index.md) — This skill should be used when the user wants to brainstorm, explore ideas, think through options, says 'let's...
   - [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars