Demo 1

Agent-ready website demo

A historical mdkg run specialized a reusable website specification into an Ocean Flow candidate with local validation and explicit preview boundaries.

Ocean Flow graph map showing goal, creative direction, Astro plus React, and local proof.
Reusable start → specialized result

The same local goal id carries a more specific contract.

Compare the reusable starting specification with the specialized executed specification. The contrast is requirements, authority, tests, and proof—not hidden chat history.

Reusable starting specificationreusable source

goal-1

Build a complete differentiated website demo from the canonical mdkg template

The reusable starting specification fixed the workflow and boundaries while leaving the audience, offer, structure, and visual direction open.

Goal condition

Build a complete local website from the reusable template, record creative direction and validation evidence, and stop before publication.

Requirements

  • Choose an audience, offer, structure, and creative direction before implementation.
  • Use the Ocean Flow design baseline and keep public claims source-backed.
  • Build and validate a complete local website candidate.

Authority

  • Local graph, source, build, and browser validation only.
  • No push, deployment, DNS, analytics, provider mutation, or publication.

Tests

  • Graph validation and first-node routing.
  • Local build and responsive browser review.
  • No-secret and public-claims checks.
Checkpoint
chk-1 · website demo template seed accepted
Source hash
sha256:fd50a8dd10dde457c8e1eb2e17966ac6457d6e0eaa82f3ca5efee8bd56ba9495
Specialized executed specificationachieved

goal-1

Build the Ocean Flow website-demo candidate

The executed specification narrowed the open brief into a concrete creative direction, implementation, local test record, and checkpoint.

Goal condition

Produce the selected Ocean Flow Astro candidate, validate its focused island and public-safe evidence locally, and record a preview recommendation.

Requirements

  • Use the selected Ocean Flow map and product-engineering audience.
  • Build the historical Astro candidate with one focused interactive proof.
  • Retain only sanitized graph, file, build, and browser evidence.

Authority

  • Local implementation and validation were allowed.
  • Publication and provider changes remained outside the run.

Tests

  • Graph validation passed with zero warnings.
  • The Astro build and desktop/mobile browser checks passed.
  • No-secret and public-claims review passed.
Checkpoint
chk-4 · demo-001 validation passed for optional preview
Source hash
sha256:7a4728a1cfcf383afc25dbbb91e5db385318ab90965768543807ac7e3d3f1ff8
Plan → Work → Evidence

What completed, why it mattered, and what comes next.

Plan

Specialize the reusable contract

Produce the selected Ocean Flow Astro candidate, validate its focused island and public-safe evidence locally, and record a preview recommendation.

Work

3 scoped items completed

  • spike-1 · Choose audience offer structure and creative directionWhy: Turn an open-ended website brief into an implementation-ready Ocean Flow direction.
  • task-1 · Build complete Astro React Islands website demoWhy: Implement the selected historical demo composition and focused interactive proof.
  • test-1 · Complete website demo validation and handoff contractWhy: Decide from local build, browser, claims, and no-secret evidence whether the candidate could advance.
Evidence

Completion is inspectable

  • Graph validation · passThe retained Demo 1 graph validated with zero warnings.
  • Local website build · passThe historical Astro candidate built locally from its preserved run.
  • Public-safety review · passThe retained snapshot excludes credentials, private prompts, and provider payloads.
What comes next

The historical checkpoint recommended a separately authorized preview decision; it did not publish the candidate.

Surface 1

Sanitized mdkg graph

goalachieved

goal-1

Build a complete differentiated website demo from the canonical mdkg template

The run starts from one selected goal and closes with local proof before any optional preview deployment.

spikedone

spike-1

Choose audience offer structure and creative direction

Creative direction is summarized into durable graph state instead of retained as private prompt text.

taskdone

task-1

Build complete Astro React Islands website demo

The source output is a differentiated static Astro site with one focused React island.

testdone

test-1

Complete website demo validation and handoff contract

Build, rendering, public-claims, and no-secret evidence decide whether the run should advance.

checkpointrecorded

chk-4

demo-001 validation passed for optional preview

The checkpoint records local proof before the run is considered for an optional preview.

Surface 2

Selected read-only files

receipt

DEMO_RUN_RECEIPT.md

Fork and validation provenance

Run id: demo-001
Source template: examples/website-demo-template/
Target path: examples/demo-runs/demo-001/
Validation: ok true, zero warnings.
goal

.mdkg/work/goal-1-build-a-complete-differentiated-website-demo-from-the-canonical-mdkg-template.md

Run contract

A complete, local, differentiated Astro plus React Islands website demo is built from this template, follows Ocean Flow, records creative direction and validation evidence.
checkpoint

.mdkg/work/chk-4-demo-001-validation-passed-and-preview-approval-recommended.md

Closeout evidence

The generated site builds locally, validates in mdkg, renders cleanly in Browser and Chrome desktop/mobile captures, and is ready for optional preview deployment.
source

src/pages/index.astro

Generated site shell

The page describes mdkg graph, pack, validation, and preview boundaries without inventing production claims.
source

src/components/GoalRunConsole.tsx

Focused React Island

A small island shows the selected stage, command, node, and evidence posture without turning the whole page into a client app.
Surface 3

Final output preview

The output route is rendered separately and noindexed as a preview surface.

Ocean Flow visual mapsticky local demo navigationstructured workflow cardsfocused stage consolepublic-safety closeout section
Acceptance gates

Validation and public-safety record

Validation

  • mdkg validation passed with zero warnings in the demo run
  • local Astro build passed
  • Browser and Chrome desktop and mobile checks were recorded
  • no-secret and public-claims review passed for the retained evidence

Boundaries

  • No credentials, cookies, private prompts, provider data, or private artifacts are included.
  • The public snapshot is intentionally bounded to selected graph, file, and output evidence.
  • The output route is noindexed as a preview surface even though the demo detail page is public.
  • The snapshot does not imply deployment, DNS, publishing, analytics, or provider-side changes.