Lucas WintherandClaude Opus 5.5
843b6d32bc
Add AGENTS.md as the single source of truth (with CLAUDE.md and GEMINI.md as pointers), permissions for Claude Code, Codex and Gemini, the docs tree (architecture, decisions, TODO, permissions, specs, plans), PRODUCT.md and DESIGN.md, plus the design-phase record: the inspiration log, all mockup rounds with briefs and screenshots, and the owner's work history. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.8 KiB
Architecture
How portfolio-next is built today. Update in the same commit as any structural change.
Overview
There is no application code yet. The repo holds the design phase: a taste log, HTML mockups and
the owner's work history. The chosen mockups define the site: a start page with two gates that lead
into a technical space and a personal space. The planned implementation (Astro + React islands on
Bun, static output) is recorded in docs/DECISIONS.md and will be specified in docs/specs/.
Map
| Path | Responsibility |
|---|---|
docs/inspiration.md |
Taste log: every reference site and mockup round with the owner's verdicts, principles, decisions so far |
mockups/*.html |
Self-contained HTML prototypes, one per file, no build step |
mockups/nav-d.html |
Chosen start page: two gates plus a small "everything at once" link |
mockups/tech-r3-c.html |
Chosen work space: dark showcase, featured panels, project list with side sheet |
mockups/personal-r2-b.html |
Chosen personal space: "now" strip and a curated wall of typed cards |
mockups/BRIEF*.md |
Briefs the mockup rounds were built from |
mockups/shots/ |
Screenshots of every mockup |
extra_info.txt |
Owner-maintained real work history |
Data flow
Mockups link to each other with relative links: nav-d → tech-r3-c / personal-r2-b; each space
links back to the gate and across to the other space. No data is fetched; all content is inline.
External dependencies
Mockups load Google Fonts only (Geist, Geist Mono, IBM Plex, Fraunces, Caveat). Offline they fall back to system fonts.
Invariants
- Content about the owner is either real (from
extra_info.txt, his Bluesky, or his statements indocs/inspiration.md) or a visibly marked placeholder. - Motion only on visitor action; no loading screens.
Known rough edges
See docs/TODO.md.