# Bashi Starter

> A lightweight AI orchestration framework for building your first project with AI.

**You have ideas. You can direct, design, and decide. Writing code line-by-line is what blocks you.** Bashi Starter gives you the structure to build real software by directing AI agents through a proven pipeline.

## What You Get

- **3 agents** -- Orchestrator (routes work), Builder (writes code), Reviewer (checks quality)
- **6 skills** -- Plan, PRD, task breakdown, frontend development, code review, deployment
- **6 commands** -- Everything you need from idea to shipped product
- **3 safety hooks** -- Blocks dangerous commands, catches secrets before they're written

## Quick Start

```bash
cd your-project
npx create-bashi-starter
```

Then open the project in VS Code with Claude Code and run:

```
/start
```

## The Pipeline

Every project follows the same path:

```
Idea -> PRD -> Tasks -> Build -> Review -> Ship
```

| Step | What Happens | Command |
|------|-------------|---------|
| 1 | Describe your idea | `/capture-idea` |
| 2 | Generate a PRD and task queue | `/run-project` |
| 3 | Build tasks one by one | `/run-project` (repeat) |
| 4 | Save progress between sessions | `/save` |

## Commands

| Command | What It Does |
|---------|-------------|
| `/start` | See where you are and what to do next |
| `/capture-idea` | Describe what you want to build |
| `/run-project` | Execute the next task from the queue |
| `/setup` | Initialize state files for a new project |
| `/status` | Quick project dashboard |
| `/save` | Save progress for later sessions |

## How It Works

1. **You describe what you want to build.** The framework helps you write a Product Requirements Document (PRD) in plain language.

2. **The framework creates tasks.** Your PRD gets broken into small, specific steps that AI can execute one at a time.

3. **You build one task at a time.** The orchestrator routes each task to the right agent (builder or reviewer) with the right skill. You review after each step.

4. **Safety hooks watch your back.** They block dangerous commands and catch secrets before they're written to files.

5. **State management remembers where you are.** Close your laptop, come back tomorrow, and pick up exactly where you left off.

## Modes

| Mode | Behavior |
|------|----------|
| **Safe** | Propose actions only. Nothing gets modified. |
| **Semi-Autonomous** | Execute one task, then pause for your review. (Default) |
| **Autonomous** | Execute up to 5 tasks in a row, then pause. |

## Prerequisites

1. **A computer** (Windows, Mac, or Linux)
2. **[Node.js](https://nodejs.org)** -- click the LTS button and install with defaults
3. **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** -- the AI coding tool
4. **A Claude subscription** (Pro or Team)

## Want More?

Bashi Starter covers the core pipeline: idea to shipped product. The full Bashi framework adds:

- 12 specialized agents (product manager, architect, designer, and more)
- 40+ skills (backend, mobile, security audits, analytics, game development)
- Overnight mode for unattended multi-hour runs
- Parallel task execution across git worktrees
- Cortex MCP for on-demand knowledge serving
- Self-improving agents with cross-agent feedback

Learn more in **"The Syntax Wall"** by Bashar Amso.

## License

MIT