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

agent-chain-configure

Orchestrate builder, reviewer, and tuner agent handoffs for solution plays — define roles, model routing, token budgets, and quality gates

api-rate-limit-configure

Configure API rate limiting, APIM throttling, and retry behavior for AI endpoints — absorb bursts, isolate noisy tenants, and control 429 retries

app-insights-configure

Configure Application Insights, OpenTelemetry, and KQL dashboards for AI workloads — trace latency, token usage, failures, and cost signals

audit-log-implement

Implement immutable audit logging, PII redaction, and Sentinel monitoring for AI systems — preserve evidence, prove access history, and detect suspicious activity

azure-openai-setup

Set up Azure OpenAI deployments, RBAC, and monitoring — harden inference endpoints and control latency, quota, and cost

backup-restore-ai

Back up AI data, vector indexes, and configuration state — recover prompts, conversations, and search assets after failures

bicep-module-create

Create reusable Bicep modules, parameter files, and registry packages — standardize Azure infrastructure and reduce deployment drift

canary-deploy-ai

Implement canary deployment, rollout gates, and rollback automation for AI changes — catch latency or quality regressions before full release

circuit-breaker-add

Add a circuit breaker, fallback routing, and health checks for Azure OpenAI calls — contain 429 and 503 cascades and preserve service

compliance-audit-run

Run AI compliance audits, collect Azure evidence, and track remediation — assess SOC 2, HIPAA, ISO 27001, and EU AI Act controls

embedding-model-select

Select embedding models, dimensions, and hybrid search settings for vector workloads - balance recall, storage cost, and migration risk

fai-agent-chain-configure

Configure builder→reviewer→tuner agent chain with handoff rules, model assignment, and evaluation gates.

fai-agent-governance

Review agent safety controls, budget limits, and human escalation paths - approve only agents that stay bounded, observable, and policy-compliant

fai-agentic-eval

Run evaluator-optimizer loops for agents and prompts - score outputs, revise weak instructions, and stop only when quality thresholds hold

fai-api-docs-generator

Generate API reference docs, examples, and error catalogs from OpenAPI or code annotations - keep endpoint docs accurate, testable, and publishable

fai-api-endpoint-generator

Generate typed REST API endpoints with Zod/Pydantic input validation, RFC 7807 error responses, OpenAPI annotation, and Managed Identity auth — eliminating schema drift and IDOR vulnerabilities.

fai-api-rate-limit-configure

Configure API rate limiting with Azure APIM policies, throttling tiers, and retry headers.

fai-app-insights-configure

Configure Application Insights with custom AI metrics, anomaly alerts, and operational dashboards.