Project

    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.

    Table of contents

    Narrative

    01

    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.

    02

    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.

    03

    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.

    04

    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.

    System surfaces

    Implementation stack

    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

    Evidence trail

    data model

    One-prompt intake artifact flow

    The hardened process shows how a simple prompt with local paths becomes a dossier, packets, dry-run reports, local database records, and public review surfaces.

    8entities1diagram
    workflow

    Human-in-the-loop archive workflow

    How raw work traces become reviewed public evidence across Hyphenomenon's projects, notes, workflows, chats, screenshots, and map.

    6steps1record
    Created: May 9, 2026
    workflow

    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.

    6steps1record
    Created: May 10, 2026
    workflow

    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.

    10steps1record
    Created: May 10, 2026
    note

    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.

    1topic1scope
    note

    ../../DOCS/solution-implementation.md

    Source Summary title: Solution Implementation description: How Hyphenomenon implements its editorial public-experience and living-map strategy via data model...

    1topic1scope
    note

    ../../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...

    1topic1scope
    note

    ../../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...

    1topic1scope
    note

    ../../DOCS/database/operations-and-maintenance.md

    Source Summary title: Database Operations and Maintenance description: Operational procedures for Neon persistence, migrations, verification, and rollback st...

    1topic1scope

    Visual evidence

    Key dates

    2026-05-08
    Homepage living-archive story introduced

    Project 1051 added the AI-optimist diary framing and the first How this site works homepage section.

    2026-05-09
    How This Site Works promoted to project

    Project 1052 created the first canonical project/onboarding route and local intake fixture.

    2026-05-09
    P3 proof-record guards added

    Project 1049 added required project-page packet checks, overwrite guards, evidence-only append mode, hydration caps, and workflow packet quality gates.

    2026-05-10
    Operator-prompt workflow clarified

    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.