Assessments.com
A modern Next.js rebuild of Assessments.com that preserves every legacy URL, page, and word of content while replacing the underlying stack — protecting a decade of SEO equity.
Modernize the stack without touching the SEO surface.
Assessments.com sells validated assessments, automated case planning, and reporting tools to the adult/juvenile justice, behavioral health, substance abuse, and school behavior sectors. The legacy site was outdated visually and technically but had a decade of SEO equity that could not be disrupted.
The hard constraints: no URL changes, no content removal, no navigation renames, no page removals. Improve heading hierarchy, meta tags, alt text, and design — but don't lose a single search ranking.
Static export + an enforced parity contract.
Static export (`output: 'export'`) over SSR to guarantee identical HTML at every URL the legacy crawler knew. Scraped legacy content lives verbatim in `docs/content/` and is the source of truth for copy. Reusable React components are allowed but must render proper semantic HTML so the SEO guardrails hold.
The constraint framework was embedded into the AI-agent rules so any developer or AI session would refuse changes that broke parity.
Standards and architecture, build by team.
Honest framing: I authored the project's CLAUDE.md and the overall constraint framework — SEO-preservation rules, engineering philosophy (Visionary Engineer, TDD red-green-refactor, emotional UX), and the workflow that downstream developers and AI sessions followed. Direct commit authorship on the build itself is split with two other Banyan Labs developers. My role is technical-lead / architect, not sole implementer.
- Defined the SEO-preservation contract (no URL changes, no copy removal, no nav renames, no page removals).
- Embedded the contract into the AI-agent framework so any session would refuse changes that broke parity.
- Established the team workflow: verbatim content scraping, an AI-framework kanban, TDD as the implementation default.
What it's built on.
Modern stack, legacy SEO intact.
Live at assessments.com on Next.js 16, React 19, and Firebase Hosting, with the legacy URL surface and content preserved verbatim — a rebuild that protects rather than disrupts.