Repository navigation
The first tagged release of solvent-brain: a free, MIT-licensed starter for an AI-maintained architecture knowledge base. It holds the operating contract, resume state, rules and skills from the AI in the Architecture Practice series on mikereams.com.
What's in it
| Piece | What it does |
|---|---|
CLAUDE.md |
The operating contract: layers, rules and the boot / work / close rituals |
wiki/NOW.md, wiki/log/, wiki/inbox.md |
Resume state, so each session starts where the last one stopped |
rules/ |
Seven paste-in rules, from verify before assert to guarded writes and pushed is not deployed |
skills/skeptical-reviewer/ |
An independent reviewer that assumes the change is wrong until its checks pass |
agents/operator.md, skills/_template/ |
A cheaper, bounded operator for repeatable procedures |
examples/ |
A disposition record and the shape of a golden-question eval set |
Get started
Use it as a template: Use this template, then follow the Quick start in the README.
Or install it as an agent skill in Claude Code:
/plugin marketplace add solventarchitect/solvent-brain
/plugin install solvent-brain@solventarchitect
Other agents and Claude.ai: copy plugin/solvent-brain/skills/solvent-brain/ into your skills folder, or zip it and upload it as a custom skill.
Changes in 0.2.0
- New name. The starter, the plugin and its skill are now called
solvent-brain(plugin 0.2.0). If you installed the plugin before October 2, installsolvent-brainagain with the commands above. Old repository links redirect here. - Plugin copy stays in sync. CI checks that the plugin's bundled copy matches the template files (
scripts/sync-plugin.mjs --check). - Banner and social preview redrawn.
The plugin has no scripts and makes no network calls. Review it before installing, as you would any skill.
Read why it exists: Introducing solvent-brain