Phase 1: Doc Drift Audit + Agent Alignment
Phase 1: Doc Drift Audit + Agent Alignment
Goal: Fix doc drift from pal-e-agency Phase 12 consolidation — align agent notes and SOPs to the actual 5-agent model (4 configs in claude-custom).
Owner: Dottie (documentation execution under Betty Sue's direction)
Repo: n/a (docs-only work in pal-e-docs)
Depends on: None
Scope
- Deprecate 6 stale specialized agent notes: agent-dev-frontend, agent-dev-backend, agent-devops, agent-frontend-qa, agent-dev-qa, agent-devops-qa
- Update agent-spawn-conventions to match agent-workflow (5-agent model: Betty Sue, Penny, Dev, QA, Dottie)
- Verify Penny's status — note exists in pal-e-docs but no config in claude-custom. Clarify: is Penny active or aspirational?
- Audit pal-e-agency done TODOs (22 notes) — confirm they're truly resolved, no orphan references
Deliverables
- 6 stale agent notes deprecated —
agent-dev-frontend,agent-dev-backend,agent-devops,agent-frontend-qa,agent-dev-qa,agent-devops-qa. All set to status=deprecated, tags=agent,deprecated. - agent-spawn-conventions updated to 5-agent model — "Nine Agents" heading changed to "Five Agents". Agent table, Access Scope table, When to Spawn table, and Deprecated section all updated to reflect Betty Sue, Penny, Dev, QA, Dottie. Explanatory text updated to describe dynamic domain expertise model.
- Penny clarified as active (not aspirational) — Penny appears in all agent-spawn-conventions tables with note that she is defined but not yet wired (no claude-custom config).
- TODO created:
todo-penny-claude-config— tracks the gap: Penny needs a claude-custom/agents/penny.md config to be spawnable. - Deferred: 22 done TODO audit — out of scope for this phase. Can be a subphase later.
Related
plan-2026-03-16-knowledge-architecture— parent planplan-pal-e-agencyPhase 12 — "consolidated to 5-agent model" but docs never updatedagent-workflow— the authoritative 5-agent SOPagent-spawn-conventions— currently shows 9-agent model (stale)