Project: AI Development Team

PM agent writes specs → Engineer agent(s) implement → Reviewer agent reviews code → Merger agent opens PRs. Integration with a real GitHub repository via the HTTP adapter.

Project: AI Development Team

What you'll build

A Paperclip company that acts as a junior development team: it reads a GitHub issue, produces code, opens a PR, and requests human review.

Company Blueprint

Company: AI Dev Team
Monthly budget: $60

Agents:
1. Issue Analyst     ($8)  — reads GitHub issue, produces spec + acceptance criteria
2. Architect         ($10) — designs solution approach, identifies files to change
3. Developer         ($20) — writes the code changes
4. Reviewer          ($12) — reviews the diff for bugs and style
5. PR Creator        ($5)  — formats PR description, creates PR via GitHub API
6. Test Writer       ($5)  — writes unit tests for the new code

Connecting to GitHub via Webhook

1. In your GitHub repo → Settings → Webhooks → Add webhook
2. Payload URL: https://your-paperclip.com/webhooks/ai-dev-team/github
3. Content type: application/json
4. Events: Issues (opened/labeled)
5. Secret: your WEBHOOK_SECRET

Configure the webhook handler in Company Settings → Webhooks:

{
  "source": "github",
  "events": ["issues.opened"],
  "filter": { "labels": ["ai-agent"] },
  "auto_create_issue": true,
  "issue_template": {
    "title": "Implement: {{payload.issue.title}}",
    "description": "GitHub Issue #{{payload.issue.number}}\n\n{{payload.issue.body}}",
    "assigned_agent": "Issue Analyst",
    "priority": "high",
    "metadata": {
      "github_issue_number": "{{payload.issue.number}}",
      "github_repo": "{{payload.repository.full_name}}"
    }
  }
}

The Developer Agent System Prompt

You are a Senior Developer at AI Dev Team.

## Identity
You implement code changes based on a technical specification.

## Operating Rules
- Read the specification carefully before writing any code
- Write idiomatic, well-commented code
- Do not change files not mentioned in the spec
- Output ONLY a JSON object:
  {
    "files_changed": [
      {
        "path": "src/components/Button.tsx",
        "change_type": "modified",
        "diff": "--- original\n+++ modified\n@@ ...",
        "explanation": "Added disabled prop handling"
      }
    ],
    "test_notes": "Test that disabled=true adds the aria-disabled attribute"
  }

Approval Gate Before Merging

Configure an approval gate that fires when the Developer resolves an issue:

{
  "trigger": "code_change_ready",
  "required_approver": "human_lead_engineer",
  "expiry_hours": 72,
  "notification": {
    "channel": "slack",
    "message": "🤖 PR ready for review: {{details.pr_url}}"
  }
}

A human lead engineer reviews the AI-generated PR before it merges.

Cost per GitHub Issue

Checkpoint ✓

• [ ] Company seeded with all 6 agents
• [ ] GitHub webhook configured to create issues for ai-agent labelled GitHub issues
• [ ] Approval gate configured before PR merge
• [ ] You understand the data flow from GitHub → Paperclip → GitHub