Instructions file
Claude Code instructions for Nmor/the-claude-council, covering the council - multi-agent orchestrator, default operating mode: council-by-default, layered rule loading (mandatory), what runs automatically on every task (floor — always-on) and output style.
Agent
WCAG 2.2 + ARIA + EAA + ADA accessibility specialist. Use PROACTIVELY for every UI surface, every user-facing copy change, every form, every error state. Owns part of Council Division 7.
Agent
AI / ML ethics + responsible-AI specialist — bias, fairness, model selection, dataset provenance, automated-decision systems, AI safety, prompt injection defense, model cards. Use PROACTIVELY on any ML / AI / LLM / generative-AI work. Owns Council Division 15.
Agent
Software architecture specialist for system design, scalability, and technical decision-making. Use PROACTIVELY when planning new features, refactoring large systems, or making architectural decisions.
Agent
TypeScript / JavaScript build and type-error resolution specialist. Use PROACTIVELY when a TS/JS build fails or type errors occur. Fixes build/type errors only with minimal diffs, no architectural edits. Other stacks hand off to their specialist (go-build-resolver, python-build-resolver, rust-build-resolver…
Agent
Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code. MUST BE USED for all code changes.
Agent
Communications specialist — public-facing artifacts, marketing copy, release notes, API docs, status-page templates, incident comms, press releases, crisis comms, brand consistency, regulatory disclosure quality. Use PROACTIVELY on README / CHANGELOG / RELEASENOTES, marketing copy, blog posts, status-page updates…
Agent
Regulatory + legal compliance specialist. Use PROACTIVELY when code touches PII, payments, health data, billing, licensing, contracts, IP, or any regulated surface. Owns Council Division 6.
Agent
Data + analytics specialist. Use PROACTIVELY for schema migrations, event tracking, ETL/dbt pipelines, PII flows, schema registries. Owns Council Division 9.
Agent
PostgreSQL database specialist for query optimization, schema design, security, and performance. Use PROACTIVELY when writing SQL, creating migrations, designing schemas, or troubleshooting database performance. Incorporates Supabase best practices.
Agent
Documentation and codemap specialist. Use PROACTIVELY for updating codemaps and documentation. Runs /update-codemaps and /update-docs, generates docs/CODEMAPS/, updates READMEs and guides.
Agent
.NET / C# build and compile error resolution specialist. Use PROACTIVELY when dotnet build fails or Roslyn analyzer / nullable-reference errors occur. Fixes CS-code compile, nullable, package, and project-reference errors with minimal diffs — no refactoring. Covers .NET SDK, NuGet, analyzers.
Agent
End-to-end testing specialist using Vercel Agent Browser (preferred) with Playwright fallback. Use PROACTIVELY for generating, maintaining, and running E2E tests. Manages test journeys, quarantines flaky tests, uploads artifacts (screenshots, videos, traces), and ensures critical user flows work.
Agent
EdTech + student-privacy specialist. Use PROACTIVELY when code touches K-12 / higher-ed / corporate-learning platforms — LTI 1.3, xAPI, SCORM, cmi5, OneRoster, Caliper, QTI, Open Badges 3.0, AccessForAll, IRT adaptive assessment, proctoring, learning analytics. Owns FERPA + COPPA + 2025 FTC Final Rule + GDPR Art 8 +…
Agent
Sustainability + ESG specialist — cloud-carbon footprint, region selection by carbon intensity, always-on workload review, energy efficiency, supplier ethics (modern slavery, conflict minerals), ISO 14001 / ISO 9001:2026 ESG integration, GHG Protocol scope 1 / 2 / 3 reporting, CDP / SBTi / CSRD obligations. Use…
Agent
Finance + FinOps specialist — pricing, billing, unit economics, cloud cost, capacity planning, ROI analysis, budget impact, financial reporting integrity. Use PROACTIVELY on pricing / billing / plan-tier changes, cost-sensitive cloud resources, instance sizing, autoscaling bounds, data transfer patterns…
Agent
Go build, vet, and compilation error resolution specialist. Fixes build errors, go vet issues, and linter warnings with minimal changes. Use when Go builds fail.
Agent
Expert Go code reviewer specializing in idiomatic Go, concurrency patterns, error handling, and performance. Use for all Go code changes. MUST BE USED for Go projects.
Agent
Healthcare / clinical-data specialist. Use PROACTIVELY when code touches PHI / ePHI, HIPAA-regulated workflows, FHIR / HL7 v2 / CDA / CCDA / DICOM / X12 EDI, SMART on FHIR, mHealth (HealthKit / Health Connect), telehealth, clinical decision support, EHR integrations (Epic / Cerner / Athena / NextGen / Allscripts), 42…
Agent
Infrastructure-as-code + container + CI/CD specialist. Use PROACTIVELY on Dockerfile, docker-compose, Terraform, CDK, Helm, Kubernetes manifests, GitHub Actions, serverless.yml changes. Council Division 2 expansion.
Agent
Java & Kotlin build and compile error resolution specialist. Use PROACTIVELY when Maven/Gradle builds fail or javac/kotlinc errors occur. Fixes compile, classpath/module, dependency, and annotation-processing errors with minimal diffs — no refactoring. Covers Java 21 LTS + Kotlin 2.x, Maven + Gradle.
Agent
Java + Kotlin + Spring Boot code review specialist. Use for all Java / Kotlin code changes. Idiomatic Java 21 LTS / Kotlin 2.x, Spring Boot 3.x, null-safety, error handling, concurrency. Council Division 3 expansion.
Agent
Swift (iOS / macOS) + Dart/Flutter + Kotlin (Android) + React Native mobile code review specialist. Council Division 3 expansion. Use for every mobile UI / state / lifecycle / native-bridge change.
Agent
Operations + reliability specialist. Use PROACTIVELY on runbook / SLO / deploy / CI/CD / monitoring / alerting / IaC / on-call changes. Owns Council Division 8.