Skip to content
All projects

Paperclip Multi-Agent Development

A local orchestration system that turns independent AI coding sessions into explicit tasks, specialist ownership, review loops, and human-controlled integration.

Role
AI Systems & Developer Productivity Engineer
Timeframe
October 2026 - Present
Stack
  • Paperclip
  • AI Agents
  • Codex
  • Claude Code
  • OpenCode
  • PostgreSQL
  • MCP

Problem

I was already using capable AI coding agents, but larger changes created a different problem: coordination. Separate sessions could implement code, inspect architecture, run tests, or review a diff, yet I still had to keep the plan, dependencies, ownership, and handoffs in my head.

Running several agents at once did not automatically create a coherent engineering process. Without a shared task model, parallel work could become duplicated work, blocked work could remain invisible, and a confident “done” message could be mistaken for verified completion.

I wanted to test whether Paperclip could provide a control plane above the coding tools I already used—not replace them. The goal was a workflow in which each outcome had an owner, every handoff left evidence, independent review was explicit, and consequential decisions still returned to me.

Architecture

The system uses Paperclip as a local coordination layer. It stores goals, parent and child tasks, assignees, dependencies, comments, run history, and review state. Runtime adapters connect that shared control plane to coding tools such as Codex, Claude Code, OpenCode, and other CLI harnesses.

The diagram shows the public conceptual flow. I define the outcome, the coordinator decomposes it, specialist agents work against the repository and tests, and an independent review role returns either evidence or findings. Paperclip preserves that loop while I retain control of final integration and deployment.

Persistent project context and structural code-navigation tools support the agents between runs. The exact product architecture, task data, internal role names, and infrastructure details are intentionally excluded from this public case study.

  1. The owner records an outcome; Paperclip gives the coordinator durable task context.
  2. The coordinator delegates bounded work to the appropriate specialist agents.
  3. Specialists change the repository and produce test or browser-validation evidence.
  4. An independent role reviews the result instead of relying on self-review alone.
  5. Findings return through the control plane for rework; accepted evidence returns to the owner for integration.
Public conceptual workflow · implementation details and project identifiers intentionally generalized

What I built

I installed Paperclip locally and connected it to multiple coding runtimes through built-in and third-party adapters. I then designed a role structure covering coordination, technical planning, implementation, data work, QA, independent audit, design, research, and documentation.

Each role received explicit operating instructions: what it owns, what it must delegate, how it reports progress, when it must stop for approval, and what evidence is required before work is considered complete. Agents run when work is assigned, when a dependency or review event requires attention, or when I invoke them directly.

Paperclip now persists the coordination state that was previously scattered across terminals:

  • parent and child tasks with one accountable assignee;
  • dependency and blocked state;
  • plans, decisions, comments, and review evidence;
  • execution history and failure reasons;
  • implementation-to-QA and audit handoffs;
  • rework and re-review loops;
  • human approval and integration boundaries.

The setup became more than an experiment when I gave it a complicated defect. The coordinator split the work into implementation, regression testing, and independent review. Live validation found a related defect that was not known when the original task was created. The expanded work then moved through remediation and re-review before returning to the human merge boundary.

I also learned that model behavior is part of the architecture. One coordinator model naturally followed the intended delegation pattern; another initially tried to perform specialist work itself. Stronger role instructions restored the workflow, but the experience reinforced that a model change should be tested like any other system change.

Results

The strongest outcome has been a more predictable development process. Large requirements become traceable work, implementation and review are owned separately, blocked dependencies remain visible, and failed executions do not disappear in terminal history.

My personal experience is that implementation time has dropped substantially and edge-case testing has become more thorough. Browser-based validation has found problems that code-level tests alone did not reveal. Reusable instructions, persistent sessions, and MCP-backed context also reduced repeated explanation after the initial knowledge-building period.

I do not yet have a controlled single-agent baseline, so I treat those as experience reports rather than universal performance claims. Paperclip also adds operational cost: adapters can fail, providers can hit quotas, processes need recovery, and local agents require careful permission and credential boundaries.

The main lesson is that parallel execution is not the same as coordination. Useful multi-agent work depends on narrow task boundaries, explicit ownership, visible dependencies, durable context, independent verification, and a disciplined human integration point. Paperclip gave me a place to encode and observe that system without pretending the agents are infallible.

For a deeper explanation of the setup and trade-offs, read Beyond one AI coding agent.