repo-revamp repo-revamp v1.0.1

Generated

Reference

Every component in the repository, read from the files themselves at build time.

This page is generated at build time from the files in the repository. Every command, agent, reference file, template and script below exists in the tree; the counts are computed by scripts/build_site.py, not typed by hand.

Commands

5 slash commands. Each one loads the skill and drives part of the state machine.

  • revamp-batchPlan and run a batch revamp — one agent per repository, deploys serialisedcommands\revamp-batch.md
  • revamp-deployWalk the deployment for a revamped repository, including the owner-only stepscommands\revamp-deploy.md
  • revamp-statusShow the revamp state — phase, gates, open questions, leftoverscommands\revamp-status.md
  • revamp-verifyRun the revamp verification recipe against a live site or a local docs directorycommands\revamp-verify.md
  • revampStart or resume a repository revamp — recon, spec, build, deploy, verifycommands\revamp.md

Agents

3 subagents. One builds, one investigates, one verifies.

  • repo-investigatorRead-only investigation for a repository revamp — recon, feature and configuration inventory, hosting and subdomain options, risks, and a numbered spec with a recommendation per question. Use before any build, when the scope or the facts are not yet established.agents\repo-investigator.md
  • revamp-verifierIndependently verify a completed revamp — the product boundary, the deterministic build, the live URLs, the served commit, the claims ledger and the legal texts — and report CONFIRMED, UNVERIFIED and NOT DONE. Use after an implementer reports shipped, before the orchestrator relays anything.agents\revamp-verifier.md
  • site-builderBuild the public site for a repository revamp in its own worktree — the generated docs/ site, the deterministic builder, the reviewed screenshot set, the design system, SEO and the README — then commit, push and open a draft PR. Use when a revamp spec is approved and one implementer must build the site. Never merges or deploys.agents\site-builder.md

Reference files

17 reference files, numbered 00 to 16. Each carries the depth for one phase or one concern.

  • 00-project-profile.md00 — The project profileskills\repo-revamp\references\00-project-profile.md
  • 01-intake.md01 — INTAKE: read-only reconskills\repo-revamp\references\01-intake.md
  • 02-spec.md02 — SPEC: the numbered questions and the binding decisionsskills\repo-revamp\references\02-spec.md
  • 03-build.md03 — BUILD: the page inventory, the build order and the briefskills\repo-revamp\references\03-build.md
  • 04-builder.md04 — The builder: determinism, gates and CIskills\repo-revamp\references\04-builder.md
  • 05-content-truth.md05 — Content truth: the claims ledger, sourcing and what never gets publishedskills\repo-revamp\references\05-content-truth.md
  • 06-screenshots.md06 — The screenshot pipelineskills\repo-revamp\references\06-screenshots.md
  • 07-design.md07 — Design: derived from the product, verified by measurementskills\repo-revamp\references\07-design.md
  • 08-seo.md08 — SEO: metadata, structured data, sitemap and submissionskills\repo-revamp\references\08-seo.md
  • 09-deployment.md09 — Deployment: GitHub Pages and Cloudflare Pagesskills\repo-revamp\references\09-deployment.md
  • 10-pr-and-merge.md10 — PR, merge and the revertskills\repo-revamp\references\10-pr-and-merge.md
  • 11-verification.md11 — Verification: the recipe the orchestrator runs itselfskills\repo-revamp\references\11-verification.md
  • 12-orchestration.md12 — Orchestration: delegation, tracking, handoff and lessonsskills\repo-revamp\references\12-orchestration.md
  • 13-batch-mode.md13 — Batch mode: several repositories at onceskills\repo-revamp\references\13-batch-mode.md
  • 14-pitfalls.md14 — Pitfalls: every trap that bit, with its fixskills\repo-revamp\references\14-pitfalls.md
  • 15-private-repos.md15 — Private repositories: a public site without publishing the sourceskills\repo-revamp\references\15-private-repos.md
  • 16-maintenance.md16 — Maintenance after launchskills\repo-revamp\references\16-maintenance.md

Templates

7 templates. They are the written artifacts the playbook produces: state, spec, both briefs, the PR body, the verify recipe and the managed CLAUDE.md block.

  • BRIEF-INVESTIGATOR.template.mdYou are a READ-ONLY investigator for repo (owner/repo). Deliverable: _revamp/repo/INVESTIGATION-TOPIC.md per `references/templates/SPEC.templat…skills\repo-revamp\references\templates\BRIEF-INVESTIGATOR.template.md
  • BRIEF-SITE-BUILDER.template.mdYou are the SOLE implementer of the public site for repo (owner/repo), repository visibility, default branch default, base SHA sha. ONE bra…skills\repo-revamp\references\templates\BRIEF-SITE-BUILDER.template.md
  • CLAUDE-MD-BLOCK.template.mdHow we revamp repositoriesskills\repo-revamp\references\templates\CLAUDE-MD-BLOCK.template.md
  • PR-BODY.template.mdSpecific title: what this PR addsskills\repo-revamp\references\templates\PR-BODY.template.md
  • SPEC.template.mdSPEC — Product: what this job isskills\repo-revamp\references\templates\SPEC.template.md
  • STATE.template.mdSTATE — reposkills\repo-revamp\references\templates\STATE.template.md
  • VERIFY-RECIPE.template.mdThe verify recipe — run after every "shipped" report, before relayingskills\repo-revamp\references\templates\VERIFY-RECIPE.template.md

Scripts

4 Python files in scripts/. 3 are the plugin's tools; build_site.py is the generator that builds this site.

  • build_site.pyBuild the repo-revamp documentation site into docs/.scripts\build_site.py
  • shots_inventory.pyInventory, de-duplicate and contact-sheet the screenshots of a repository.scripts\shots_inventory.py
  • validate_plugin.pyValidate the plugin repository before publishing.scripts\validate_plugin.py
  • verify_site.pyVerify a revamped site: live or local.scripts\verify_site.py