Molino⺢ Practice

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 Function	Deliverable Type	Format	Status
`insertPosterLayoutToDoc()`	POSTER	poster	✅ Done (generatePoster.ts)
`generateFacilitatorScript90()`	SESSION_SCRIPT	script_90min	🔴 Open
`generateStudyReplay50()`	STUDY_CARD	replay_50min	🔴 Open
`persistSkillCardsToSheet()`	STUDY_CARD	skill_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 ✅

human-layer-checklist

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