Primitives

fai-adr-writer

ADR writer — documents architecture decisions with MADR 3.0 template, context, alternatives, trade-off matrices, consequences, and WAF pillar impact analysis.

• operational-excellence

fai-markdown-expert

Markdown specialist — CommonMark/GFM, agent markup (.agent.md/.instructions.md/SKILL.md), documentation standards (README/ADR/changelog), accessibility, and content structure.

• operational-excellence

fai-play-lifecycle

FAI play lifecycle manager — handles play initialization (scaffold file structure), Bicep deployment, evaluation quality gates, and config tuning for any of the 101 solution plays.

• operational-excellence
• reliability
• cost-optimization

fai-tdd-green

TDD Green phase specialist — writes the minimal implementation to make failing tests pass, no more and no less. Follows the Red-Green-Refactor cycle.

• reliability

fai-tdd-red

TDD Red phase specialist — writes failing tests from requirements before any implementation. Covers happy path, error cases, edge cases, and AI-specific test scenarios.

• reliability

fai-tdd-refactor

TDD Refactor phase specialist — improves code quality while keeping ALL tests green. Applies extract method, reduce complexity, improve naming, and design pattern introduction.

• reliability
• performance-efficiency

fai-contributors-report

Include FAI.dev repo stats

fai-daily-ecosystem-report

Daily ecosystem health summary — primitive counts, marketplace stats, validation status, and recent changes across agents, instructions, skills, hooks, and plugins. The morning briefing for the FAI team.

fai-evaluation-regression

Number of previous evaluations for moving average

fai-knowledge-staleness

Monthly check for stale FROOT knowledge modules — scores staleness across docs, plays, primitives, and schemas using a weighted multi-signal algorithm. Generates a freshness dashboard with automated update suggestions.

fai-marketplace-health

Weekly marketplace integrity check — validates all plugin.json files, verifies referenced primitives exist, detects orphaned plugins, and regenerates marketplace.json if needed.

fai-play-portfolio-summary

Aggregated portfolio assessment across all solution plays — dashboard of play health, WAF coverage, technology stack analysis, cost estimation, and ecosystem maturity. Auto-closes previous summary.

fai-play-quality-report

Minimum passing grade (A-F)

fai-play-relevance-check

Interactive slash command to assess whether a solution play is still relevant — checks Azure service availability, pricing changes, SDK deprecations, and alternative patterns.

fai-primitive-pr-review

Automated review of PRs that add or modify primitives — validates naming, frontmatter, schema, WAF alignment, duplicate detection, and file size. Posts structured review comment with verdict.

fai-release-readiness

Preview only — do not create issue

fai-stale-plays-detector

Comma-separated play numbers to exempt (e.g., 01,02)

fai-waf-compliance-check

Per-PR WAF pillar validation — scans changed files for security anti-patterns, reliability gaps, cost waste, operational issues, performance bottlenecks, and responsible AI violations. Produces per-pillar scores (0-100) and compliance matrix.