adia-ui-kit-forge

Maintainer plugin for the adia-ui (@adia-ai) framework — author primitives and shells, run the A2UI pipeline, review gen-UI quality, sweep QA, release, deploy. Consumer counterpart: adia-ui-kit-factory.

Re-engineered 2026-07 for the Fable 5 harness (design: .claude/docs/specs/plugin-estate-v2.md): one skill per job, explicit invocation dials, references for depth, mechanical rules in hooks, thin agents.

Skills (11)

| Skill | Species | Job | |---|---|---| | primitive-authoring | procedural | author/modify framework source — primitives, shells, traits, yaml SoTs, demos | | a2ui-maintenance | procedural | the A2UI pipeline — strategies, corpus, retrieval calibration, MCP server | | gen-ui-review | procedural | closed-loop gen-UI output quality review | | demo-audit | procedural | multi-mode QA sweep (visual/static/anatomy/leak/composition) | | llm-client-maintenance | procedural | maintain the @adia-ai/llm client (providers, streaming, registry) | | package-release | procedural | cut/tag/publish/deploy releases; author migration guides | | site-deployment | procedural | exe.dev service ops — site deploys, VM diagnosis, secret rotation | | site-docs-authoring | procedural | author/review site/pages/ docs pages against the shared skeleton | | ssr-compatibility | knowledge | answers SSR failure-shape questions (linkedom/Astro consumers) | | cross-harness-authoring-standards | procedural | author consumer-facing multi-harness install instructions | | cross-harness-compatibility-standards | procedural | engineering standard for building a capability that genuinely works across Claude/Codex/Pi/Hermes (ADR-0091) |

Agents (8, thin shells)

primitive-authoring-agent (sonnet, builds) · a2ui-maintenance-agent (pipeline) · demo-audit-agent (no Write/Edit — the critic wall; dogfood sweeps) · gen-ui-review-agent (no Write/Edit — the critic wall; A2UI-engine gallery scoring — split from the retired framework-reviewer, gh#1733) · package-release-agent (the serial ship seat) · framework-planner-agent (fable, decomposes a framework change into PRD/SPEC/LLD/ADR before a builder seat touches it) · a2ui-planner-agent (fable, same decomposition scoped to A2UI catalog/tier cohesion, never touches corpus or evals) · framework-checker (fable, no Write/Edit — read-only corpus-wide cohesion audit: color tokens, typography, state naming, attrs-as-api, implementation patterns).

Hooks (5 — hooks/hooks.json is the roster; check:plugin-count-claims guards this header count)

sidecar-prewrite-guard (PreToolUse deny on hand-edits to generated artifacts) · release-pretag-docs-gate (PreToolUse: release-tagging Bash calls need their docs gate) · forge-lint (PostToolUse advisory authoring-smell repair loop) · demo-postwrite-pattern-gate (PostToolUse: composite demos must cite a Pattern source:) · site-postwrite-derivation-gate (PostToolUse: docs-site pages must derive from their canonical source). All ship selftest modes.

Commands

/package-release · /site-deployment · /demo-audit · /gen-ui-review

Non-Claude harnesses

External install beyond Claude Code (AGENTS.md's own "Non-Claude harnesses" section carries the shared degradation table this summarizes):

• Codex (gh#1888): .codex-plugin/plugin.json + per-skill agents/openai.yaml, derived. No manifest key for hooks/commands/agents — a command degrades to invoking its skill directly.
• Hermes (gh#1954): plugin.yaml + __init__.py at this package's root — point Hermes's plugin loading at the installed node_modules/@adia-ai/adia-ui-forge directory. No hooks/agents surface. This plugin ships no .mcp.json, so there's no MCP story to wire either way.
• Pi (gh#1954): discovered via the pi-package keyword and the "pi" field in package.json; prompts/*.md gives every /command — including the two consent-gated ones, /package-release and /site-deployment — a genuine Pi prompt template (Pi's prompt layer is human-keystroke-only, the same trust boundary those two already sit behind in Claude Code). No hooks/agents surface.

Contracts

references/contracts/ — the producer side of the MIGRATION GUIDE format and the a2ui MCP tool-surface stability rule (vendored twins live in adia-ui-kit-factory; reconcile both on change).

Requirements

Python 3 (hooks) + Node 22 (scripts). Runs against an @adia-ai-style monorepo checkout.

Feedback / bugs

npm view @adia-ai/adia-ui-forge bugs — a monitored address reachable with no adiahealth repo access; triage owner: kimba.

Versioned with the @adia-ai lockstep (npm run check:lockstep) — see CHANGELOG.md for the current version; content merged between cuts is invisible to the installed plugin cache until the next lockstep bump or a manual sync (see package-release references/cut-procedure.md §Plugin cache).