privilegedescalation/org
Archived
12
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

Restructure agent roster to Paperclip 4-file standard

Browse Source 
Split each agent from a single monolithic markdown file into the
Paperclip-recommended 4-file structure (AGENTS.md, SOUL.md, HEARTBEAT.md,
TOOLS.md) plus CONFIG.md as operational backup.

Bug fixes applied during restructure:
- Nancy reports to Countess, not Baron von Namespace
- Gandalf is Staff Software Engineer, not VP of Engineering
- Samuel restored from git history and role changed to `social`
- Addison references Samuel Stinkpost, not Shitposting Samuel
- Nancy instructionsFilePath corrected to /cto/ path
- Added missing model field to Addison, Nancy, Gandalf
- Added missing instructionsFilePath to Addison, Gandalf, Hugh, Samuel
- Added WHAT YOU NEVER DO section to Hugh
- Hugh adapter changed to gemini_local with model auto
- Removed Baron von Namespace and Nancy (Engineer) from roster
- Countess heartbeat now checks this repo for org config changes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Chris Farhood
2026-03-15 08:34:44 -04:00
parent 922f123d84
commit 5e22abeba0
43 changed files with 1273 additions and 823 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+17 -6
View File
@@ -14,20 +14,31 @@ There is no application code, build system, or test suite in this repo. It is a
- `ceo/` — CEO agent (Countess von Containerheim)
- `cto/` — CTO agent (Null Pointer Nancy)
- `cmo/` — CMO agent (Addison Addington)
- `engineering/` — Engineering agents (Gandalf the Greybeard, Hugh Hackman, Regression Regina)
- `marketing/` — Marketing/community agents (Samuel Stinkpost)
- `engineering/gandalf/` — Staff Engineer (Gandalf the Greybeard)
- `engineering/hugh/` — VP Engineering Ops (Hugh Hackman)
- `engineering/regina/` — QA Engineer (Regression Regina)
- `marketing/samuel/` — Social/Community (Samuel Stinkpost)
Each agent file contains: Identity table (ID, role, adapter), Heartbeat config, Adapter config, and the full Prompt.
Each agent directory contains 5 files:
| File | Purpose |
|---|---|
| `AGENTS.md` | Bootstrap prompt (loaded via `instructionsFilePath`) |
| `SOUL.md` | Persona, voice, values, decision rules, constraints |
| `HEARTBEAT.md` | Step-by-step execution checklist run on every heartbeat |
| `TOOLS.md` | Available CLI tools registry |
| `CONFIG.md` | Operational backup — identity table, adapter config, heartbeat config |
## Key Operational Notes
- **Prompt wipe on adapter switch**: Switching an agent's adapter in the Paperclip UI wipes `promptTemplate`. Always restore from this repo after any adapter switch.
- **Regina (opencode_local adapter)**: UI saves wipe `env` and `model`. The prompt field always appears blank in the UI but works correctly in the DB.
- **Regina (opencode_local adapter)**: UI saves wipe `env` and `model`. The prompt field always appears blank in the UI but works correctly in the DB. Regina does not use `instructionsFilePath` — her prompt must be restored via DB patch (concatenate AGENTS.md + SOUL.md + HEARTBEAT.md).
- **Hugh (gemini_local adapter)**: Uses `gemini_local` with model `auto`.
- Prompts can be restored via `kubectl exec` against the Paperclip Postgres DB (see COMPANY.md for the command).
## Conventions
- Agent prompts are stored in the `## Prompt` section of each markdown file
- All agents use `claude_local` adapter except Regina who uses `opencode_local`
- Agent prompts are split across `AGENTS.md` (bootstrap), `SOUL.md` (persona), and `HEARTBEAT.md` (execution)
- Adapters: `claude_local` (CEO, CTO, CMO, Gandalf, Samuel), `gemini_local` (Hugh), `opencode_local` (Regina)
- Agents interact via Paperclip issues (`pnpm paperclipai issue ...`) and GitHub PRs/issues (`gh ...`)
- Org hierarchy: CEO (Countess) → CTO (Nancy) + CMO (Addison) → Engineers + Marketing