# HAIL - Heroes of the AI League

> HAIL diagnoses a team's AI-adoption + engineering-system-health archetype from a short
> assessment and returns a shareable hero card with prioritized actions and a runbook.
> Core claim: AI amplifies the system it enters - it doesn't fix a broken one.

Cite as: HAIL - Heroes of the AI League ([heroleague.ai](https://heroleague.ai))

## Agent resources
- [Site](https://heroleague.ai)
- [MCP server](https://heroleague.ai/mcp)
- [OpenAPI specification](https://heroleague.ai/openapi.json)
- [MCP server card](https://heroleague.ai/.well-known/mcp/server-card.json)
- [MCP discovery](https://heroleague.ai/.well-known/mcp.json)
- [Agent actions](https://heroleague.ai/.well-known/agents.json)
- [AI plugin](https://heroleague.ai/.well-known/ai-plugin.json)
- [Agent Skills](https://heroleague.ai/.well-known/agent-skills/index.json)
- Install via skills CLI: `npx skills add razzza/hail-skills` (public mirror; see `/skills/README.md`)
- [Authentication](https://heroleague.ai/auth.md)
- [OAuth protected resource metadata](https://heroleague.ai/.well-known/oauth-protected-resource)
- [OAuth authorization server metadata](https://heroleague.ai/.well-known/oauth-authorization-server)

WebMCP registers tools through `navigator.modelContext.registerTool` on site pages, with
`window.HailWebMCP` as a fallback, and forwards calls to `/api`.

## The model
Two axes, 0-100 each, normalized against research anchors (DORA, Faros, METR, GitClear,
Veracode):
- X - AI Adoption Intensity: % AI-authored code & PRs, AI review coverage, agent-resolved
  tickets, agent count.
- Y - Engineering System Health: stability 40% + quality 35% + security 25%.
A team's (X, Y) position is fit (softmax, temperature 15) against seven archetype targets to
name the closest hero, plus a transition path to the next one.

## The seven heroes
- ALLOY MAN - fast and safe; AI amplifies a healthy system. The destination quadrant.
- SHADOWWATCH - selective adoption, elite discipline; opportunity cost is the risk.
- STRONGHOLD - reliable but under-adopting; strategic opportunity cost.
- HOTSHOT - fast but destabilizing; velocity up while stability erodes.
- STORMLOCK - AI potential trapped by legacy fragility.
- OVERLOAD - huge output, clogged review pipeline; activity up, outcomes flat.
- KICK - foundational challenges; low adoption AND weak fundamentals.
(An eighth figure, Mr. R, appears in art but is not a scored archetype.)

## Tools (MCP + WebMCP)
- list_questions(profile) — returns core_count, core_keys, extended_order; each question has tier
- run_assessment(team_name, answers, email?, profile?) — email optional; core 8 is enough
- get_result(run_id)
- get_playbook(run_id, token?) — requires Premium/Portfolio + ownership token

Answers are option indices from list_questions. Agents may stop after the core 8.

## Pricing
- Free - one scored diagnosis per browser (no email required; hero card, five actions,
  Save/Share/Download). Detailed What to Fix playbook is paid.
- Premium - $4.99: What to Fix playbook + 3 extra scored runs over your existing
  free result + advanced real-measurement unlock + returning-user dashboard. One
  Premium per email; while extras remain, upgrade offers stay hidden; after
  exhaustion only Portfolio is offered.
- Portfolio - $49.99: 15 shared runs across named teams + management UI (Teams, Compare,
  Org map, Insights, Members). Org map + org-mean benchmarks; Insights rollups (averages,
  distribution, hero mix, movement, risk watchlist); history; export/share; multi-email
  pool. See Specs/PORTFOLIO_FEATURE_SPEC.md and Specs/PORTFOLIO_INSIGHTS_SPEC.md.
- Enterprise - custom; contact via /contact.html?topic=enterprise.
Agents are rate-limited per IP rather than by a free-run gate. Pay on the website;
MCP/agent clients link out to heroleague.ai to upgrade - they never handle payment
themselves.

## Pages
- [Home](https://heroleague.ai/)
- [Assessment](https://heroleague.ai/assess.html)
- [Dashboard](https://heroleague.ai/dashboard.html) — returning-user run history
- [Learn](https://heroleague.ai/learn.html)
- [About](https://heroleague.ai/about.html) — model + FAQ
- [Portfolio](https://heroleague.ai/portfolio.html)
- [Upgrade](https://heroleague.ai/upgrade.html)
- [Contact](https://heroleague.ai/contact.html)
- [Privacy](https://heroleague.ai/privacy.html)