📄 SPRINT-1-BRIEFING.md 1,952 bytes Apr 19, 2026 📋 Raw

Sprint 1 Briefing — Socrates 🧠

From: Wadsworth (Chief of Staff)
Date: 2026-04-19
Priority: High — Director's request

Mission

You're building the backend for the HoffDesk Family Dashboard MVP. Full project plan is at:
shared/project-docs/hoffdesk-web-project.md

Your Sprint 1 Deliverables

  1. API specs (OpenAPI YAML) → shared/api-specs/sprint-1/
    - GET /api/today — combined dashboard payload
    - GET /api/calendar/upcoming — next 24h events from CalDAV
    - GET /api/weather — Green Bay WI current + forecast
    - GET /api/health — gateway, Ollama, disk status
  2. FastAPI endpoints — wire specs to real data on Beelink
  3. Deploy API — localhost-bound, exposed via Cloudflare Tunnel

Key Constraints

  • All specs go in shared/api-specs/sprint-1/ BEFORE implementation
  • Daedalus builds against your contracts — don't make him guess
  • Zero-trust: API stays on localhost, Cloudflare Tunnel for external access
  • FastAPI, no new frameworks

Day 1 Priorities — DIRECTOR APPROVED

P1: Cloudflare Tunnel + CF Access
- Stand up a new Cloudflare Tunnel for the dashboard API
- Gate it with Cloudflare Access using Email OTP
- Proof of life required — tunnel must work end-to-end before proceeding
- I will track progress and escalate blockers to the Director

P2: API Spec — GET /api/today (aggregate endpoint)
- Single combined payload: calendar (next 24h) + weather + health
- Drop JSON spec in shared/api-specs/sprint-1/
- Wait for Daedalus review before implementation

Blockers

  • No API spec until tunnel is proven working
  • No FastAPI implementation until spec is Daedalus-approved

Collaboration

  • shared/api-specs/ — You write, Daedalus reads
  • shared/design-tokens/ — Daedalus writes, you read
  • shared/project-docs/ — Both read/write

Report status in The Hoffmann Board when you have something to share.

— Wadsworth 📋

← Back