Spec-driven portfolio platform

This site is a real working platform for professional identity, selected work, and long-form technical writing. It uses a constrained design system and a specification-first workflow so content and implementation evolve from the same source of truth.

The system enforces:

• a strict tokenized color palette,
• a single accent strategy,
• reduced-motion safe animation,
• markdown-backed content collections, and
• a clean route and content model.

The goal is reliable maintenance, strong technical SEO, and readable updates without unnecessary runtime complexity. The site ships zero client-side JavaScript by default: interactions are CSS and every public page is static HTML.

The design, architecture, security, hosting, and SEO specifications live beside the code. Future work starts from documented intent instead of reverse-engineering the current implementation. Cloudflare serves the static output with security headers, canonical redirects, and search-engine discovery controls.

This project also demonstrates an AI-augmented delivery pattern: use AI for analysis and implementation support, keep evidence and decisions explicit, and require human-controlled deployment and account security.

Decisions that mattered

The site is intentionally static because the primary job is professional publishing, not application state. Astro content collections keep projects and articles structured; the shared layout owns canonical URLs, social metadata, JSON-LD, typography, and the security-conscious page shell. Cloudflare handles the edge behavior, headers, redirects, and the small contact endpoint.

The documentation is part of the system rather than an afterthought. Design tokens, content claims, deployment rules, search integrations, and decision history are maintained beside the implementation so future changes can be checked against the original constraints.

What this shows

This project is the public example of my AI-augmented engineering workflow: use agents for focused implementation and review, but keep the evidence, source of truth, and deployment decisions under human control. It also keeps the site’s SEO work visible and auditable instead of relying on vague optimization claims.