md / deliverables
Molino⺢Pro

human-layer-checklist

Master Codebase Guidebook
Markdown + HTML Dev-Docs Renderer - Frontend Client Module

Default Index
Open README.md
Root: README.mddeliverables
Milestones
⬆ Parent folder📝 human-layer-checklist
H1Deliverables Human Layer Checklist

source: Human Layer Plan-Commit-Build secuence_vlatest status: active staging checklist last_updated: 2026-05-01

This checklist tracks the deliverable generation system that maps from the Apps Script system to Prisma Deliverable model.

H2Codex Offside Rule

Before coding, record:

  • intended goal
  • route or feature area
  • expected done condition
  • current status before coding

After coding, record:

  • achieved goal or partial result
  • checked route or behavior
  • remaining open issue
  • next action
H2Apps Script → Deliverable Mapping
Apps Script FunctionDeliverable TypeFormatStatus
insertPosterLayoutToDoc()POSTERposter✅ Done (generatePoster.ts)
generateFacilitatorScript90()SESSION_SCRIPTscript_90min🔴 Open
generateStudyReplay50()STUDY_CARDreplay_50min🔴 Open
persistSkillCardsToSheet()STUDY_CARDskill_cards🔴 Open
H21. Poster Generation
  • Server action exists: app/assets/actions/generatePoster.ts
  • Creates Deliverable with type POSTER, format "poster"
  • Builds PosterPayload from sessionStack concept cards
  • Done: ✅ Implemented
H22. Facilitator Script 90min Generation
  • Goal: Build generateScript.ts for 90-minute facilitator scripts
  • Input: sessionStackId
  • Output: Deliverable with type SESSION_SCRIPT, format "script_90min"
  • Status: ✅ Done (generateScript.ts)
  • Created: app/assets/script/types.ts, app/assets/actions/generateScript.ts
  • Builds ScriptPayload from sessionStack concept cards with timeline
H23. Study Replay 50min Generation
  • Goal: Build generateStudyCard.ts for 50-minute study replay content
  • Input: sessionStackId
  • Output: Deliverable with type STUDY_CARD, format "replay_50min"
  • Status: 🔴 Open
H3Before Coding (2026-05-01)
  • intended goal: Map Apps Script generateStudyReplay50() to Deliverable
  • route or feature area: app/assets/actions/generateStudyCard.ts
  • expected done condition: Server action creates Deliverable with STUDY_CARD type and replay_50min format
  • current status before coding: Following generateScript.ts pattern, using sessionStack concept cards
H3After Coding (2026-05-01)
  • achieved goal: Built generateStudyCard.ts and study/types.ts
  • checked: Creates Deliverable with STUDY_CARD type, replay_50min format
  • remaining open issue: None for this action
  • next action: Build skill cards persistence action
H24. Skill Cards Persistence
  • Goal: Build action to persist skill cards as Deliverable
  • Input: sessionStackId, skill card data
  • Output: Deliverable with type STUDY_CARD, format "skill_cards"
  • Status: 🔴 Open
H3Before Coding (2026-05-01)
  • intended goal: Map Apps Script persistSkillCardsToSheet() to Deliverable
  • route or feature area: app/assets/actions/persistSkillCards.ts
  • expected done condition: Server action creates Deliverable with STUDY_CARD type and skill_cards format
  • current status before coding: Following same pattern, extracting skill cards from sessionStack.data.skill or concept cards
H25. API Routes (Future)
  • Goal: Expose deliverable CRUD via API routes
  • Status: 🔴 Open (not started)
H26. UI Components (Future)
  • Goal: Build deliverable management UI
  • Status: 🔴 Open (not started)
H27. Deliverables as Grid Items (Planning)
H3Research Result (2026-05-01)

Relationships discovered:

  • Trip → Deliverable: ✅ Direct relation exists in schema
  • Experience → Deliverable: ❌ No relation (would need schema change)
  • SessionStack → Deliverable: ✅ Direct relation exists
  • SessionPath → Deliverable: ✅ Direct relation exists

Current grid rendering:

  • /trips grids: Trip cards, City cards, Experience cards — NOT deliverables
  • Studio sections: Not yet rendering deliverables
H3Proposed Plan: Phased Delivery

Phase 1 — Trip deliverables in grids (no schema change)

  • Intended goal: Render trip.deliverables as grid items in /trips sections
  • Route: app/trips/components/sections/, new TripDeliverablesSection
  • Expected done: Trip posters/postcards show as grid cards in trips surface
  • Status: ✅ Done (components built, registry + page wired, kernel-theme.css added)

Phase 2 — Experience → Deliverable relation (schema change)

  • Intended goal: Add deliverables Deliverable[] to Experience model
  • Route: Prisma schema + migration + Zod regen
  • Expected done: Experiences can store and render posters/postcards
  • Status: 🔴 Planned

Phase 3 — Studio grids (SessionStack/SessionPath posters)

  • Intended goal: Render SessionStack/SessionPath deliverables in /studio/travel or /studio/experience
  • Route: Studio section components
  • Expected done: Generated posters appear as promotional grid items in studio
  • Status: 🔴 Planned
H3Before Coding (2026-05-01) — Phase 1
  • Intended goal: Build DeliverableCard component and render trip.deliverables in grids
  • Route or feature area: app/trips/components/, app/assets/poster/
  • Expected done condition: Trip posters render as grid items in /trips surface
  • Current status before coding: Trip has deliverable relation; need component + section
H2Session Notes
H32026-05-01 - Deliverable System Planning

Goal: Map Apps Script deliverable generation to Prisma Deliverable model.

Current status before coding:

  • Deliverable model defined in Prisma schema ✅
  • Zod schemas complete ✅
  • generatePoster.ts implemented ✅
  • generateScript.ts implemented ✅
  • generateStudyCard.ts implemented ✅
  • persistSkillCards.ts missing 🔴

Next action: Phase 1 — Build DeliverableCard component and trip grid rendering.

H32026-05-02 - shadcn + kernel.sh Theme Added
  • shadcn/ui initialized with defaults ✅
  • kernel-theme.css created with dot-grid, glow, typography, card/button styles
  • globals.css imports kernel-theme ✅
  • TripFeaturedDeliverablesSection.tsx adapted to kernel.sh style (dot-grid, mono-label, headline-section, card-kernel)
  • Build passes after fixing trips.read.actions.ts exports ✅
  • Seed files created: seed-lib/experiences.ts, seed-lib/deliverables.ts ✅
  • Main seed.ts updated to call new seed functions ✅
  • trips.read.actions.ts now exports getFeaturedCities, getFeaturedExperiences ✅
  • All page imports fixed, build passes ✅