How This Site Works
How This Site Works is an onboarding project for Hyphenomenon itself: it explains how a new project can start with one operator prompt that names the Hyphenomenon intake skill, the local repo path, source paths, a project title, and route context.
Metadata
- Type
- Initiative
- Status
- Active
- Connected nodes
- 8
- Curated visuals
- 5 screenshots
- Product surfaces
- 4
- Workflows
- 3
- Supporting artifacts
- 5
Links
Narrative
One prompt starts the record
A new Hyphenomenon project can start with a simple operator prompt: run the Hyphenomenon project-intake skill, give it the local repo path, the project title, and any live or canonical routes, then let the workflow assemble the first record. The point is speed with traceability. The operator does not manually create every project page, note, workflow, screenshot, and graph relationship from scratch; the intake loop creates a reviewable package and shows what it plans to write before anything public is trusted.
The skill turns paths into artifacts
The intake skill scaffolds a dossier, screenshot folder, hydration candidates, a project-page packet, and a workflow packet when the project depends on process evidence. For this site, those artifacts matter as much as the final page: they show the repo paths that were read, the screenshots captured, the source documents hydrated into notes, the workflow steps proposed, and the dry-run reports used to decide whether the local database should change.
Automation drafts, review decides
Automation collects and structures evidence; it does not declare the record finished. Dry-runs expose the project sections, notes, data models, workflow steps, media, edges, and overwrite risks before apply. Human review decides whether to accept the local write, revise weak copy, append evidence only, or stop. That boundary is the operating model: fast project creation, but with an explicit editorial gate.
The site becomes a logbook
The finished output is not a polished portfolio entry. It is a public logbook: the project page gives the narrative spine, notes preserve source-backed proof, workflows show how the work moved, screenshots show surfaces, and the Explore map shows relationships. When the process works, the archive can keep up with new work because the repeatable intake loop carries the heavy setup while the operator keeps judgment in the loop.
Product surfaces
Operator prompt handoff
operator creating a new projectThe starting move is a plain-language prompt that names the Hyphenomenon intake skill, project title, repo root, source paths, and any live or canonical route context.
Intake dossier and screenshots
operator and reviewerThe workflow creates an operator-readable dossier and screenshot set so public claims can point back to observed routes, source files, and captured surfaces.
Project and workflow packets
operator reviewing generated structureStructured packets turn the dossier into project sections, product surfaces, note memberships, workflow steps, source provenance, and graph relationships.
Local project route and Explore map
public reader and operatorAfter dry-run approval, the local database renders the project page, workflows, supporting notes, screenshots, and scoped Explore map membership for review.
System design
Public app runtime
- • Next.js App Router
- • React
- • DB-backed catalog loaders
- • shared public header/footer
Knowledge backbone
- • Neon/Postgres kb_* tables
- • project-scoped node membership
- • workflow steps
- • entity sources
- • provenance runs
Intake machinery
- • ML-hyphenomenon-project-intake skill
- • operator prompt with local paths
- • dossier scaffold
- • screenshot capture
- • source-artifact hydration
- • project-page packets
- • workflow packets
- • dry-run/apply reports
Governance
- • DOCS/ source of truth
- • numbered project docs
- • checkpoint logs with absolute timestamps
- • docs manifest and link checks
Workflows
Human-in-the-loop archive workflow
How raw work traces become reviewed public evidence across Hyphenomenon's projects, notes, workflows, chats, screenshots, and map.
Local review and promotion loop
How a generated Hyphenomenon project stays editable and accountable after the first intake run: local pages expose the draft record, the operator reviews narrative, artifacts, workflows, and graph links, then decides whether to revise the packet, keep the record local, or later request a separate production apply.
Prompt-to-project intake workflow
How a new Hyphenomenon project starts with one operator prompt that names the intake skill, local repo path, project title, and route context, then becomes a reviewable project page, workflow record, notes, screenshots, and graph membership through scaffold, hydration, dry-run, and human approval.
Supporting evidence
How This Site Works Intake Dossier
How This Site Works is an onboarding project for Hyphenomenon itself: it explains how a new project can start with one operator prompt that names the Hyphenomenon intake skill, the local repo path, source paths, a project title, and route context.
../../DOCS/solution-implementation.md
Source Summary title: Solution Implementation description: How Hyphenomenon implements its editorial public-experience and living-map strategy via data model...
Source reference available../../DOCS/features/projects.md
Source Summary title: Projects description: Public list/detail pages for project supernodes that function as Hyphenomenon's primary project and proof surface...
Source reference available../../DOCS/features/workflows.md
Source Summary title: Workflows description: Public list/detail pages for workflow entries with Mermaid diagrams sourced from the merged content catalog stat...
Source reference available../../DOCS/database/operations-and-maintenance.md
Source Summary title: Database Operations and Maintenance description: Operational procedures for Neon persistence, migrations, verification, and rollback st...
Source reference availableVisual evidence
Key dates
Project 1051 added the AI-optimist diary framing and the first How this site works homepage section.
Project 1052 created the first canonical project/onboarding route and local intake fixture.
Project 1049 added required project-page packet checks, overwrite guards, evidence-only append mode, hydration caps, and workflow packet quality gates.
The P3 How This Site Works record was rewritten to show that new project creation starts with one intake-skill prompt plus local paths, then proceeds through scaffold, hydration, dry-run, local apply, and human review.