AI Workflow ยท Portfolio

Turning a Missed Portfolio Detail into Content Reachability Validation

A note on replacing a narrow AI-proposed heuristic with a deploy-time check that every public post and portfolio detail has a reachable path.

May 31, 2026

Trigger

During the Astro portfolio migration, a project card looked fine but opened only a one-line summary. The detailed HotDealppom content still existed, but users could not reach the video, screenshots, and technical record from the card.

User Correction

The first AI fix checked whether a modal target was a list item. That solved one symptom but not the real rule. The better requirement was that every non-intentionally-hidden content item must have a public reachable path.

Fix

  • Replaced the portfolio-only heuristic with `validate:content`.
  • Validated built post routes, tag/index reachability, and localized portfolio detail reachability.
  • Kept intentionally hidden records in an explicit declaration list.
  • Added the work back to the portfolio as an AI collaboration quality-gate example.