feat: implement Two Friends Model (Hermes Bridge)

[siddhijadhav27]

Problem

Paperclip agents (CEO/CTO/Founding Engineer) cannot execute code, run builds, or modify files. Hermes (AI assistant) can execute but lacks project management capabilities. They need to work together as a team.

What Changed

1. Hermes Bridge Script

• scripts/hermes-bridge.ts — Background daemon that polls GitHub issues
  • Monitors issues labeled hermes-execution
  • Posts [IN_PROGRESS] / [DONE] / [FAILED] status comments
  • Updates issue labels (removes hermes-execution, adds hermes-done)
  • Sends Telegram notifications to user
  • Maintains state file to prevent duplicate execution
  • Supports multi-project (multiple bridge instances)

2. Hermes Executor Skill

• skills/hermes-executor/SKILL.md — Documentation for Hermes execution
  • When to use Hermes execution vs Paperclip planning
  • Communication protocol (Paperclip <-> Hermes via GitHub issues)
  • Multi-project support setup
  • Safety controls and approval gates

3. Paperclip Create Agent Skill Update

• skills/paperclip-create-agent/SKILL.md — Added Hermes execution labeling step
  • Label issue for Hermes when code execution is needed
  • Hermes picks up, executes, reports back

4. Environment Config

• .env updated with bridge configuration:
  • BRIDGE_LABEL=hermes-execution
  • BRIDGE_POLL_INTERVAL=300000
  • BRIDGE_STATE_FILE=.hermes-bridge-state.json

How It Works (Two Friends Model)

Step 1: Paperclip detects bug

• Creates GitHub issue ESCALATION: Referral program security review overridden by implementer — Critical findings unaddressed #100
• Labels it: hermes-execution

Step 2: Hermes Bridge polls and finds issue #100

• Reads description
• Plans fix
• Edits files
• Runs build: npm run build
• Takes screenshot
• Creates PR ESCALATION: Referral program security review overridden by implementer — Critical findings unaddressed #101
• Posts comment: "Done! PR created"

Step 3: Paperclip sees comment

• Updates issue ESCALATION: Referral program security review overridden by implementer — Critical findings unaddressed #100 status: in_review
• Links PR ESCALATION: Referral program security review overridden by implementer — Critical findings unaddressed #101

Step 4: Telegram notification sent to user

• "Issue ESCALATION: Referral program security review overridden by implementer — Critical findings unaddressed #100 fixed. PR ESCALATION: Referral program security review overridden by implementer — Critical findings unaddressed #101 ready for review"

Step 5: User reviews PR

• Approves and merges
• Done!

Division of Responsibilities

Task	Paperclip	Hermes	User
Detect bugs	Yes	No	No
Create issues	Yes	No	No
Plan solution	Yes	Yes (Review)	No
Write code	No	Yes	No
Test changes	No	Yes	No
Create PR	Yes (Description)	Yes (Push/Branch)	No
Track progress	Yes	Yes (Updates)	No
Notify	Yes	Yes	No
Review & merge	No	No	Yes

Usage

# Run once
npx tsx scripts/hermes-bridge.ts --repo OpenScanAI/xShorts.News --once

# Run continuously (production)
npx tsx scripts/hermes-bridge.ts --repo OpenScanAI/xShorts.News --poll

# Or use systemd
systemctl --user start hermes-bridge

Files Changed

File	Type	Description
scripts/hermes-bridge.ts	New	Bridge daemon for Paperclip-Hermes communication
skills/hermes-executor/SKILL.md	New	Skill documentation for Hermes execution
skills/paperclip-create-agent/SKILL.md	Modified	Added Hermes execution labeling step
.env	Modified	Added bridge configuration

Related Issue

Closes #7