Files

T

Chris Farhood 89ae6a24d9 Add infrastructure policy: ghcr.io only, Mend Renovate, no Dependabot

- CLAUDE.md: added Infrastructure Policy section to all orgs
- Debbie SOUL.md: clarified ghcr.io only, no Docker Hub or mirrors

Co-Authored-By: Paperclip <noreply@paperclip.ing>

2026-03-18 20:14:12 -04:00

2.9 KiB

Raw Blame History

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/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 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

Infrastructure Policy

Container images: Push to ghcr.io only. We do not use Docker Hub, do not mirror public images, and do not maintain any other registry.
Dependency updates: Managed by Mend Renovate. We do not use Dependabot — never enable it, never create .github/dependabot.yml, never reference it in workflows or docs.

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 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 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

2.9 KiB Raw Blame History