AI Craftsman Superpowers: developer tool for Hermes Agent

Architecture gate for AI coding agents that blocks writes breaking DDD and Clean Architecture rules

What AI Craftsman Superpowers does

Craftsman moves architecture rules out of prompts and into the loop. The same rules run as pre-write hooks, as a gate in CI and as the criteria a reviewer agent reads. In the README's example, an entity that imports from the infrastructure layer is blocked with LAYER001 and a missing declare(strict_types=1) is flagged as PHP001. The hook exits with code 2 and the file never reaches disk. Other findings are returned to the model to answer for, and the same rule fails the pipeline if it reaches a pull request.

It targets Domain-Driven Design, Clean Architecture and TDD, with repository topics covering PHP, Symfony, Python and TypeScript. Repeated violations can be offered as candidate instincts in /craftsman:metrics. On Hermes it installs by cloning into ~/.hermes/plugins/craftsman and enabling the plugin, and the gate applies when the agent concludes a coding turn. The README warns to install only from its official sources and points to SECURITY.md for verification steps.

Key features

Pre-write hooks that refuse layer violations and missing strict_types
The same rule engine in editor hooks, CI and the reviewer agent
Support for Claude Code, Codex, Grok and Hermes
/craftsman:metrics surfaces repeated violations as candidate instincts
DDD, Clean Architecture and TDD rule sets

When to use it

Stopping a coding agent from importing infrastructure code into a domain layer
Failing a CI pipeline when the same architecture rule is broken in a pull request
Letting Hermes conclude a coding turn only when critical violations are cleared

Who it is for: Teams running coding agents on a codebase where an architecture layer violation costs more than the feature.

How it fits with Hermes Agent

Hermes is one of four documented hosts; it installs as a Hermes plugin under ~/.hermes/plugins/craftsman and has its own Hermes quickstart.

How to install AI Craftsman Superpowers

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/BULDEE/ai-craftsman-superpowers ~/.hermes/plugins/craftsman
hermes plugins enable craftsman

Note: The README warns to install only from its official sources and not from forks, mirrors or improved copies distributed elsewhere.

FAQ

What is AI Craftsman Superpowers?

AI Craftsman Superpowers is a craftsman ecosystem for AI coding agents that enforces architecture rules instead of only prompting for them. The same rules run as hooks on every write, as a CI gate and as reviewer criteria.

Does AI Craftsman Superpowers work with Hermes Agent?

Yes. Hermes is one of the documented hosts alongside Claude Code, Codex and Grok, and the repository has a Hermes quickstart. On Hermes the gate applies at the end of a coding turn, so the agent cannot conclude a turn that leaves critical violations.

How do I install AI Craftsman Superpowers on Hermes?

Clone the repository into ~/.hermes/plugins/craftsman with git clone https://github.com/BULDEE/ai-craftsman-superpowers ~/.hermes/plugins/craftsman. Then run hermes plugins enable craftsman.