feat: split dev agent into dev-frontend + dev-backend, install impeccable skills

### Lineage `plan-pal-e-posts` → Phase 0 (Agent Frontmatter + Impeccable Skills) ### Repo `forgejo_admin/claude-custom` ### User Story As Betty Sue I want specialized dev-frontend and dev-backend agent frontmatter files with impeccable design skills installed So that I can spawn the right agent for frontend vs backend work (Phase 1 needs dev-frontend for gcal-scheduler booking UI) ### Context The six-agent model splits Dev into Dev-Frontend (SvelteKit, impeccable design) and Dev-Backend (Python, FastAPI, IaC). Agent frontmatter files in `agents/` must exist before Claude Code can spawn them. The impeccable skills (from `/tmp/impeccable/.claude/skills/`) provide a curated design system for frontend work — typography, color, spatial design, motion, interaction, responsive, and UX writing references. The old `dev.md` agent should be deprecated since it's replaced by the two specialized agents. ### File Targets Files to create: - `agents/dev-frontend.md` — frontend agent frontmatter pointing to `agent-dev-frontend` pal-e-docs note - `agents/dev-backend.md` — backend agent frontmatter pointing to `agent-dev-backend` pal-e-docs note - `skills/frontend-design/` — design skill with 7 reference files (copy from impeccable) - `skills/audit/` — quality audit skill (copy from impeccable) - `skills/polish/` — final polish skill (copy from impeccable) - `skills/bolder/`, `skills/colorize/`, `skills/optimize/`, `skills/critique/`, `skills/harden/`, `skills/clarify/`, `skills/distill/`, `skills/normalize/` — remaining impeccable skills - `skills/adapt/`, `skills/animate/`, `skills/delight/`, `skills/extract/`, `skills/onboard/`, `skills/quieter/`, `skills/teach-impeccable/` — full set Files to deprecate: - `agents/dev.md` → rename to `agents/dev.md.deprecated` Files NOT to touch: - `agents/betty-sue.md`, `agents/dottie.md`, `agents/qa.md` — existing agents unchanged - `hooks/` — no hook changes - `skills/board-add/`, `skills/board-status/`, `skills/board-sync/` — existing skills unchanged ### Acceptance Criteria - [ ] `~/.claude/agents/dev-frontend.md` exists and is valid YAML frontmatter - [ ] `~/.claude/agents/dev-backend.md` exists and is valid YAML frontmatter - [ ] `~/.claude/skills/frontend-design/SKILL.md` exists with 7 reference files - [ ] All 18 impeccable skills copied to `skills/` - [ ] `agents/dev.md` renamed to `agents/dev.md.deprecated` - [ ] Spawning `dev-frontend` or `dev-backend` agent works (frontmatter parses correctly) ### Test Expectations - [ ] Manual: verify YAML frontmatter parses (no syntax errors) - [ ] Manual: verify symlinks resolve (ls ~/.claude/agents/ shows new files) - [ ] Manual: verify skill count (ls ~/.claude/skills/ shows 9 existing + 18 new = 27 dirs) ### Constraints - Agent frontmatter must include `mcpServers: [forgejo]` and `isolation: worktree` - Skills are copied verbatim from `/tmp/impeccable/.claude/skills/` — no modifications - `~/.claude/` is symlinked to `~/claude-custom/` so changes are immediately live ### Checklist - [ ] PR opened - [ ] No unrelated changes ### Related - `pal-e-agency` — project (six-agent model) - `plan-pal-e-posts` — first LinkedIn post plan

forgejo_admin commented

2026-03-14 21:09:47 +00:00

Contributor

Lineage

plan-pal-e-posts → Phase 0 (Agent Frontmatter + Impeccable Skills)

Repo

forgejo_admin/claude-custom

User Story

As Betty Sue
I want specialized dev-frontend and dev-backend agent frontmatter files with impeccable design skills installed
So that I can spawn the right agent for frontend vs backend work (Phase 1 needs dev-frontend for gcal-scheduler booking UI)

Context

The six-agent model splits Dev into Dev-Frontend (SvelteKit, impeccable design) and Dev-Backend (Python, FastAPI, IaC). Agent frontmatter files in agents/ must exist before Claude Code can spawn them. The impeccable skills (from /tmp/impeccable/.claude/skills/) provide a curated design system for frontend work — typography, color, spatial design, motion, interaction, responsive, and UX writing references. The old dev.md agent should be deprecated since it's replaced by the two specialized agents.

File Targets

Files to create:

agents/dev-frontend.md — frontend agent frontmatter pointing to agent-dev-frontend pal-e-docs note
agents/dev-backend.md — backend agent frontmatter pointing to agent-dev-backend pal-e-docs note
skills/frontend-design/ — design skill with 7 reference files (copy from impeccable)
skills/audit/ — quality audit skill (copy from impeccable)
skills/polish/ — final polish skill (copy from impeccable)
skills/bolder/, skills/colorize/, skills/optimize/, skills/critique/, skills/harden/, skills/clarify/, skills/distill/, skills/normalize/ — remaining impeccable skills
skills/adapt/, skills/animate/, skills/delight/, skills/extract/, skills/onboard/, skills/quieter/, skills/teach-impeccable/ — full set

Files to deprecate:

agents/dev.md → rename to agents/dev.md.deprecated

Files NOT to touch:

agents/betty-sue.md, agents/dottie.md, agents/qa.md — existing agents unchanged
hooks/ — no hook changes
skills/board-add/, skills/board-status/, skills/board-sync/ — existing skills unchanged

Acceptance Criteria

~/.claude/agents/dev-frontend.md exists and is valid YAML frontmatter
~/.claude/agents/dev-backend.md exists and is valid YAML frontmatter
~/.claude/skills/frontend-design/SKILL.md exists with 7 reference files
All 18 impeccable skills copied to skills/
agents/dev.md renamed to agents/dev.md.deprecated
Spawning dev-frontend or dev-backend agent works (frontmatter parses correctly)

Test Expectations

Manual: verify YAML frontmatter parses (no syntax errors)
Manual: verify symlinks resolve (ls ~/.claude/agents/ shows new files)
Manual: verify skill count (ls ~/.claude/skills/ shows 9 existing + 18 new = 27 dirs)

Constraints

Agent frontmatter must include mcpServers: [forgejo] and isolation: worktree
Skills are copied verbatim from /tmp/impeccable/.claude/skills/ — no modifications
~/.claude/ is symlinked to ~/claude-custom/ so changes are immediately live