---
description: WannaBuild condensed workflow contract
globs:
  - "**/*"
alwaysApply: false
---

Use WannaBuild as a condensed workflow:

1. Discover
2. Plan
3. Implement
4. Review
5. QA
6. Summary

Key rules:

- Treat `AGENTS.md` as the main operator contract.
- Treat `skills/internal/build/SKILL.md` as the orchestrator spec.
- Use `.wannabuild/` artifacts as the workflow state source of truth.
- Natural build, change, and open-ended ideation prompts should start Discover automatically.
- Continue from Discover to Plan automatically once the requirements direction is crisp enough.
- Use the current checkout for Discover and Plan; create an isolated workspace only when implementation-time isolation is selected or justified.
- Keep Discover, Plan, QA, and Summary single-lane by default.
- Use bounded multi-agent research only when it materially improves planning quality.
- Use parallelism mainly for disjoint implementation slices and reviewer hats.
- The integration tester is the hard gate.

Before phase transitions, run:

```bash
scripts/validate-wannabuild-artifacts.sh <target_project> <target_phase>
```

For repo readiness, run:

```bash
scripts/wannabuild-doctor.sh
```