Rebuild Or Improve Advisor
This skill converts existing-site evidence into a strategy decision. It does not implement the redesign and does not change production systems.
Operating Modes
decision: choose improve, redesign, partial rebuild, or full rebuild.tradeoff: compare strategy options with risks, costs, and proof needed.handoff: prepare next steps for migration-planner, marketing-site-skill, webapp-ui-skill, or senior-ui-ux-orchestrator.council-input: prepare a concise position for senior council when UX, SEO, migration, or business constraints conflict.
Required Workflow
- Read references/rebuild-decision-contract.md.
- Start from an
existing-site-analyzer report or clearly label missing evidence.
- Compare options:
- improve in place;
- visual redesign on current stack;
- partial rebuild;
- full rebuild and migration.
- Use assets/rebuild-decision-record.template.md.
- If URLs, redirects, canonical pages, sitemap, robots, schema, or GSC/webmaster verification may change, require
migration-planner.
- If the recommendation affects SEO/LLM, public facts, or conversion structure, route conflicts to
senior-ui-ux-orchestrator council.
Safety Rules
- Do not recommend full rebuild only because visual design is weak; include migration and maintainability tradeoffs.
- Do not recommend in-place improvements when severe technical, content, or SEO issues make that unsafe.
- Do not claim search traffic, rankings, or conversion data unless source evidence exists.
- Do not change production files, redirects, analytics, DNS, CMS, or deployment settings.
Handoff Shape
Decision:
Evidence used:
Options compared:
Recommended path:
Why not the alternatives:
Migration planner required:
Implementation owner:
Validation gates:
Open risks:
Validation
When editing this skill, run:
python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/rebuild-or-improve-advisor
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/rebuild-or-improve-advisor
python3 -m json.tool $CODEX_HOME/skills/rebuild-or-improve-advisor/evals/evals.json >/dev/null
1---2name: rebuild-or-improve-advisor3description: Decide whether an existing site should be improved in place, redesigned, partially rebuilt, or fully rebuilt after an evidence-backed audit. Use when the project needs a governed improve/redesign/rebuild recommendation balancing UX, SEO/LLM, migration risk, technical debt, timeline, and implementation cost.4---56# Rebuild Or Improve Advisor78This skill converts existing-site evidence into a strategy decision. It does not implement the redesign and does not change production systems.910## Operating Modes1112- `decision`: choose improve, redesign, partial rebuild, or full rebuild.13- `tradeoff`: compare strategy options with risks, costs, and proof needed.14- `handoff`: prepare next steps for `migration-planner`, `marketing-site-skill`, `webapp-ui-skill`, or `senior-ui-ux-orchestrator`.15- `council-input`: prepare a concise position for senior council when UX, SEO, migration, or business constraints conflict.1617## Required Workflow18191. Read [references/rebuild-decision-contract.md](references/rebuild-decision-contract.md).202. Start from an `existing-site-analyzer` report or clearly label missing evidence.213. Compare options:22 - improve in place;23 - visual redesign on current stack;24 - partial rebuild;25 - full rebuild and migration.264. Use [assets/rebuild-decision-record.template.md](assets/rebuild-decision-record.template.md).275. If URLs, redirects, canonical pages, sitemap, robots, schema, or GSC/webmaster verification may change, require `migration-planner`.286. If the recommendation affects SEO/LLM, public facts, or conversion structure, route conflicts to `senior-ui-ux-orchestrator` council.2930## Safety Rules3132- Do not recommend full rebuild only because visual design is weak; include migration and maintainability tradeoffs.33- Do not recommend in-place improvements when severe technical, content, or SEO issues make that unsafe.34- Do not claim search traffic, rankings, or conversion data unless source evidence exists.35- Do not change production files, redirects, analytics, DNS, CMS, or deployment settings.3637## Handoff Shape3839```text40Decision:41Evidence used:42Options compared:43Recommended path:44Why not the alternatives:45Migration planner required:46Implementation owner:47Validation gates:48Open risks:49```5051## Validation5253When editing this skill, run:5455```bash56python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/rebuild-or-improve-advisor57python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/rebuild-or-improve-advisor58python3 -m json.tool $CODEX_HOME/skills/rebuild-or-improve-advisor/evals/evals.json >/dev/null59```
sergekostenchuk