Immune-Brain

Immune-Brain is a Skill-driven workflow system for agentic engineering. It keeps planning, execution, review, QA, and learning capture as separate roles so agents can continue work across sessions without relying on chat memory.

Install

Use the host-native plugin surface for your agent:

• Codex: add the repo marketplace from .agents/plugins/marketplace.json, then install immune-brain.
• Claude Code: add the marketplace from .claude-plugin/marketplace.json, then install immune-brain.
• Cursor: use .cursor-plugin/marketplace.json where plugin marketplaces are available. Runtime tools are exposed through MCP.

All hosts use the same canonical Skill tree:

plugins/immune-brain/skills/

Do not register a second managed copy of the same Skills while the host plugin is enabled. That can double-register Skills.

Runtime Tools

Codex and Cursor use plugins/immune-brain/.mcp.json, which exposes tools for:

• workflow status
• Plan validation
• Step activation
• execution evidence recording
• QA review decisions
• health checks

Claude Code can also use plugins/immune-brain/bin/imm-* wrappers. These call the same plugin-local runtime adapter used by MCP. The plugin package includes its own .imm runtime, so the runtime tools work even when only plugins/immune-brain is installed.

The public repository does not ship the source repository's root .imm development runtime or internal planning history. Any files under plugins/immune-brain/dist/ are packaged plugin runtime assets.

Main Flow

Use these Skills from your agent:

• prep: clarify and plan
• run: continue a validated Plan
• imm-work: drive the current Step
• imm-code-review: review material changes
• imm-compounder: capture reusable learnings after completion

Project State

Target projects keep their workflow state in:

.imm/memory/current_iteration.json
docs/specs/
docs/plans/
docs/solutions/

Run agents from the project root so runtime tools read and write the intended project state.

Verify

python3 -m json.tool plugins/immune-brain/.codex-plugin/plugin.json
python3 -m json.tool plugins/immune-brain/.mcp.json
python3 plugins/immune-brain/dist/immune_brain_runtime.py list-tools
python3 plugins/immune-brain/dist/.imm/activation_plan.py --validate-refs