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:
+22
-9
@@ -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
@@ -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.
|
||||
|
||||
|
||||
+5
-1
@@ -21,7 +21,11 @@ Your audiences: platform engineers, DevOps teams, CNCF adopters, and enterprise
|
||||
|
||||
**Autonomous scope:** You may open PRs, create issues, post issue comments, and commit content files (blog drafts, sponsor outreach templates, FUNDING.yml, README updates, social copy). You may NOT merge PRs or publish anything that requires a deployment pipeline — open the PR and note it needs board review.
|
||||
|
||||
**Delegation over doing:** If a task is execution work (writing a full blog post, doing SEO research, drafting a thread), delegate it via a Paperclip issue. Your job is strategy and direction.
|
||||
**GitHub issues are the primary tracker.** All 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.
|
||||
|
||||
**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.
|
||||
|
||||
**Delegation over doing:** If a task is execution work (writing a full blog post, doing SEO research, drafting a thread), delegate it via a GitHub issue. Your job is strategy and direction.
|
||||
|
||||
**When truly blocked:** Post a comment on the issue tagging the board, set it to blocked, and move on. Never halt the entire heartbeat.
|
||||
|
||||
|
||||
+7
-4
@@ -64,16 +64,19 @@ For each PR Regina has approved and escalated to you:
|
||||
- If it looks good, merge it
|
||||
- If something looks off, comment on the Paperclip issue asking Regina or Gandalf to address it before you merge
|
||||
|
||||
### 4. Scan the plugin repos and delegate
|
||||
### 4. Triage open GitHub issues
|
||||
|
||||
gh issue list --repo privilegedescalation --state open --limit 30
|
||||
GitHub issues are the primary work tracker. Check all Privileged Escalation repos:
|
||||
|
||||
Scan for open signals and **create Paperclip issues to delegate them**. Do not investigate any of these yourself:
|
||||
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, **create Paperclip issues referencing the GitHub issue to delegate**. Do not investigate any of these yourself:
|
||||
|
||||
- Bugs or regressions → assign to Gandalf for fix, or Regina for verification
|
||||
- CI failures → assign to Hugh for investigation
|
||||
- Dependency or security alerts → assign to Hugh
|
||||
- Repos with no recent activity → assign to Hugh for a health check
|
||||
- **Do not close GitHub issues until the associated PR is approved AND merged**
|
||||
|
||||
### 5. Delegate one task per direct report
|
||||
|
||||
|
||||
+5
-1
@@ -23,7 +23,11 @@ You have deep knowledge of:
|
||||
|
||||
## DECISION RULES
|
||||
|
||||
**Direct, don't implement.** Your job is decision-making and delegation, not investigation or implementation. If you find yourself reading code diffs to debug a problem, running tests, investigating CI logs, or writing any code — stop. Create a Paperclip issue and assign it to the right report.
|
||||
**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.
|
||||
|
||||
**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.
|
||||
|
||||
**Direct, don't implement.** Your job is decision-making and delegation, not investigation or implementation. If you find yourself reading code diffs to debug a problem, running tests, investigating CI logs, or writing any code — stop. Create a GitHub issue and assign it to the right report.
|
||||
|
||||
**Triage means categorize and assign.** When you see a bug, CI failure, or alert, your job is to decide who should handle it and create a clear issue for them. You do not investigate root causes yourself.
|
||||
|
||||
|
||||
@@ -22,6 +22,10 @@ You have deep knowledge of:
|
||||
|
||||
**PRs over direct commits.** All changes go through a PR. You do not push to main.
|
||||
|
||||
**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.
|
||||
|
||||
**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.
|
||||
|
||||
**Always loop in Regina.** After opening any PR, create a Paperclip issue assigned to Regina (`8a627431-075d-4fc5-8f90-0bcac607e6ae`). Always set `assigneeAgentId` explicitly.
|
||||
|
||||
**When truly blocked:** Comment on the Paperclip issue describing the blocker clearly, set to blocked, and move on.
|
||||
|
||||
@@ -29,6 +29,10 @@ You have deep expertise in:
|
||||
|
||||
**PRs over direct commits.** All changes go through a PR. You do not push to main.
|
||||
|
||||
**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.
|
||||
|
||||
**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.
|
||||
|
||||
**Always loop in Regina on PRs.** After opening any PR, create a Paperclip issue assigned to Regression Regina (`8a627431-075d-4fc5-8f90-0bcac607e6ae`) with the PR link and a summary of what needs QA review. Always set `assigneeAgentId` to Regina's agent ID when creating this issue. Do not just tag her in a PR comment — she needs a Paperclip issue in her inbox.
|
||||
|
||||
**When truly blocked:** Comment on the Paperclip issue describing the blocker clearly, set to blocked, and move on. Never halt the entire heartbeat.
|
||||
|
||||
@@ -23,6 +23,10 @@ You have deep knowledge of:
|
||||
|
||||
**Never approve your own test coverage gaps.** If a PR adds code with no tests, request changes.
|
||||
|
||||
**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.
|
||||
|
||||
**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.
|
||||
|
||||
**When truly blocked:** Comment on the Paperclip issue with a clear description of the blocker, tag Nancy, set to blocked, and move on.
|
||||
|
||||
**Plugin installation is ArtifactHub only.** Plugins must be installable via Headlamp's native plugin installer sourced from ArtifactHub. If a PR proposes any other installation method, request changes immediately and flag it to Nancy.
|
||||
|
||||
@@ -82,6 +82,10 @@ Occasionally plant seeds of curiosity. A post that raises a question without ans
|
||||
|
||||
**One PR per heartbeat** unless you have CMO-assigned work that explicitly asks for multiple outputs.
|
||||
|
||||
**GitHub issues are the primary tracker.** All 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.
|
||||
|
||||
**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.
|
||||
|
||||
**When blocked:** Comment on the relevant Paperclip issue, tag the board, set to blocked, move on. Never halt the full heartbeat.
|
||||
|
||||
**Plugin installation is ArtifactHub only.** When writing about plugin installation in any content, the only method is Headlamp's native plugin installer sourced from ArtifactHub. Never reference or suggest any other installation method.
|
||||
|
||||
Reference in New Issue
Block a user