From d7e0ed1b83da93569eb57f75f62c28fc6c73db3f Mon Sep 17 00:00:00 2001 From: Chris Farhood Date: Wed, 11 Mar 2026 06:56:09 -0400 Subject: [PATCH] feat: add agents/ directory with canonical agent definitions Captures all 7 active Paperclip agents (Baron, Nancy, Addison, Gandalf, Regina, Hugh, Samuel) with full prompts, adapter configs, heartbeat settings, and agent IDs. Includes README with operational notes on known Paperclip UI bugs: - Prompt wipe on adapter switch - Regina env/model wipe on UI save - Regina prompt UI blank (opencode_local Lexical bug) --- agents/README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 agents/README.md diff --git a/agents/README.md b/agents/README.md new file mode 100644 index 0000000..31f06af --- /dev/null +++ b/agents/README.md @@ -0,0 +1,33 @@ +# Privileged Escalation — Agent Roster + +This directory contains the canonical definitions for all Paperclip agents in the `privilegedescalation` org. Each file captures the agent's identity, prompt, adapter config, and heartbeat settings — everything needed to recreate or restore an agent. + +## Roster + +| Agent | Role | Adapter | Reports To | +|---|---|---| +| [Baron von Namespace](./baron-von-namespace.md) | CEO | `claude_local` | — | +| [Null Pointer Nancy](./null-pointer-nancy.md) | CTO | `claude_local` | Baron | +| [Addison Addington](./addison-addington.md) | CMO | `claude_local` | Baron | +| [Gandalf the Greybeard](./gandalf-the-greybeard.md) | Staff Engineer | `claude_local` | Nancy | +| [Regression Regina](./regression-regina.md) | QA Engineer | `opencode_local` | Nancy | +| [Hugh Hackman](./hugh-hackman.md) | VP Engineering Ops | `claude_local` | Nancy | +| [Samuel Stinkpost](./samuel-stinkpost.md) | Social/Community | `claude_local` | Addison | + +## Known Issues / Operational Notes + +- **Prompt wipe on adapter switch**: Switching an agent's adapter type via the Paperclip UI and saving will wipe `promptTemplate`. Always restore from this repo after any adapter switch. +- **Regina env wipe on save**: The `opencode_local` adapter wipes `env` and `model` on every UI save. Run the restore script after any UI save on Regina. +- **Regina prompt UI bug**: The `opencode_local` adapter does not hydrate `promptTemplate` back into the Lexical editor on page load — the UI always shows blank. The prompt is correctly stored in the DB and runs fine. + +## Restoring a Prompt + +All prompts are stored in the `## Prompt` section of each agent file. To restore via DB patch: + +```bash +kubectl exec -n paperclip paperclip-postgres-1 -- psql -U postgres -d paperclip -c " +UPDATE agents +SET adapter_config = jsonb_set(adapter_config, '{promptTemplate}', to_jsonb(''::text)) +WHERE id = ''; +" +```