fairmind-plugins

Claude Code plugin marketplace by Fairmind. Two production plugins ship from this repository, each scoped to a different stage of the product lifecycle: design and accessibility for the UI, coding workflow for the engineering team.

Plugin	Scope	Install
fairmind-design	Verify React components against Figma, audit design tokens, run WCAG 2.1 AA accessibility audits, generate Code Connect mappings	/plugin install fairmind-design@fairmind-plugins
fairmind-coding	Six role-based agents (tech lead, engineer, QA, code review, debug, security), nine tech skills, journal-enforcement hooks, eleven commands. Wires into the Fairmind MCP and a .fairmind/ session workspace	/plugin install fairmind-coding@fairmind-plugins

The two plugins are independent. Install one, the other, or both.

---

Install

1. Add the marketplace

/plugin marketplace add FairMind-Gen-AI-Studio/fairmind-plugins

This pulls the marketplace metadata from .claude-plugin/marketplace.json so Claude Code knows which plugins are available.

For local development against an unpushed checkout, point /plugin marketplace add at the directory instead:

/plugin marketplace add /Users/alexiocassani/Projects/fairmind-plugins

2. Install the plugins you want

/plugin install fairmind-design@fairmind-plugins
/plugin install fairmind-coding@fairmind-plugins

The @fairmind-plugins suffix disambiguates if you have multiple marketplaces installed.

3. Verify

/agents     # plugin agents listed (10 fairmind-* design agents, 6 fairmind-coding agents)
/help       # slash commands listed (/design-verify, /a11y-audit, /fix-issue, /sonarqube-fix, ...)

If something is missing, the most common cause is a missing MCP prerequisite — see below.

---

Plugins

fairmind-design

Design and accessibility toolkit. Ten subagents, four orchestration commands, four reference skills.

What it does

• Verifies React components match their Figma source, value-by-value and state-by-state
• Enforces semantic design tokens, flags hardcoded colors / spacing / typography
• Generates and maintains Figma Code Connect mappings (*.figma.tsx)
• Runs full WCAG 2.1 AA audits — contrast, keyboard, screen reader, ARIA — via Playwright + axe-core
• Reviews component composition (DS reuse, prop typing, semantics)
• Closes design tasks with a mandatory CLAUDE.md compliance check

Headline commands — /design-verify, /a11y-audit, /code-connect, /design-task-close.

MCP prerequisites — Figma (mcp__claude_ai_Figma__*), Playwright (mcp__plugin_playwright_playwright__*).

Full reference: plugins/fairmind-design/README.md.

fairmind-coding

Fairmind coding workflow plugin. Six role-based agents, nine technology skills, three journal-enforcement hooks, eleven commands.

What it does

• Atlas (Tech Lead) bootstraps .fairmind/<project>/<session>/ from Fairmind work packages and dispatches the team — never implements
• Echo (SWE / CR), Tess (QA), Shield (security), Debug Detective implement and validate against the Fairmind plan, each with its own journal
• Hooks key off .fairmind/active-context.json to enforce scoped writes and refuse turn-end when a key agent skipped its journal
• Commands cover issue triage (/fix-issue, /fix-frontend-issue), SonarCloud cleanup (/sonarqube-fix), Kubernetes migration (/migrate-to-k8s), and the GitHub PR workflow (/gh-commit, /gh-fix-ci, /gh-review-pr, /gh-address-pr-comments)

MCP prerequisites — Fairmind (mcp__Fairmind__*), Playwright, MongoDB. Plus gh and jq on $PATH. /sonarqube-fix additionally needs SONAR_TOKEN and a sonar-project.properties file.

Full reference: plugins/fairmind-coding/README.md.

---

Requirements

Both plugins assume Claude Code with the /plugin command. The MCP servers each plugin needs are listed above — without them, the corresponding agents will fail at the first MCP call. Authenticate them once in Claude Code's MCP settings; nothing in this repository configures them for you.

Layout

.claude-plugin/marketplace.json   marketplace registration (lists every plugin)
plugins/
  fairmind-design/                plugin payload (agents/, commands/, skills/, plugin.json, README.md, CLAUDE.md)
  fairmind-coding/                plugin payload (+ hooks/, scripts/)
CLAUDE.md                         rules for working ON this marketplace repo

Each plugin's own CLAUDE.md governs Claude when that plugin is active in a host project — not when editing this repo. See the root CLAUDE.md for the marketplace-side rules.

Updating an installed plugin

After a marketplace update on the remote, refresh locally:

/plugin marketplace update fairmind-plugins
/plugin install fairmind-design@fairmind-plugins      # reinstall to pick up the new version

Uninstall

/plugin uninstall fairmind-design@fairmind-plugins
/plugin uninstall fairmind-coding@fairmind-plugins
/plugin marketplace remove fairmind-plugins

Contributing

This repository is small and policy-heavy. Read CLAUDE.md before adding a new plugin or porting commands from another repo — the curation rules (no ambient-skill duplicates, no multi-platform manifests, $CLAUDE_PLUGIN_ROOT for plugin-local paths) are non-negotiable and prevent the marketplace from drifting into a dumping ground.

License

MIT — see each plugin's plugin.json for per-plugin metadata.