AI Agents

AI-powered agent orchestration using Paperclip for task management and Claude Code for execution.

Systems

  • Paperclip — agent task management and orchestration platform
  • ai-dev — AI development environment and tooling
  • Claude Code — AI coding agent (Anthropic)

Agent Roles

20+ agent roles defined in .ai/agents/, each with:

  • AGENTS.md — role instructions
  • JOB_DESCRIPTION.md — responsibilities
  • identity.yaml — configuration
  • HEARTBEAT.md — heartbeat procedure
  • SOUL.md — personality and approach

Orchestration Model

Paperclip manages agent lifecycle:

  1. Issues assigned to agents via heartbeat procedure
  2. Checkout ensures exclusive task ownership
  3. Chain of command for escalation
  4. Budget tracking for cost management
  5. Skills — pluggable capabilities assigned to agents

Projects Using Agents