Skip to content

Monorepo skeleton and cross-project issue tracking for the inter-module ecosystem

Notifications You must be signed in to change notification settings

mistakeknot/Demarch

Repository files navigation

Demarch

A monorepo for building software with agents, where the review phases matter more than the building phases, and the point is not to remove humans from the loop but to make every moment in the loop count.

Demarch is the platform behind Clavain, a self-improving Claude Code agent rig that orchestrates the full development lifecycle from brainstorm to ship. It coordinates Claude, Codex, and GPT-5.2 Pro into something more useful than any of them alone.

Quick start

Install Clavain and the full companion plugin ecosystem in one command:

curl -fsSL https://raw.githubusercontent.com/mistakeknot/Demarch/main/install.sh | bash

Then open Claude Code and run:

/clavain:route

What you get

  • Clavain: the agent rig (brainstorm → strategy → plan → execute → review → ship)
  • 40+ companion plugins: multi-agent code review, phase tracking, doc freshness, semantic search, TUI testing (26 installed by default, 14 optional)
  • Multi-model orchestration: Claude does the heavy lifting, Codex runs parallel tasks, GPT-5.2 Pro provides a second opinion via Oracle
  • Sprint management: track work with Beads, auto-discover what to work on next

Guides

Guide Who it's for Time
Power User Guide Claude Code users adding Clavain to their workflow 10 min read
Full Setup Guide Users who want the complete platform (Go services, TUI tools) 30 min setup
Contributing Guide Developers who want to modify or extend Demarch 45 min setup

How it works

Most agent tools skip the product phases (brainstorm, strategy, specification) and jump straight to code generation. The thinking phases are where the real leverage is. Clavain makes them first-class:

  1. Discover: scan backlog, surface ready work, recommend next task
  2. Brainstorm: collaborative dialogue to explore the problem space
  3. Strategize: structure ideas into a PRD with trackable features
  4. Plan: write bite-sized implementation tasks with TDD
  5. Execute: dispatch agents (Claude subagents or Codex) to implement
  6. Review: multi-agent quality gates catch issues before shipping
  7. Ship: land the change with verification and session reflection

Philosophy

Three principles, applied recursively: every action produces evidence, evidence earns authority, and authority is scoped and composed. The cycle compounds — more autonomy produces more data, more data improves routing, better routing cuts cost, lower cost enables more autonomy.

See PHILOSOPHY.md for the full design bets, tradeoffs, and convictions.

Architecture

Demarch is a monorepo with 5 pillars:

Pillar Layer Description
Intercore L1 (Core) Orchestration kernel: runs, dispatches, gates, events
Clavain L2 (OS) Self-improving agent rig
Interverse L2-L3 47 companion plugins
Autarch L3 (Apps) TUI interfaces (Bigend, Gurgeh, Coldwine, Pollard)
Interspect L2 Agent performance profiler and routing optimizer

Additional infrastructure: Intermute (multi-agent coordination), interbase (SDK), interbench, interband.

Plugin ecosystem

Interactive ecosystem diagram: explore how all plugins, skills, agents, and services connect.

All plugins are installed from the interagency-marketplace.

Naming convention

All module names are lowercase except Clavain (proper noun), Demarch (project name), Interverse (ecosystem name), and Autarch (proper noun).

License

MIT

About

Monorepo skeleton and cross-project issue tracking for the inter-module ecosystem

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors