Skip to content

docs: Add NIGHTWATCH v0.1 frontend design prompt pack for Claude Design - #92

Closed
THOClabs wants to merge 1 commit into
mainfrom
claude/nightwatch-frontend-demo-takdve
Closed

docs: Add NIGHTWATCH v0.1 frontend design prompt pack for Claude Design#92
THOClabs wants to merge 1 commit into
mainfrom
claude/nightwatch-frontend-demo-takdve

Conversation

@THOClabs

@THOClabs THOClabs commented Jul 6, 2026

Copy link
Copy Markdown
Owner

Summary

Add complete design specification and prompt pack for generating the NIGHTWATCH v0.1 demo frontend using Claude Design. This includes the master generation prompt, iteration prompts for follow-up modules, and usage documentation.

Related Issues

Implements the frontend design phase documented in the project roadmap.

Type of Change

  • Documentation update
  • New feature (design specification for frontend generation)

Changes Made

  • CLAUDE_DESIGN_PROMPT.md — Master generation-1 prompt (464 lines) containing:

    • Project context: mission, site, hardware, and design character (High Desert Brass theme)
    • Complete design system: color tokens, typography, spacing, motion, and component patterns
    • Data model: TypeScript interfaces for all observatory state (mount, roof, weather, safety, guiding, capture, power, voice, events)
    • Physics constants: drive resolution, slew rates, safety thresholds, wind/humidity/temperature/battery tiers
    • Mock data and simulation architecture: 1 Hz tick reducer, continuous physics, scripted event timeline, demo director controls
    • Information architecture: 10-module left rail, top status strip, route map
    • Digital twin specification: SVG-based 2D elevation with live animation bindings
    • Voice agent console: conversation stream, tool-call cards, latency waterfall, context rail
    • Seven flagship screens: Mission Control, Sky & Targets, Capture, Guiding, Weather & Safety, Alerts, Night Schedule, Meteor Watch
    • Complete demo script: 13 chapters from dusk to dawn with synchronized state changes
  • ITERATION_PROMPTS.md — Six staged follow-up prompts (104 lines) for building remaining modules:

    • Iteration 1: Facility module (roof, power, drives)
    • Iteration 2: Operations module (queue, session timeline, log, report)
    • Iteration 3: System module (health, settings, simulator)
    • Iteration 4: Sky & Targets + Imaging depth
    • Iteration 5: Voice & Meteor depth
    • Iteration 6: Polish and refinement pass
    • Each prompt follows a consistent structure: what exists → scope → outcome → constraints
  • README.md — Usage guide (55 lines) covering:

    • How to run the master prompt in Claude Design
    • Iteration discipline: chat vs. inline comments vs. canvas edits
    • Budget notes for Claude Design metered usage
    • Provenance table mapping prompt sections to source-of-truth files in the repository

Design System Highlights

  • High Desert Brass theme: Dark indigo canvas (#0A0E1A), moonlight text, hand-rubbed brass accents (#C9A227), safety semantics (green/amber/red/emergency-red)
  • Rubylith night-vision mode: Global toggle swaps all tokens to red ramp for dark adaptation at the telescope
  • Typography: Space Grotesk (UI), JetBrains Mono (telemetry), Fraunces (headings)
  • Motion: Physical elements move at simulation-truth speeds; UI chrome uses 150–200 ms ease-out; only emergency elements pulse
  • Density: Instrument panel aesthetic, not marketing site; every numeric readout includes units

Data Model Alignment

The prompt transcribes the exact data model from the Python backend:

  • SafetyLevel, SafetyAction, MountState, RoofState, PowerState, PipelineState enums
  • Live state interfaces: MountStatus, RoofStatus, Conditions, SafetyStatus, GuideStats, CaptureSession, UPSStatus
  • Event types and voice turn results matching the orchestrator's contract
  • Physics constants (24,000 steps/° RA, 19,200 steps/° DEC, 4°/s slew, sidereal tracking, meridian limits ±15° HA, safety thresholds)

Simulation Engine

  • Self-contained 1 Hz tick reducer with deterministic state mutations
  • Continuous physics: slew integrator, side

https://claude.ai/code/session_012nb7FjZTrrwExMx5xmYBJG

Complete prompt pack for generating the NIGHTWATCH demo UI with Claude
Design (Fable 5, High effort):

- docs/design/CLAUDE_DESIGN_PROMPT.md: self-contained master prompt —
  High Desert Brass design system (with Rubylith night-vision mode),
  TypeScript data contracts transcribed from the backend dataclasses,
  physics constants table, simulation engine + Demo Director spec,
  10-module information architecture (~35 routes), full specs for ten
  flagship screens including the animated SVG digital twin and the
  voice-agent console, and a scripted golden-path night (dusk through
  rain emergency to dawn park).
- docs/design/ITERATION_PROMPTS.md: six staged generation-2+ prompts
  covering Facility, Operations, System, Sky/Imaging depth,
  Voice/Meteor depth, and a states/polish pass.
- docs/design/README.md: usage guide, iteration discipline, and a
  provenance map from every prompt section to its repo source of truth.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012nb7FjZTrrwExMx5xmYBJG
THOClabs pushed a commit that referenced this pull request Aug 2, 2026
…ranches (S5)

Completes the S5 line item from REVIEW_RECONCILIATION.md. Buckets all 82
non-main remote branches: 11 merged-this-session fix/* (content in main,
safe delete), 59 orphan March-2026 NEO/meteor scanner re-rolls (never PR'd,
39 behind — reference-spec only, not mergeable), 6 superseded cursor/* review
orphans, and 2 legacy/misc (master, review-codebase). Names 7 reference
branches worth skimming before pruning the March cluster; keeps the 4 branches
backing open PRs (#89/#90/#92/#93). Ships ready-to-run per-bucket delete
commands. No branches deleted, merged, or force-pushed — all removals left to
the maintainer.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SKZMQ755R7q38SKqJsCQsg
THOClabs added a commit that referenced this pull request Aug 7, 2026
#112)

Preserves the durable content of three open-PR branches before the v0.1.1
branch purge closes them:

- .claude/agents/ (7 review subagents) + .claude/commands/full-review.md
  from PR #93's branch — repo-state-independent review tooling; the stale
  July review reports on that branch are intentionally NOT taken.
- docs/design/ Claude Design frontend prompt pack (3 files) from PR #92's
  branch — targets the v0.2 frontend; NEO data-model sections predate
  #108/#109 and need a refresh before use (noted in its provenance table).
- docs/audits/ archive of AUDIT_LANDSCAPE.md + REVIEW_RECONCILIATION.md
  from PR #90's branch, with HISTORICAL SNAPSHOT headers — findings were
  fixed by #94-#110; preserved as engineering history. Its
  STALE_BRANCH_TRIAGE.md is dropped (superseded by #110).

Part 1/Step 2 of the v0.1.1 main-only consolidation.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
@THOClabs

THOClabs commented Aug 7, 2026

Copy link
Copy Markdown
Owner Author

Closing as part of the v0.1.1 single-branch consolidation. The full docs/design/ prompt pack (3 files, content of 56321bc) WAS salvaged to main in #112 (commit 5d84e66), with a note that the NEO data-model sections predate #108/#109 and need a refresh before use. Branch will be deleted with the stale-branch purge.

@THOClabs THOClabs closed this Aug 7, 2026
@THOClabs
THOClabs deleted the claude/nightwatch-frontend-demo-takdve branch August 7, 2026 04:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants