Context
The old GitHub Pages portfolio, tag pages, and post detail pages did not feel like one coherent interface. Header density, spacing, and page framing changed from page to page.
The issue was not only visual. Future AI sessions needed to understand why the layout choice was made instead of repeating the same debate.
Decision
- Keep one shared HTML structure and adapt density and layout by viewport instead of creating separate device-specific pages.
- Make portfolio, tag, and post headers consistent, while letting page copy and content carry the difference.
- When a UI, build, deploy, or workflow decision becomes reusable, record it as an AI Workflow note or handoff memo.
Result
The layout became easier to scan across desktop and mobile, and the handoff rule now tells future sessions to check past notes and git history before making the same decision again.