projectInitiativeActive

    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.

    BuilderDesigner

    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

    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

    Supporting evidence

    Visual evidence

    Homepage entry point showing the AI-optimist diary framing and current archive explanation.
    Projects index showing how public project records are presented as the main catalog.
    Workflow index showing the public operational-playbook surface.
    Explore map showing connected project, note, workflow, and chat relationships.
    Notes index showing how supporting evidence can live alongside projects and workflows.

    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.