FS - Roosloot.com

Version: 0.7
Date: March 8, 2026
Author: Rens Roosloot

1. Purpose

This Functional Specification (FS) translates URS.md requirements into explicit, testable functional behavior.

In scope:

Out of scope:

The homepage (site/index.html) shall provide:
- concise introduction
- featured projects section
- work section
- contact section

site/projects.html shall list project categories and link to project detail pages.

site/visuals.html shall list visual experiments and link to their detail pages.

site/work.html and homepage work cards shall provide professional links and internal work navigation.

Header links shall navigate to:
- index.html#about
- projects.html
- work.html
- index.html#contact
Brand shall always link to index.html.

site/docs/index.html shall provide entry points for core docs, game docs, and visual docs.
Major project documentation sets shall expose one public entry page per project where relevant, including site/docs/swapbound.html and site/voxel-cutaway-world/docs/index.html.
Rendered documentation pages shall be reachable in site/docs/:
- urs.html
- fs.html
- ds.html
- risk-assessment.html
- test-plan.html
- iq.html
- oq.html
- agents.html

All production runtime functionality shall resolve from within site/.
Reusable authoring templates may live outside site/, but they shall not be exposed as public website pages.

Functional scope changes shall update impacted V-model docs in the same change:
- URS.md
- FS.md
- DS.md
- RISK_ASSESSMENT.md
- TEST_PLAN.md
- IQ.md
- OQ.md
- AGENTS.md
Updated markdown docs shall be rendered to matching pages in site/docs/ via npm run docs:render.

Release-candidate changes shall be verified through automated checks:
- npm run test:e2e
IQ and OQ outcomes shall be reflected in IQ.md and OQ.md.

Each FS item shall be linked to one or more OQ and/or IQ checks in OQ.md and IQ.md.

site/visuals-ascii-star-runner.html shall render a layered parallax scene (sky/clouds, far mountains, mid mountains, ASCII foreground terrain).
The UFO craft shall remain horizontally fixed and adjust vertical position relative to foreground terrain height.
Controls shall include ASCII density, parallax speed, hill height, flight clearance, follow response, ASCII mountain toggle, mountain groove length, and mountain groove width.
Mountain groove rendering shall remain visually stable during scrolling (no obvious jitter/flicker under normal parameter ranges).

site/swapbound/game.html may implement a hand-built local co-op prototype separate from published project navigation while gameplay mechanics are still being validated.
The prototype functional scope includes split-control character movement, checkpoints/respawn, one movable block puzzle, one switch/bridge interaction, one control-remap trigger, and one exit/win condition.
Prototype test features may include developer-facing room jump controls to accelerate manual iteration without affecting the core mechanic.

site/visuals.html shall serve as the public hub for visual experiments, including site/voxel-cutaway-world/index.html.
site/docs/index.html shall link to project-level documentation pages instead of repeating individual game/visual spec links directly in the hub cards.
Project-local documentation pages may be published outside site/docs/ when they belong to a standalone project subtree and remain reachable from the docs hub.