Ay Framework

Multi-agent swarm framework for Claude Code.
  Plan, build, review, test, ship -- with human-in-the-loop gates.

What is this?

AY Framework gives Claude Code a structured brain for building software. Instead of ad-hoc prompting, your AI agent follows a disciplined cycle: plan the work, build it, review it, test it, ship it -- with you approving only two things: the plan and the code.

Everything else is autonomous.

Built by AY Automate. Inspired by gstack.

Install

One command:

Interactive prompt asks which runtime and where to install:

Or skip prompts:

Or clone and run setup:

What happens:

1. Interactive prompt: global (~/.claude) or local (./.claude)
2. If CLAUDE.md exists: injects AY Framework section (never overwrites your config)
3. Installs 6 modes, 27 commands, tracking layer, templates, hooks
4. Creates .ay/ directory for framework operational state

After install, open Claude Code and say:
"I want to build [describe your project]"

Claude analyzes your codebase (or asks questions if empty), generates agents and tasks, and the /go cycle begins.

How It Works

The 7-Layer Architecture

The /go Cycle

The main command. Fully autonomous except for two human gates.

Human does two things: approve the plan, review the code. Everything else is autonomous.

Modes

Six cognitive stances. Each mode changes how the agent thinks. No mixing.

Agents

Each agent owns specific directories and never writes outside its scope. This prevents conflicts when multiple agents work in parallel.

Agents are generated automatically during First Contact based on your project structure. Or add them manually:

Commands

27 commands that cover what others need 66+ for. Each command is a compound workflow, not a single action.

Tracking

All coordination is file-based. No external…