Chris Farhood
922f123d84
Add project instructions for Claude Code and remove the samuel-stinkpost.md that was already moved in a prior rename commit. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
34 lines
1.9 KiB
Markdown
34 lines
1.9 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## What This Repo Is
|
|
|
|
This is the **agent roster repository** for Privileged Escalation, an open source software company building Headlamp plugins for Kubernetes (GitHub org: `privilegedescalation`). It contains canonical definitions for all Paperclip AI agents — their identities, prompts, adapter configs, and heartbeat settings.
|
|
|
|
There is no application code, build system, or test suite in this repo. It is a documentation/configuration repo.
|
|
|
|
## Repository Structure
|
|
|
|
- `COMPANY.md` — Agent roster table, known operational issues, and restore procedures
|
|
- `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)
|
|
|
|
Each agent file contains: Identity table (ID, role, adapter), Heartbeat config, Adapter config, and the full Prompt.
|
|
|
|
## 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.
|
|
- 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`
|
|
- Agents interact via Paperclip issues (`pnpm paperclipai issue ...`) and GitHub PRs/issues (`gh ...`)
|
|
- Org hierarchy: CEO (Countess) → CTO (Nancy) + CMO (Addison) → Engineers + Marketing
|