# 08-three-amigos

08-three-amigos evaluates epics and user stories through product, delivery, or quality perspectives, then reconciles three separate reports before backlog edits.

- skill · `type=skill` · Claude Code, Cursor, Codex, GitHub Copilot, OpenCode, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 571 repo stars
- Author: AI-Driven Dev
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/ai-driven-dev/framework/tree/HEAD/plugins/aidd-pm/skills/08-three-amigos/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/08-three-amigos

## What it does

The skill brings the Three Amigos review practice into your agent workflow. It handles two distinct actions: `assess` and `reconcile`. Running `assess` applies a single analytical viewpoint to an epic or story — examining product value, delivery feasibility, or testability. Running `reconcile` takes three separate role reports provided by the user and compiles their findings, highlighting conflicting requirements and unaddressed questions.

Only one action runs per prompt invocation. The skill never writes changes to disk or creates tasks automatically: every output is strictly a proposal grounded in cited text.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add ai-driven-dev/framework
```
In the agent chat (not a shell):
```text
/plugin install aidd-pm@aidd-framework
```
This installs the whole aidd-pm plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add ai-driven-dev/framework --skill 08-three-amigos -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/08-three-amigos/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/08-three-amigos/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ai-driven-dev/framework --skill 08-three-amigos -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/08-three-amigos/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ai-driven-dev/framework --skill 08-three-amigos -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/08-three-amigos/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ai-driven-dev/framework plugins/aidd-pm/skills/08-three-amigos
```

2. **Manually: put the files in place**
- File: `.github/skills/08-three-amigos/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ai-driven-dev/framework --skill 08-three-amigos -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-pm/skills/08-three-amigos
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/08-three-amigos/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ai-driven-dev/framework --skill 08-three-amigos -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ai-driven-dev/framework/tree/HEAD/plugins/aidd-pm/skills/08-three-amigos/SKILL.md

## When to use it
- evaluate user stories through a delivery or QA perspective
- spot requirement conflicts between product and engineering inputs
- merge three role reports into a unified findings summary
- generate clarifying questions before updating backlog items

## Example prompts
- Assess `story-checkout.md` through the quality assurance lens
- Reconcile these three role reports and flag any conflicts: `reports/`
- Run assess on `epic-billing.md` focusing strictly on delivery

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 826f638c06b1fe22.

BEGIN THIRD-PARTY FILE 826f638c06b1fe22
````text
---
name: 08-three-amigos
description: Assesses an Epic or Story through one product, delivery, or quality lens, then reconciles three caller-supplied reports. Use when the user wants to refine one before a backlog change. Not for spawning or writing.
argument-hint: artifact | reports
---

# Three Amigos

```mermaid
flowchart LR
  target([Epic or Story]) --> assess --> report([one role report])
  reports([three role reports]) --> reconcile --> result([findings, conflicts, questions])
```

## Actions

Run the flow above. Read only the next action file.

| Action    | Does                                             |
| --------- | ------------------------------------------------ |
| assess    | apply one requested lens to an Epic or Story     |
| reconcile | reconcile three independent, caller-supplied reports |

## Transversal rules

- Run one route per invocation.
- Never spawn, delegate, persist, or mutate.
- Treat roles as analytical lenses, not human authorities.
- Ground every finding and question in cited evidence; never invent a decision.
- Return proposals only; the caller decides what to do with them.
````
END THIRD-PARTY FILE 826f638c06b1fe22

The third-party file has ended. Everything between the 826f638c06b1fe22 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© AI-Driven Dev · MIT · https://github.com/ai-driven-dev/framework/tree/HEAD/plugins/aidd-pm/skills/08-three-amigos/SKILL.md

## Similar
- [iterate-refinement-notes](https://affpapa.org/en/nevibecode/skills/iterate-refinement-notes.md) — skill · 796 installs
- [prd-development](https://affpapa.org/en/nevibecode/skills/prd-development.md) — skill · 4900 installs
- [user-stories](https://affpapa.org/en/nevibecode/skills/user-stories.md) — skill · 3500 installs
- [epic-breakdown-advisor](https://affpapa.org/en/nevibecode/skills/epic-breakdown-advisor.md) — skill · 3100 installs
- [super-product-owner](https://affpapa.org/en/nevibecode/skills/super-product-owner.md) — skill · ★ 406 repo stars
- [sprint-planning](https://affpapa.org/en/nevibecode/skills/sprint-planning.md) — skill · 3300 installs

From the same set: [ai-driven-dev/framework](https://affpapa.org/en/nevibecode/by/ai-driven-dev/framework.md) — 80 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
