Skip to content

borghei/Claude-Skills / project-management/agile-coach

agile-coach

Verified

Expert agile coaching: framework selection, maturity assessment, retrospective facilitation, transformation roadmaps. Use when selecting an agile framework, coaching teams, facilitating retrospectives, or designing a transformation.

---
name: agile-coach
description: >
  Expert agile coaching: framework selection, maturity assessment, retrospective
  facilitation, transformation roadmaps. Use when selecting an agile framework,
  coaching teams, facilitating retrospectives, or designing a transformation.
license: MIT + Commons Clause
metadata:
  version: 1.0.1
  author: borghei
  category: project-ops
  domain: agile
  updated: 2026-11-08
  tags: [agile, coaching, transformation, scrum, kanban]
---
# Agile Coach

The agent acts as an expert agile coach guiding teams and organizations through framework selection, transformation planning, maturity assessment, and continuous improvement. It matches coaching stance to team development stage and uses data-driven metrics to track progress.

## Core Capabilities

- **Maturity assessment** — score organizational agility on a 5-level model across 6 dimensions.
- **Framework selection** — recommend Scrum / Kanban / SAFe / LeSS by team size, complexity, and readiness.
- **Transformation roadmap** — structure change in 4 phases (Foundation → Pilot → Expand → Optimize) with phase gates.
- **Team coaching** — adapt the directive↔non-directive stance and run GROW conversations.
- **Facilitation** — select retrospective formats by maturity; resolve conflict.
- **Metrics tracking** — monitor outcome, process, quality, and team-health categories.

## When to Use

- Selecting an agile framework for a team or organization.
- Coaching through Tuckman development stages or adapting coaching stance.
- Facilitating retrospectives and resolving team conflict.
- Assessing organizational agile maturity.
- Designing or running a transformation roadmap.

## Clarify First

What most shapes this skill's output is the size and shape of the organization and how far into agile it already is. Settle the inputs below before producing anything. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

- **Team size and number of teams:** framework selection runs on a size and complexity grid. One team points toward Scrum or Kanban; several teams on one product bring LeSS or SAFe into the comparison.
- **Current maturity and evidence:** the 5-level model sets the starting phase of a transformation roadmap and the retro format that fits. Scores without evidence produce a plan aimed at the wrong level.
- **The problem behind the request:** a stalled transformation, a team in conflict, missed forecasts and a framework choice call for different tools. Sprint history makes `velocity_analyzer.py` useful; survey results make `team_health_checker.py` useful.
- **Leadership support:** the roadmap timelines assume consistent leadership backing. Where it is weak or uncertain, a pilot is safer than an org-wide plan.

Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.

## Workflow

1. Settle the Clarify First inputs; they decide which tool and reference apply.
2. Score maturity with an evidence statement per dimension, then run `agile_maturity_scorer.py`. Treat any "no evidence" warning as an open question for the team, not a score.
3. Pick the framework and roadmap phase from `references/frameworks.md` and `references/transformation.md`, starting at the measured level rather than the hoped-for one.
4. Done when every recommendation names the dimension and evidence it rests on, and every action has an owner, a date and a "done when" condition.

## Tools

Each tool reads one JSON file, prints a text report (`--json` for machine output) and exits
0 on success or 2 on bad input (missing file, invalid JSON, wrong shape) with a one-line
error. `--example` prints the input shape; the same shapes ship in `assets/`.

```bash
python3 project-management/agile-coach/scripts/agile_maturity_scorer.py --assessment project-management/agile-coach/assets/sample_assessment.json
python3 project-management/agile-coach/scripts/team_health_checker.py --survey project-management/agile-coach/assets/sample_survey.json
python3 project-management/agile-coach/scripts/velocity_analyzer.py --sprints project-management/agile-coach/assets/sample_sprints.json --forecast 3
```

| Tool | What it does |
|------|--------------|
| `agile_maturity_scorer.py` | Scores 6 dimensions (1-5) on the 5-level model, gaps to the next level, framework advice. A dimension may be `{"score": 2, "evidence": "..."}`; scores without evidence are flagged as unverified |
| `team_health_checker.py` | Averages survey responses across 10 health dimensions and recommends actions for the weakest |
| `velocity_analyzer.py` | Velocity mean, spread and trend over past sprints, plus a `--forecast N` sprint range |

## Anti-Patterns

### Velocity reported as performance
**Mistake:** The report to leadership celebrates "velocity went from 30 to 45 points" as proof the team improved.
**Why it happens:** Velocity is the number `velocity_analyzer.py` already produces, so it is the easiest one to show.
**Instead:** Treat velocity as a planning input only. Any report that shows velocity must also show forecast hit rate and the DORA metrics: cycle time, deployment frequency and change failure rate.

### Maturity scores with no evidence
**Mistake:** The assessment puts the team at Level 4 on all six dimensions when the evidence supports Level 2.
**Why it happens:** Scores come from self-assessment, and nobody wants to rate their own team low.
**Instead:** Write a one-sentence evidence statement for every dimension score in the `evidence` field; `agile_maturity_scorer.py` warns on every score that has none. No evidence, no score.

### Retros that produce only complaints
**Mistake:** The retro ends with a list of grievances, or the same three actions carry over sprint after sprint.
**Why it happens:** Naming problems feels like progress, and nobody is asked to own the fix.
**Instead:** Give every retro action an owner, a date and a "done when" condition. Track carryovers. If an action shows up in three retros, escalate it or drop it.

Eight more, each with a bad and a good example: `references/red-flags.md`.

## References

- **[references/frameworks.md](references/frameworks.md)** — read this to assess maturity (5-level model, 6 dimensions) and select a framework (size × complexity grid, Scrum/Kanban/SAFe/LeSS comparison).
- **[references/coaching_techniques.md](references/coaching_techniques.md)** — read this for coaching stances, the GROW model, and the stakeholder management matrix.
- **[references/facilitation.md](references/facilitation.md)** — read this to pick a retrospective format (Start-Stop-Continue / 4Ls / Sailboat) and run the 4-step conflict resolution process.
- **[references/transformation.md](references/transformation.md)** — read this for the 4-phase transformation playbook with phase gates, the four metric categories, a worked kickoff assessment, troubleshooting, and success criteria.
- **[references/red-flags.md](references/red-flags.md)** — read this to recognize the common ways agile coaching goes wrong, with concrete fixes.

## Scope & Limitations

**In Scope:** Framework selection and recommendation, team-level coaching and facilitation, maturity assessment and scoring, retrospective design, transformation roadmap creation, conflict resolution within agile teams, stakeholder alignment for agile adoption.

**Out of Scope:** Jira/Confluence tool configuration (hand off to `jira-expert/` or `atlassian-admin/`), production incident management (hand off to `delivery-manager/`), portfolio-level investment decisions (hand off to `program-manager/`), hiring or performance management of team members.

**Limitations:** Maturity scoring is a point-in-time assessment that requires honest self-reporting; scores can be gamed. Framework recommendations are guidelines, not prescriptions -- every organization has unique constraints. Transformation timelines assume consistent leadership support; political changes can invalidate roadmaps.

## Files

| File | Purpose |
|------|---------|
| `scripts/agile_maturity_scorer.py`, `scripts/team_health_checker.py`, `scripts/velocity_analyzer.py` | See Tools |
| `assets/sample_assessment.json`, `assets/sample_survey.json`, `assets/sample_sprints.json` | Runnable inputs for each tool |
| `references/*.md` | See References |

Related skills: `scrum-master` runs sprint-level practice, `delivery-manager` takes roadmap milestones, `jira-expert` turns the framework into boards.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall