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

chore: remove Samuel, reduce per-heartbeat token load

Browse Source 
- Remove Samuel Stinkpost (terminated) from all files and delete marketing/samuel/
- Update PEM listing in OPERATIONS.md to the 4 role-based keys
- POLICIES.md and TOOLS.md are now conditional reads (only when agents have work to do), not loaded on every heartbeat
- Split product/SOUL.md: core identity stays in SOUL.md, reference material (plugin portfolio, competitive landscape, evaluation framework, spec template) moved to PRODUCT-CONTEXT.md
- CLAUDE.md improvements: add OPERATIONS.md/POLICIES.md/TOOLS.md references, fix adapter list, add PR workflow, document opencode.json purpose

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Chris Farhood
2026-03-25 07:41:51 -04:00
parent e56a6bd9ef
commit 674be5d762
19 changed files with 184 additions and 496 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+21 -3
View File
@@ -11,6 +11,9 @@ There is no application code, build system, or test suite in this repo. It is a
## Repository Structure
- `COMPANY.md` — Agent roster table, known operational issues, and restore procedures
- `OPERATIONS.md` — Pod operations runbook: initial setup, adding agents, credential symlinks, routine maintenance
- `POLICIES.md` — Shared policies for all agents: git workflow, PR process, infrastructure rules, issue tracking
- `TOOLS.md` — Shared tools registry: CLI tools, repos, MCP servers, GitHub Actions runners
- `ceo/` — CEO agent (Countess von Containerheim)
- `cto/` — CTO agent (Null Pointer Nancy)
- `cmo/` — CMO agent (Addison Addington)
@@ -20,7 +23,7 @@ There is no application code, build system, or test suite in this repo. It is a
- `engineering/patty/` — UAT Engineer (Pixel Patty)
- `engineering/regina/` — QA Engineer (Regression Regina)
Each agent directory contains 5 files:
Each agent directory contains these standard files:
| File | Purpose |
|---|---|
@@ -29,6 +32,9 @@ Each agent directory contains 5 files:
| `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 |
| `opencode.json` | Runtime config for `opencode_local` agents (model, MCP servers, permissions) |
`product/` additionally contains `.mcp.json` (MCP server config for `claude_local`). MCP config lives in `.mcp.json` for `claude_local` agents and in `opencode.json` for `opencode_local` agents.
## Infrastructure Policy
@@ -39,12 +45,24 @@ Each agent directory contains 5 files:
- **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 (claude_local adapter)**: Uses `claude_local` with `claude-sonnet-4-6` and high effort. Reads prompt via `instructionsFilePath`.
- **Gandalf & Hugh (opencode_local adapter)**: UI saves wipe `env` and `model`. The prompt field always appears blank in the UI but works correctly in the DB. They do not use `instructionsFilePath` — prompts must be restored via DB patch (concatenate AGENTS.md + SOUL.md + HEARTBEAT.md).
- **opencode_local agents (CMO, Gandalf, Hugh, Patty)**: UI saves wipe `env` and `model`. The prompt field always appears blank in the UI but works correctly in the DB. They do not use `instructionsFilePath` — prompts must be restored via DB patch (concatenate AGENTS.md + SOUL.md + HEARTBEAT.md).
- Prompts can be restored via `kubectl exec` against the Paperclip Postgres DB (see COMPANY.md for the command).
- **This repo is read-only to agents** — only the board may approve and merge changes to agent configurations and prompts. Always include `cc @cpfarhood` at the bottom of any PR body.
## Conventions
- Agent prompts are split across `AGENTS.md` (bootstrap), `SOUL.md` (persona), and `HEARTBEAT.md` (execution)
- Adapters: `claude_local` (CEO, CTO, Regina), `opencode_local` (CMO, Gandalf, Hugh, Patty)
- Adapters: `claude_local` (CEO, CTO, VP Product, Regina), `opencode_local` (CMO, Gandalf, Hugh, Patty)
- Agents interact via Paperclip issues (`pnpm paperclipai issue ...`) and GitHub PRs/issues (`gh ...`)
- Org hierarchy: CEO (Countess) → CTO (Nancy) + CMO (Addison) → Engineers + Marketing
- GitHub Actions CI uses self-hosted ARC runners: `runs-on: runners-privilegedescalation`
## PR Workflow (mandatory order)
1. **CI passes** (lint, types, unit tests)
2. **Patty (UAT)** validates E2E against `privilegedescalation-dev`
3. **Regina (QA)** reviews code — test coverage, regressions, edge cases
4. **Nancy (CTO)** reviews — architecture, code quality, security
5. **Countess (CEO)** merges — only after UAT + QA + CTO have all approved
Each stage gates the next. No agent merges their own PRs. See `POLICIES.md` for full details.