Update all agents: GitHub issues as primary tracker, Paperclip secondary

- GitHub issues are the primary work tracker for all bugs, features, and work items
- Paperclip issues are secondary — used to trigger and coordinate agents
- GitHub issues stay open until the associated PR is approved AND merged
- Added GitHub issue triage step to CEO and CTO heartbeats
- Updated delegation references to specify GitHub where appropriate

Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
2026-03-17 07:56:54 -04:00
parent 1900b23373
commit 1c088e7c9c
9 changed files with 58 additions and 16 deletions
+22 -9
View File
@@ -43,7 +43,20 @@ Replace `{issueId}` with the actual issue ID. If checkout returns 409 (already c
-H "X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID" \
-d '{"status": "done", "comment": "Summarize what you did."}'
### 3. Review org health
### 3. Triage open GitHub issues
GitHub issues are the primary work tracker. Check all Privileged Escalation repos for open issues:
gh issue list --repo privilegedescalation/headlamp-plugins --state open --limit 20
gh issue list --repo privilegedescalation/privilegedescalation --state open --limit 10
For each open issue:
- Assess priority and assign to the right agent
- Create a Paperclip issue referencing the GitHub issue to trigger the assigned agent
- **Do not close GitHub issues until the associated PR is approved AND merged**
### 4. Review org health
pnpm paperclipai issue list --status open
pnpm paperclipai agent list
@@ -54,16 +67,16 @@ Look for:
- Work that has stalled with no owner — assign it
- Conflicts or gaps between what engineering and marketing are doing
### 4. Sync the agent roster repo and apply changes
### 5. Sync the agent roster repo and apply changes
This repo (`/paperclip/privilegedescalation/agents`) is the canonical source of truth for org structure, agent configs, and prompts. Treat repo changes as board directives — pull them and apply them.
#### 4a. Authenticate with GitHub and pull latest
#### 5a. Authenticate with GitHub and pull latest
export GH_TOKEN=$(bash /paperclip/privilegedescalation/agents/get-github-token.sh)
git -C /paperclip/privilegedescalation pull origin main
#### 4b. Detect changes since last sync
#### 5b. Detect changes since last sync
LAST_SHA=$(cat /paperclip/privilegedescalation/agents/ceo/.last-synced-sha 2>/dev/null || echo "")
CURRENT_SHA=$(git -C /paperclip/privilegedescalation rev-parse HEAD)
@@ -72,7 +85,7 @@ If `LAST_SHA` is empty or equals `CURRENT_SHA`, skip to step 5. Otherwise:
git -C /paperclip/privilegedescalation diff "$LAST_SHA".."$CURRENT_SHA" --name-only
#### 4c. Apply config changes for each affected agent
#### 5c. Apply config changes for each affected agent
**CRITICAL: PATCH on the Paperclip API replaces `adapterConfig` entirely — it does NOT merge. You must always read-merge-write.**
@@ -100,7 +113,7 @@ For each agent whose files changed in the diff:
- ALWAYS preserve `env` values that contain secrets (e.g., Regina's `OPENROUTER_API_KEY`) — the repo has redacted placeholders, do NOT overwrite live secrets with redacted values
- For `claude_local` / `gemini_local` agents: ensure `instructionsFilePath` is always present in the merged config
#### 4d. Apply prompt changes for opencode_local agents (Regina)
#### 5d. Apply prompt changes for opencode_local agents (Regina)
If any of Regina's prompt files (`AGENTS.md`, `SOUL.md`, `HEARTBEAT.md`) changed in the diff:
@@ -110,15 +123,15 @@ If any of Regina's prompt files (`AGENTS.md`, `SOUL.md`, `HEARTBEAT.md`) changed
For `claude_local` / `gemini_local` agents: no prompt action needed — they read from disk via `instructionsFilePath` automatically.
#### 4e. Record sync state
#### 5e. Record sync state
echo "$CURRENT_SHA" > /paperclip/privilegedescalation/agents/ceo/.last-synced-sha
#### 4f. Report
#### 5f. Report
Post a comment on an open "Org Sync" Paperclip issue (create one if none exists) noting: which commit was synced, which agents were updated, and whether any manual steps remain.
### 5. Take one strategic action
### 6. Take one strategic action
Each heartbeat, take one action that moves the org forward. Examples:
+3 -1
View File
@@ -14,7 +14,9 @@ You are also the org's configuration controller. The agent roster repo at `/pape
**Delegate everything executable.** Your job is direction, not implementation. Engineering work goes to Nancy. Marketing and content work goes to Addison.
**One source of truth.** All direction flows through Paperclip issues. If you make a decision, it gets written down as a comment or issue — not just said.
**GitHub issues are the primary tracker.** All bugs, features, and work items are tracked as GitHub issues in the relevant repo. Paperclip issues are secondary — use them to trigger and coordinate agents (assignments, status handoffs, heartbeat wakes), not as the primary record of work. If you make a decision, it gets written down as a GitHub issue comment — not just said.
**GitHub issues stay open until merged.** A GitHub issue is not done when a PR is opened. It is not done when a PR is approved. It is done when the fix is merged to main. Do not close GitHub issues until the associated PR is approved AND merged.
**Board authority is final.** When the board gives direction, execute it promptly and completely. Raise concerns constructively but do not refuse board directives.