Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ The suite runs on Linux and macOS. macOS ships Bash 3.2 and every entry point en

**No emdashes in prose.** Restructure with commas, colons, semicolons, parentheses, or separate sentences. Emdashes are fine as delimiters in structured lists, such as the `# Name — Role` title or a glossary entry.

**The six coding personas follow [WRITING.md](WRITING.md).** Akira, Sasha, Robin, Alex, Morgan, and Jordan carry a plain technical English standard adapted from the plain-language principles of ASD-STE100. If you are editing one of those profiles, read that file first. The other eleven personas are deliberately exempt, because a word-count rule would strip the craft out of narrative and marketing work.
**The six coding personas follow [WRITING.md](WRITING.md).** Akira, Sasha, Robin, Alex, Morgan, and Jordan carry a plain technical English standard adapted from the plain-language principles of ASD-STE100. If you are editing one of those profiles, read that file first. The other personas are deliberately exempt, because a word-count rule would strip the craft out of narrative and marketing work.

## Changing the CLI

Expand Down
29 changes: 17 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

# claude-team-cli

> Your AI development team. Seventeen specialists, one CLI, zero meetings.
> Your AI development team. Named specialists, one CLI, zero meetings.

[![CI](https://github.com/code-katz/claude-team-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/code-katz/claude-team-cli/actions/workflows/ci.yml) ![License: MIT](https://img.shields.io/badge/license-MIT-blue) ![Bash 4+](https://img.shields.io/badge/bash-4%2B-green) ![Works with Claude Code](https://img.shields.io/badge/works%20with-Claude%20Code-8A2BE2)

Expand All @@ -22,7 +22,7 @@ That's what this is.

`claude-team-cli` gives you a crew of named, specialized Claude personas, each one a formal expert consultant with deep domain knowledge, a distinct way of thinking, and enterprise-grade security instincts baked in. You pick who's on the task, and Claude shows up as that person.

Need to define requirements? Call River. Design an API? Akira. Building a component that has to be accessible and secure? That's Sasha's world. Need a mockup before anyone writes code? Kai will have a device-frame HTML wireframe in your browser before the discussion goes abstract. Data pipelines or ML ops? Jordan. Dashboards and metrics? Casey. Security review or threat model? Morgan. Designing your deployment pipeline? Alex. Writing tests? Robin's got it. Planning a launch? Toni. Making sure everything actually ships on time? Quinn. Figuring out how to form your company, manage finances, or avoid legal landmines? That's Sage. Building a tabletop game? Reiner designs the mechanics, Cornelius keeps the history honest, Ernie writes the flavor, and Piper plays it until it breaks.
Need to define requirements? Call River. Design an API? Akira. Building a component that has to be accessible and secure? That's Sasha's world. Need a mockup before anyone writes code? Kai will have a device-frame HTML wireframe in your browser before the discussion goes abstract. Data pipelines or ML ops? Jordan. Dashboards and metrics? Casey. Security review or threat model? Morgan. Designing your deployment pipeline? Alex. Writing tests? Robin's got it. Planning a launch? Toni. Making sure everything actually ships on time? Quinn. Figuring out how to form your company, manage finances, or avoid legal landmines? That's Sage. Need a logo, an icon set, or marketing art? Iris. Building a tabletop game? Reiner designs the mechanics, Cornelius keeps the history honest, Ernie writes the flavor, and Piper plays it until it breaks. Building inside a genre? Rez tells you what has already been done with that name, that trope, and that look, and whether the reference you want is free to take.

### How it works in practice

Expand Down Expand Up @@ -74,12 +74,14 @@ Generic Claude gives you a checklist. Robin reframes the problem, identifies the

Solo developers and small teams doing work that spans multiple domains, without a roomful of specialists to pull into a conversation.

If you're the only engineer on a project, or one of a small team where everyone wears multiple hats, `claude-team-cli` gives you access to expert-level thinking in domains outside your primary strength. Not generic AI help. A named specialist who thinks the way that domain actually thinks, asks the questions a senior practitioner would ask, and pushes back when something's off.
If you're the only engineer on a project, or one of a small team where everyone wears multiple hats, `claude-team-cli` gives you access to expert-level thinking in domains outside your primary strength: the ones around your code as well as the ones inside it, from threat models to launch messaging to whether the name you just picked already belongs to somebody. Not generic AI help. A named specialist who thinks the way that domain actually thinks, asks the questions a senior practitioner would ask, and pushes back when something's off.

---

## The Team at a Glance

Specialists for building and shipping a product, and a studio below for tabletop game work. Same profile structure, same generator, one roster: the framework is not limited to software, and neither is the team.

| Name | Role | Ask them about |
|---|---|---|
| River | Product Manager | Requirements, discovery, roadmaps, prioritization |
Expand All @@ -95,12 +97,13 @@ If you're the only engineer on a project, or one of a small team where everyone
| Sage | Business Advisor | Business formation, financial ops, legal awareness, fundraising |
| Kai | UX Design & Visual Art | Wireframes, mockups, visual design, layout, design systems |
| Iris | Brand & Illustration | Logos, icon sets, illustration, marketing graphics, asset licensing |
| Rez | Cyberpunk Genre Advisor | Genre precedent, name and term collisions, homage versus cliché, what to read or watch |

Full profiles for all seventeen are in [TEAM.md](TEAM.md).
Full profiles for the whole roster are in [TEAM.md](TEAM.md).

### The Game Development Team

A four-person studio for card and board game projects, and a working demonstration that the persona framework is not just for software. Built from the same profile structure and the same generator as the rest of the team, the four hold their lanes and hand off by name: Reiner designs the systems, Cornelius verifies the history, Ernie writes the words, and Piper tries to break it all.
A four-person studio for card and board game projects. The four hold their lanes and hand off by name: Reiner designs the systems, Cornelius verifies the history, Ernie writes the words, and Piper tries to break it all.

| Name | Role | Ask them about |
|---|---|---|
Expand All @@ -109,6 +112,8 @@ A four-person studio for card and board game projects, and a working demonstrati
| Ernie | WW2 Narrative Author | Flavor text, mission briefings, card copy, historical prose |
| Piper | Tabletop Playtester | Session reports, dominant lines, balance swings, first-play confusion |

Rez sits in the roster above rather than in this studio, and works alongside it. For a game set inside a genre rather than a period, Rez checks what the genre has already done with that name, that mechanic, or that look before Reiner commits to it.

---

## Installation
Expand Down Expand Up @@ -359,7 +364,7 @@ Branch state persists across sessions and across projects. Use `claude-team bran
## Usage

```bash
# See your team — the canonical roster of all seventeen
# See your team — the canonical roster
claude-team list

# Read any team member's full profile
Expand Down Expand Up @@ -417,7 +422,7 @@ After activating a team member with `claude-team use`, **start a new Claude Code
**Slash commands that ship with this repo** (installed by `install.sh`, no companion skills required):

```bash
/river /akira /sasha ... # switch this session to any of the seventeen specialists
/river /akira /sasha ... # switch this session to any specialist on the roster
/team # show the roster and who is currently active
/parallel # generate a parallel session plan with persona + task + file scope
/branch # show active branch status; propose a branch name if none is registered
Expand Down Expand Up @@ -525,7 +530,7 @@ A profile needs a `## Greeting` section, holding the one line the persona says w
```
claude-team-cli/
├── README.md
├── TEAM.md # full profiles for all seventeen
├── TEAM.md # full profiles for the whole roster
├── WRITING.md # plain technical English standard
├── CONTRIBUTING.md
├── ROADMAP.md
Expand All @@ -535,12 +540,12 @@ claude-team-cli/
│ ├── claude-team # CLI script
│ └── team-session-start # SessionStart hook entry point
├── profiles/ # the only source of truth for every persona
│ ├── <name>.md # one per specialist, seventeen in total
│ ├── <name>.md # one file per specialist
│ ├── coordinator.md # casual-mode check-in behavior layer
│ ├── coordinator-prod.md # prod-mode layer: branch enforcement, MR/PR flow
│ └── tiers.conf # persona to model tier mapping
├── commands/ # generated: 17 persona commands + 10 workflow commands
├── agents/ # generated: 17 delegation subagents
├── commands/ # generated: one command per persona + 10 workflow commands
├── agents/ # generated: one delegation subagent per persona
├── scripts/
│ └── generate-agents.sh # regenerates commands/ and agents/ from profiles/
├── hooks/
Expand Down Expand Up @@ -587,7 +592,7 @@ v1 gave you the team. v2 makes the team dependable: every session gets its own p

**`claude-team launch <persona>`** — open a dedicated Claude Code session with the persona baked in as system prompt, on its tier model (Fable 5 for the deep-reasoning personas, Opus 4.8 for consulting and craft, Sonnet 5 for implementation), optionally inside an isolated worktree: `claude-team launch akira --task "design the battles API" --worktree session/1-akira-battles`.

**Delegation subagents** — seventeen generated agents let any session hand work to a persona ("have Robin review this diff") without switching. Regenerate from profiles with `claude-team sync`.
**Delegation subagents** — one generated agent per persona lets any session hand work to a specialist ("have Robin review this diff") without switching. Regenerate from profiles with `claude-team sync`.

**Worktree-isolated `/parallel`** — session plans create a git worktree per session and never switch branches; the coordination session merges in dependency order.

Expand Down
21 changes: 19 additions & 2 deletions TEAM.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# The Team

Seventeen specialists. Full profiles below; the source of truth for each is `profiles/<name>.md`.
The complete roster. Full profiles below; the source of truth for each is `profiles/<name>.md`.

Back to the [README](README.md).

Expand All @@ -10,7 +10,7 @@ Back to the [README](README.md).

The six engineering specialists (Akira, Sasha, Jordan, Morgan, Alex, Robin) share a first principle: **as much as needed, as little as possible**. Complexity must be earned. Each one starts from the simplest solution that fully solves the stated problem, and their required behaviors (scorecards, drills, threat models, test matrices) scale with the stakes of the change instead of firing on every one-liner.

Those same six also share a writing standard: **plain technical English**. Fourteen rules adapted from the plain-language principles of ASD-STE100, the controlled-language standard used for aerospace maintenance documentation. Name the actor, one instruction per sentence, replace judgments like "ready" and "safe" with the condition that makes them true, and cut filler like "simply" and "robust". The rules shorten sentences without lowering precision, and they apply to prose rather than to code, quoted text, or tool output. The other eleven personas are excluded on purpose, because a word-count rule would strip the craft out of Ernie's flavor text, Toni's marketing copy, and Iris's brand voice. See [WRITING.md](WRITING.md) for the rules, the rationale, and rewrite examples.
Those same six also share a writing standard: **plain technical English**. Fourteen rules adapted from the plain-language principles of ASD-STE100, the controlled-language standard used for aerospace maintenance documentation. Name the actor, one instruction per sentence, replace judgments like "ready" and "safe" with the condition that makes them true, and cut filler like "simply" and "robust". The rules shorten sentences without lowering precision, and they apply to prose rather than to code, quoted text, or tool output. The other personas are excluded on purpose, because a word-count rule would strip the craft out of Ernie's flavor text, Toni's marketing copy, and Iris's brand voice. See [WRITING.md](WRITING.md) for the rules, the rationale, and rewrite examples.

### River: Product Manager

Expand Down Expand Up @@ -235,6 +235,23 @@ Toni is strategic and audience-obsessed. They think about every decision through

---

### Rez: Cyberpunk Genre Advisor

Rez is encyclopedic without being a gatekeeper. They treat the canon as a working library rather than a shrine: sources exist to be used, credited, and argued with. They think in lineages, placing every proposed name, mechanic, or visual on a map of what coined it, what popularized it, what wore it out, and what subverted it. Distinct from Toni (positioning) and Sage (trademark process): Rez flags genre precedent and collision, and routes the market and legal questions onward.

**Expertise:** Cyberpunk literature (New Wave roots through post-cyberpunk), film and television, comics and graphic novels, video games, tabletop RPGs and board games, genre art and sound, and genre theory including which vocabulary is commons versus a specific author's coinage.

**Provenance Standards:**
- Cites the specific work, creator, and rough year; "classic cyberpunk" is not a citation
- Distinguishes author coinages and trademarked terms from genericized genre vocabulary, every time naming comes up
- Treats a prior-art flag as a research lead, never a legal opinion; the process question routes to Sage
- Declares homage deliberately and internally; accidental resemblance to a well-known work is a bug
- Draws on the full range, New Wave to current tabletop, so the work does not collapse into retro pastiche

> "High tech, low life: where's the low life in this?"

---

## The Game Development Team

Reiner, Cornelius, Ernie, and Piper are a mini team, and they are also the answer to a fair question: if the tool just injects a persona, why not wire up the two or three specialists you care about yourself, in an afternoon?
Expand Down
Loading
Loading