How the-agency-ai/the-agency works
TheAgency is a Claude Code multi-agent collaboration framework, with a set of companion applications in the development repository. The main workflow is a Principal working with specialized agent sessions, organizing work in workstreams, coordinating sessions through dispatches and flags, and applying quality gates before work is accepted. Session lifecycle capture and declarative hook rules support that flow. The README documents these capabilities, but the supplied source excerpts chiefly cover Markdown Pal and do not expose the framework’s runtime wiring; the graph therefore omits uncertain internal call relationships.
Main entry points: agency Agent classes · mdpal Markdown Pal CLI · MarkdownPalApp Markdown Pal app · workstreams Workstreams
Components 18
Agent collaboration
- Agent classes
src/agency - Workstreams
src/agency/workstreams
Session coordination
- ISCP coordination
src/agency - Dispatches
usr/jordan/captain/dispatches - Coordination flags
src/apps/mdpal/Sources/MarkdownPalEngine/Flag - Local SQLite DB
Quality and lifecycle
- Reviewer agents
src/agency - Quality gates
src/agency - Session lifecycle hooks
src/claude/hooks - Hookify rules
src/agency
Companion applications
- Markdown Pal CLI
src/apps/mdpal/Sources/mdpal - Markdown Pal engine
src/apps/mdpal/Sources/MarkdownPalEngine - Markdown Pal app
src/apps/mdpal-app/Sources/MarkdownPalApp - SlidePal for Mac
src/apps/mdslidepal-mac/Sources/MdSlidepalLib - SlidePal web
src/apps/mdslidepal-web/src - Monofolk port tools
src/apps/monofolk-ports/tools
Other components
- Principal
- Claude Code
Connections 13
- Principal → Claude Code: directs work
- Claude Code → Agent classes: runs agents
- Agent classes → Workstreams: work in
- Agent classes → ISCP coordination: coordinate via
- ISCP coordination → Dispatches: routes work
- ISCP coordination → Coordination flags: routes flags
- ISCP coordination → Local SQLite DB: stores coordination
- Agent classes → Reviewer agents: invoke review
- Reviewer agents → Quality gates: inform checks
- Claude Code → Session lifecycle hooks: captures lifecycle
- Claude Code → Hookify rules: applies rules
- Markdown Pal app → Markdown Pal CLI: invokes commands
- Markdown Pal CLI → Markdown Pal engine: uses engine