Metadata-Version: 2.4
Name: agensuite
Version: 0.1.0a0
Summary: Agent-native C-suite template: a coding agent orchestrates a turn-based debate between role subagents via a thin CLI.
License: MIT License
        
        Copyright (c) 2026 Omri Amit
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/omri-am/agensuite
Project-URL: Repository, https://github.com/omri-am/agensuite
Project-URL: Issues, https://github.com/omri-am/agensuite/issues
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2
Requires-Dist: typer>=0.12
Requires-Dist: pyyaml>=6
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Dynamic: license-file

```
 █████╗  ██████╗ ███████╗███╗   ██╗███████╗██╗   ██╗██╗████████╗███████╗
██╔══██╗██╔════╝ ██╔════╝████╗  ██║██╔════╝██║   ██║██║╚══██╔══╝██╔════╝
███████║██║  ███╗█████╗  ██╔██╗ ██║███████╗██║   ██║██║   ██║   █████╗
██╔══██║██║   ██║██╔══╝  ██║╚██╗██║╚════██║██║   ██║██║   ██║   ██╔══╝
██║  ██║╚██████╔╝███████╗██║ ╚████║███████║╚██████╔╝██║   ██║   ███████╗
╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝╚══════╝ ╚═════╝ ╚═╝   ╚═╝   ╚══════╝
```

A **universal multi-agent C-suite template** for executing structured,
evolutionary sprints inside any generic software startup. A coding agent
(Claude Code, Codex, Cursor, …) reads `AGENTS.md` and then *acts out* a
C-suite simulation: it spawns one subagent per role (CEO, CPO, CTO, CDO,
CCO), drives a turn-based debate via pull requests, and produces real git
artifacts in a sandboxed inner repository.

The framework is **idea-agnostic**. You supply your product thesis once
(`--idea`), and the C-suite reasons about it; nothing in the template
assumes a domain. The CEO subagent extends the project itself by authoring
the next sprint blueprint after each ADR, so the loop keeps running without
a hand-curated roadmap.

There is **no LLM client inside this codebase**. The orchestrator is the
coding agent itself; the Python code is plumbing — schemas, a git
subprocess wrapper, JSON state files, and a thin CLI that owns every state
mutation.

## Mental model: you don't run *this* repo

This repository is the **`agensuite` tool**, not your project. You don't
clone it and work inside it. Instead you install the tool once, then use
its `init` command to **scaffold a fresh, standalone project folder** that
contains *your* startup's `AGENTS.md`, role playbooks, and first sprint —
with your idea already baked in. You then open *that* folder in your coding
agent.

```
agensuite (the installed tool)  ──init──►  my-startup/   ◄── you open THIS in your agent
                                           ├── AGENTS.md           (the contract)
                                           ├── .claude/agents/*.md (CEO/CPO/CTO/CDO/CCO personas)
                                           ├── sprints/sprint-1.md (your idea, substituted in)
                                           ├── workspace/          (inner git repo — created by bootstrap)
                                           └── state/              (PR + debate JSON — created by bootstrap)
```

## Quickstart (no clone)

The tool installs from the public repo — npm-style, nothing to clone.
We recommend [`uv`](https://docs.astral.sh/uv/) (`pipx` works identically).

**1. Install the `agensuite` tool once** (puts `agensuite` on your PATH):

```bash
uv tool install git+https://github.com/omri-am/agensuite
# or:  pipx install git+https://github.com/omri-am/agensuite
```

> One-shot alternative: `uvx --from git+https://github.com/omri-am/agensuite
> agensuite init my-startup --idea "…"`. Note `uvx` is *ephemeral* — the
> binary disappears after the command, so you'd have to prefix every later
> `agensuite` call the same way. The persistent install above is simpler
> because the workflow runs many `agensuite` commands.

**2. Scaffold your project** (substitutes your idea into every template):

```bash
agensuite init my-startup --idea "A marketplace for renting camera gear between creators"
cd my-startup
```

**3. Bootstrap the sandbox** (creates the inner `workspace/` git repo + `state/`):

```bash
agensuite bootstrap
```

**4. Open `my-startup/` in your coding agent** and prompt it with:

> Read AGENTS.md and execute sprint-1.

That's it. Optionally tweak `.claude/agents/<role>.md` first, or use
`agensuite chief customize <role> --focus "…"` to bias a persona without
opening files.

### What happens when you open it in the agent

Following the `AGENTS.md` contract, the agent plays the **CEO** and:

1. Spawns one subagent per spoke role (CPO, CTO, CDO, CCO), each opening a
   PR with its domain's view of the MVP — all via the `agensuite` CLI.
2. Drives a **turn-based debate** across the PRs (review → rebuttal →
   follow-up), enforced by the CLI's schedule and reviewer-author guards.
3. **Pauses at a human gate** so you can resolve deadlocks ([m]erge /
   [r]eject / [a]dr-options / [s]kip).
4. Merges approved PRs and writes an **ADR** into the inner repo's
   `governance/`.
5. Asks the CEO subagent to author the next blueprint into
   `sprints/sprint-2.md` — then the loop repeats.

> **Coming soon:** once published to PyPI, install simplifies to
> `uv tool install agensuite` / `pipx install agensuite` (or `uvx agensuite
> init …`), dropping the `git+https://…` URL.

## Layout (inside a scaffolded project)

| Path | Purpose |
|------|---------|
| `AGENTS.md` | Contract read by any coding-agent platform on setup. |
| `.claude/agents/{role}.md` | Native subagent playbooks — one per C-suite role (YAML frontmatter + persona body). |
| `sprints/sprint-*.md` | Sprint definitions (YAML frontmatter + body). Ships with `sprint-1.md` only; subsequent sprints are authored by the CEO at runtime. |
| `workspace/` (gitignored) | The inner simulated git repo. |
| `state/` (gitignored) | JSON registries for PRs and debate transcripts. |

## CLI

Run `agensuite --help` to see every subcommand, or jump to the reference
section at the bottom of a scaffolded `AGENTS.md`.

## Developing the framework itself

Only needed if you want to change the tool (CLI, schemas, templates) — not
to use it. Clone and install editable:

```bash
git clone https://github.com/omri-am/agensuite
cd agensuite
pip install -e ".[dev]"
pytest
```

The templates the `init` command ships live under
`src/agensuite/templates/`. Edit those to change what every scaffolded
project starts with.

## License

MIT — see `LICENSE`.
