Skip to content

About this site

This is a build journal — not the Nodewright product documentation.

The Nodewright product itself ships its own mkdocs site under docs/ in the repo, deployed at v0.1 GA per PRD-10 SURF-28.

This tracker exists for transparency on the weekend sprint — Craig hands off autonomy to Claude, walks away, and comes back to a finished v0.1 with this site explaining what happened, when, and how.

Build environment

  • Tooling: kubebuilder v4, Go 1.24+, controller-runtime, kind, chainsaw, cosign, syft, mkdocs Material, wrangler
  • Sprint cadence: ~10–15 min per ralph iteration (Claude work + push + GitHub Actions CI wait + commit)
  • Estimated total wall-clock: 25–40 hours for v0.1 (Foundations + Killer Feature + Surface + Release ralph builds)
  • Hardware lab: Craig's home Proxmox + 4× MS-01 + MaaS at 172.18.0.0/24 (per ~/.claude/CLAUDE.md)

How auto-update works

The scripts/update.sh script in this site directory:

  1. Reads the Nodewright repo's git log --pretty='%H %ci %s' for every commit since the project started.
  2. Reads prd.json for current story states.
  3. Reads metrics.json for per-iteration timing.
  4. Reads each docs/prds/*.critic-log.md for critic-loop pass timestamps and finding counts.
  5. Regenerates build-journal.md, prd-status.md, loop-stats.md, timeline.md, phase-1-foundations.md.
  6. Runs mkdocs build.
  7. Runs wrangler pages deploy site/ --project-name nodewright-build.

Cloudflare Pages serves the result.

Source files

Source Used by
git log (Nodewright repo) build-journal, timeline
prd.json (Nodewright repo) prd-status, phase-1-foundations
metrics.json (Nodewright repo, ralph telemetry) loop-stats, phase-1-foundations
docs/prds/*.critic-log.md (Nodewright repo) prd-status
docs/architecture-brief.md (Nodewright repo) linked-only

Brand

Spectro Cloud 2025 palette via the local spectrocloud-brand skill. Tranquil Teal #1F7A78 primary. Plus Jakarta Sans typography (Material default fallback).