# PARENT.md — Singular Particular Space
# spaces.exopraxist.org

## Project identity

A personal web gallery styled as a post-apocalypse neo-soviet cyberpunk star-map.
Users explore sections by clicking stars on a night-sky canvas. The aesthetic is:
campfire on the outskirts of a neon city looking up at stars.

Color palette:
- Background: city night sky (deep near-black blues)
- Primary: firelight (amber, coral, warm orange)
- Secondary: neon green and teal
- Accents: deep red, bluish magenta

Navigation: stars as nodes, arrow keys or mouse on desktop, current star glows
orange, visited stars glow green, escape/back button returns to star map.

## Infrastructure

- VPS: OVHCloud Frankfurt, Ubuntu 24.04
- Version control: git.exopraxist.org (Gitea)
- Serving: Coolify reverse proxy → spaces.exopraxist.org
- Large files (>1MB): FileBrowser at files.exopraxist.org
- Video: embedded from external sources (YouTube, etc.), not self-hosted

Do not self-host video. Do not commit files >1MB to git. Use FileBrowser for
large assets and reference by URL.

## Build order

1. Home page (star-map navigation shell)
2. Writings
3. Videos
4. Images
5. Playlists, Watchlists, ToolsnToys, Creatorlists
6. Music, Creature Playground
7. Full site optimization, donation/payment
8. Maintenance and upgrades

Current phase: step 1 — home page.

## Agent roles

Parent agents: (Sonnet/Opus) - commissioning and final testing, (Sonnet/Haiku) - implementation,  tester, refiner, git coordinator.
Designer agents: (Gemini Pro) - master front-end designer, writes instructions for Flash based on input from parent (opus) and/or counterpart (sonnet), (Claude Sonnet) - master full-stack dev, writes instructions for Haiku based on input from parent and/or counterpart. Designer agents may use Creature Playground to co-ordinate with each other and parent. Scions may not. 
Builder scions: (Gemini Flash) master front-end builder, (Claude Haiku): backend systems and security builder - commission as needed based on complexity.
Sorter scion (Haiku): classifies and routes files from DumperCan to ToBuild.
Commit-tracker hook: detects uncommitted changes, writes state flag spores.
JL (human): reviews outputs, offers input and guidance when asked, triggers commits, manages staging, approves handovers. See *-JL-notes.md within modules.
Git scion: manages gitea and github interactions when triggered.
Ad-Hoc/Process scions: create spores or seeds as needed to commission new scions when they encounter repeating issues that need crystallized reasoning from the parent.

## Commissioning skill

Use commissioning-skill/ before spawning any agent or scion. Consult SEEDS.md for
precedent. Compose new spore files when no precedent exists. Use skill-scout
to fetch external skills appropriate to the build task before commissioning
a builder scion. When using skill-scout, simply git clone the necessary folders and files into the skills library. Point your scions and subagents to a skill-index-spore in their spores to empower them to access only the skills they need for their tasks.

## skills library

The /skills folder contains a library of skills collected for use in the project. There is a skill-library-index-spores.md for scions and subagents to understand and use. Assign and use as needed.

## Designer Agents

Parent: Write a GEMINI.md and SONNET.md to keep each designer focused and specialized enoough to integrate into the system. Do this BEFORE spawning the first instance. Use these files to help the agents learn from mistakes.

Use seeds files as specified, allocate tasks with minimal overlap, ask parent to resolve conflicts, use playground to communicate and co-ordinate across instances without confusing scions in their folders. Reference files in the playground may be edited and revised at your discretion.

## Handover discipline

Each module must reach this state before JL triggers a commit:
- Built page passes visual review in staging environment
- Home Page and nivigation is updated to access newly built module.
- Gitea webhook confirmed active for this module path
- SEEDS.md updated if any new scion decisions were made
- Relevant spore files updated or appended

## Section overview

Sections map to star nodes on the home page. Each section is a self-contained
HTML page (or folder of pages) that links back to the star map.

- Writings: html annotated writings, organized as stories/essays/miscellany
- Videos: embedded youtube or downloadable, Clipgrab instructions at bottom
- Images: Graphics/Photos/Art, public domain, slideshow mode, fullscreen
- Music: gallery of tracks, play or download, shuffle-play
- Playlists: curated playlists, bandcamp/spotify/youtube links
- Watchlists: curated youtube playlists as embedded video galleries
- ToolsnToys: curated web tools and toys
- Creatorlists: curated links to excellent creators' work
- Creature Playground: scions build here, for review not deployment
- DumperCan: intake area for unsorted content

## Modular extension protocol

To add a new page to any section:
- Drop an .html file (complete) or .md file (content to build) into ToBuild/{section}/
- The sorter scion classifies and routes if landing in DumperCan first
- Gitea webhook triggers Coolify build on push to main
- New star node added to home page star map manually or by builder scion

## Optional future

Mirror to GitHub and serve a static mirror via GitHub Pages once full build
is stable. Automation for playlist building from Spotify CSV files (Phase 5+).
