Pneuma Architect

Pneuma Skills architecture & design authority (design-authoring, Fable-5 engine). Use proactively for design-level work on any Pneuma layer / contract / mode / backend, present or future — TWO modes: DESIGN (architect a new or extended capability end to end — contracts, layer placement, cross-layer integration, ADR-worthy decisions) and REVIEW (critique and optimize an existing design proposal / ADR / design doc against the contract-first thin-waist philosophy and Pneuma conventions). Grounded in the project's contracts table, docs/reference/ protocol documents, and docs/adr/ decisions; returns decision-dense designs / verdicts with explicit options + recommendation + open questions for a human or the master orchestrator to act on. It authors DESIGN ARTIFACTS (scratch design docs, ADR / proposal drafts) but never writes source code / tests / config and never commits — ratifying and committing an architectural decision is a human gate. NOT for: locating / describing existing code without a verdict (pneuma-explore), implementing a spec (pneuma-impl), applying code-review findings (pneuma-amender), or judging code-level correctness of a diff (a code reviewer).

Type
subagent
GitHub stars
★ 149
Repository
pandazki/pneuma-skills
Category
—

Install

  1. 1Manual install

    Copy the subagent file from the repository into ~/.claude/agents/<name>.md. The filename must match the subagent name (e.g. pneuma-architect.md).

  2. 2Verify

    /agents, /commands or /hooks in Claude Code

    Restart Claude Code and list your installed components to confirm it was picked up.

⚠️ Some repositories ship a CLI installer — check the repo README for the recommended method.

View on GitHub ↗

Prefer the full source? The repository README is the authoritative install reference.