#118 - Phase 16: Agent Model Completion — Penny config + worktree pollution fix - ldraney/claude-custom

forgejo_admin commented

2026-03-17 03:06:40 +00:00

Contributor

Lineage

plan-pal-e-agency → Phase 16 (Agent Model Completion)
Absorbs: todo-penny-claude-config, bug-claude-custom-worktree-pollution

Repo

forgejo_admin/claude-custom

User Story

As a session coordinator (Betty Sue)
I want all 5 agents in the operating model to have runtime configs and clean worktree behavior
So that I can spawn Penny for comms work and dev agents don't pollute the main checkout

Context

The 5-agent model (Betty Sue, Dev, QA, Dottie, Penny) was validated in Phase 12 but Penny has no runtime config in claude-custom/agents/. She's defined in pal-e-docs (agent-penny) with frontmatter fields, MCP servers, and constraints — but can't be spawned without the config file.

Separately, dev agents targeting claude-custom check out feature branches directly in ~/claude-custom instead of isolated worktrees. Because ~/.claude/hooks/ symlinks to ~/claude-custom/hooks/, in-progress hooks go live before merge. Observed 3 times (PR #58, issue #59, branch 115 left dirty 2026-03-16).

File Targets

Files to create:

agents/penny.md — new agent config (match agents/dottie.md format exactly)

Files to modify:

CLAUDE.md — add instruction: "Always clone to /tmp/claude-custom-{branch} for development. Never work in ~/claude-custom directly."

Files NOT to touch:

agents/betty-sue.md, agents/dev.md, agents/qa.md, agents/dottie.md — verify they exist but do not modify
hooks/ — no hook changes in this issue

Acceptance Criteria

agents/penny.md exists with valid frontmatter (name: penny, disallowedTools: Write/Edit/Bash/NotebookEdit, mcpServers: pal-e-docs + notion, model: inherit)
agents/penny.md body has sections: Role, Access table, MCP Tools, Code Tools, Constraints, Output (match dottie.md structure)
All 5 agent configs exist: betty-sue.md, dev.md, qa.md, dottie.md, penny.md
CLAUDE.md includes worktree isolation instruction for dev agents
No .deprecated files removed (cleanup is separate scope)

Test Expectations

Manual: verify penny.md frontmatter parses correctly (valid YAML between --- fences)
Manual: verify CLAUDE.md instruction is clear and unambiguous
Run command: n/a (config files, no executable tests)

Constraints

Match agents/dottie.md format exactly — Dottie is the closest analog (non-code agent)
Source of truth for Penny's definition: get_note(slug="agent-penny") in pal-e-docs
Source of truth for exact frontmatter spec: get_note(slug="todo-penny-claude-config") in pal-e-docs
Only include MCP servers that are currently deployed: pal-e-docs and notion. Gmail, GCal, LinkedIn are NOT deployed yet — do not include them.
The CLAUDE.md worktree instruction is the cheapest viable fix. Do NOT break the symlink or modify hooks — those are future options documented in bug-claude-custom-worktree-pollution.

Checklist

PR opened
No unrelated changes
penny.md frontmatter valid
CLAUDE.md instruction added

plan-pal-e-agency — Phase 16
todo-penny-claude-config — exact spec
bug-claude-custom-worktree-pollution — root cause analysis
agent-penny — pal-e-docs definition
project-pal-e-agency — parent project

### Lineage `plan-pal-e-agency` → Phase 16 (Agent Model Completion) Absorbs: `todo-penny-claude-config`, `bug-claude-custom-worktree-pollution` ### Repo `forgejo_admin/claude-custom` ### User Story As a session coordinator (Betty Sue) I want all 5 agents in the operating model to have runtime configs and clean worktree behavior So that I can spawn Penny for comms work and dev agents don't pollute the main checkout ### Context The 5-agent model (Betty Sue, Dev, QA, Dottie, Penny) was validated in Phase 12 but Penny has no runtime config in `claude-custom/agents/`. She's defined in pal-e-docs (`agent-penny`) with frontmatter fields, MCP servers, and constraints — but can't be spawned without the config file. Separately, dev agents targeting claude-custom check out feature branches directly in `~/claude-custom` instead of isolated worktrees. Because `~/.claude/hooks/` symlinks to `~/claude-custom/hooks/`, in-progress hooks go live before merge. Observed 3 times (PR #58, issue #59, branch 115 left dirty 2026-03-16). ### File Targets Files to create: - `agents/penny.md` — new agent config (match `agents/dottie.md` format exactly) Files to modify: - `CLAUDE.md` — add instruction: "Always clone to `/tmp/claude-custom-{branch}` for development. Never work in `~/claude-custom` directly." Files NOT to touch: - `agents/betty-sue.md`, `agents/dev.md`, `agents/qa.md`, `agents/dottie.md` — verify they exist but do not modify - `hooks/` — no hook changes in this issue ### Acceptance Criteria - [ ] `agents/penny.md` exists with valid frontmatter (name: penny, disallowedTools: Write/Edit/Bash/NotebookEdit, mcpServers: pal-e-docs + notion, model: inherit) - [ ] `agents/penny.md` body has sections: Role, Access table, MCP Tools, Code Tools, Constraints, Output (match dottie.md structure) - [ ] All 5 agent configs exist: betty-sue.md, dev.md, qa.md, dottie.md, penny.md - [ ] CLAUDE.md includes worktree isolation instruction for dev agents - [ ] No `.deprecated` files removed (cleanup is separate scope) ### Test Expectations - [ ] Manual: verify penny.md frontmatter parses correctly (valid YAML between --- fences) - [ ] Manual: verify CLAUDE.md instruction is clear and unambiguous - Run command: n/a (config files, no executable tests) ### Constraints - Match `agents/dottie.md` format exactly — Dottie is the closest analog (non-code agent) - Source of truth for Penny's definition: `get_note(slug="agent-penny")` in pal-e-docs - Source of truth for exact frontmatter spec: `get_note(slug="todo-penny-claude-config")` in pal-e-docs - Only include MCP servers that are currently deployed: `pal-e-docs` and `notion`. Gmail, GCal, LinkedIn are NOT deployed yet — do not include them. - The CLAUDE.md worktree instruction is the cheapest viable fix. Do NOT break the symlink or modify hooks — those are future options documented in `bug-claude-custom-worktree-pollution`. ### Checklist - [ ] PR opened - [ ] No unrelated changes - [ ] penny.md frontmatter valid - [ ] CLAUDE.md instruction added ### Related - `plan-pal-e-agency` — Phase 16 - `todo-penny-claude-config` — exact spec - `bug-claude-custom-worktree-pollution` — root cause analysis - `agent-penny` — pal-e-docs definition - `project-pal-e-agency` — parent project