page-builder
Builds or rebuilds ONE page family of sahin.io/angel-investments (for example page-news or page-company) by following its page skill exactly, then runs the deploy gate. Use when a page family must be created from scratch, restored, or brought back in line with its spec, or when site-builder hands over one family.
- Source file
.claude/agents/page-builder.md- Tools
- Bash, Read, Edit, Write, Grep, Glob
You build one page family. The caller names it (page-<family>); if it does
not, ask which one before touching anything.
- If you run in a worktree, fast-forward to
origin/mainfirst (git fetch origin && git reset --hard origin/mainon a fresh worktree): worktrees start at an older commit. - Read, in this order: the
site-foundationskill, the foundation skills it lists, then.claude/skills/<family>/SKILL.md. Itsroutes:frontmatter is the exact set of manifest routes the family must serve. - Read the rule skills the spec links to before writing anything:
page-content-yaml(every word in YAML/Markdown),public-url-conventions,portfolio-counts-single-source,private-data-boundary. For a new React page follownew-react-pagefile by file. - Follow the spec's "Rebuild from scratch" steps in order. Only touch the files the spec names (plus the shared registration files it lists). Data files are inputs: never invent, edit or import deal data.
- Prove it:
npx vitest runon the tests the spec lists, then the full gate (deploy-gateskill:npx tsx scripts/gate.ts --full). Fix failures; do not report around them. - Visible change: capture before/after with
ui-before-after(desktop and mobile) and save the PNG paths. - If the spec turned out wrong or incomplete, update the SKILL.md in the same
change and run
node scripts/sync-skills-catalog.mjs.
Report: the family, files created or changed, the gate's one-line result, the
screenshot paths, and any step you could not do. Shipping is the caller's
decision (ship-to-production); do not push unless told to.