style: align buildpulse mobile action pair

README.md

@@ -3,6 +3,9 @@
 BuildPulse is a calm planning cockpit for AI-assisted product building.
 It helps capture features, park distracting ideas, log progress as Pulse events, and export clean project context for AI coding agents such as Claude Code, Codex, OpenCode, OpenClaw, or future autonomous agents.
 
+Current release line:
+- v0.4.1 — preview/edit-before-copy handoffs with cleaner INTENT controls and tighter mobile UX
+
 Personal runtime target:
 - `build.friborg.uk`
 

docs/ROADMAP.md

@@ -58,21 +58,25 @@ Potential features:
 - Required vs optional features
 - Release readiness view
 
-## v0.4 — Session Prompt Generator
+## v0.4 — Handoff Workflow Hardening
 
 Goal:
-Generate clean prompts for AI coding agents.
+Turn a chosen feature into a sharp, target-specific AI coding brief with as little friction as possible.
 
-Potential features:
-- Start 30-minute session from feature
-- Generate Claude Code/Codex prompt
-- Include do-not-touch list
-- Include acceptance criteria
-- Include recent pulse context
-- End-session summary template
+Current shipped slices:
+- v0.3.1 — focused handoff shortcuts
+- v0.3.2 — target-specific handoff presets
+- v0.4.0 — one-tap feature handoffs
+- v0.4.1 — preview/edit before copy + explicit INTENT controls
 
-Note:
-BuildPulse now has a lightweight export-side session prompt generator in v0.1.x so handoff quality improves before the fuller v0.4 workflow arrives.
+Planned slices:
+- v0.4.2 — paste agent result into RESULT/BLOCKER/TEST_RESULT pulses
+- v0.4.3 — session modes (30-minute, feature-based, bugfix, QA review)
+
+Core rules:
+- Keep handoff generation close to the feature decision surface.
+- Include release/phase context, blockers, parking-lot warnings, and return format.
+- Do not add live execution, telemetry, router logic, or agent streaming in this phase.
 
 ## v0.5 — Local/Cloud AI Assistant
 

package.json

@@ -1,7 +1,7 @@
 {
   "name": "buildpulse",
   "private": true,
-  "version": "0.3.0",
+  "version": "0.4.8",
   "type": "module",
   "scripts": {
     "api": "node --env-file=../.env server/index.mjs",

src/App.tsx

@@ -9,11 +9,11 @@ import type { AiPlacement, AiRecommendation, AppState, Feature, FeatureColumn, P
 import { arrayToLines, formatDateTime, linesToArray, nowIso, slugify } from './utils/format'
 
 const TABS: Array<{ key: TabKey; label: string }> = [
-  { key: 'feature-plan', label: 'Plan' },
-  { key: 'roadmap', label: 'Roadmap' },
-  { key: 'parking-lot', label: 'Park' },
-  { key: 'pulse-log', label: 'Pulse' },
-  { key: 'export', label: 'Export' },
+  { key: 'feature-plan', label: 'Today' },
+  { key: 'parking-lot', label: 'Ideas' },
+  { key: 'roadmap', label: 'Release' },
+  { key: 'pulse-log', label: 'History' },
+  { key: 'export', label: 'Session' },
 ]
 
 const PROMPT_TARGETS = ['OpenClaw', 'Claude Code', 'Codex', 'Generic Agent'] as const
@@ -119,6 +119,10 @@ function App() {
   const [pulseSourceFilter, setPulseSourceFilter] = useState('all')
   const [promptTarget, setPromptTarget] = useState<(typeof PROMPT_TARGETS)[number]>('OpenClaw')
   const [promptFeatureId, setPromptFeatureId] = useState('')
+  const [handoffPreviewOpen, setHandoffPreviewOpen] = useState(false)
+  const [handoffPreviewTarget, setHandoffPreviewTarget] = useState<(typeof PROMPT_TARGETS)[number]>('OpenClaw')
+  const [handoffPreviewFeatureId, setHandoffPreviewFeatureId] = useState('')
+  const [handoffPreviewDraft, setHandoffPreviewDraft] = useState('')
   const [backendMode, setBackendMode] = useState<'connecting' | 'appwrite' | 'local-cache'>('connecting')
   const [syncStatus, setSyncStatus] = useState<'connecting' | 'synced' | 'pending' | 'syncing' | 'degraded'>('connecting')
   const [lastSyncedAt, setLastSyncedAt] = useState<string | null>(null)
@@ -139,10 +143,12 @@ function App() {
   const [triageError, setTriageError] = useState('')
   const [triageBatchStatus, setTriageBatchStatus] = useState<'idle' | 'running'>('idle')
   const [triageEditMode, setTriageEditMode] = useState(false)
+  const [triageClarificationAnswer, setTriageClarificationAnswer] = useState('')
   const [triageSavedMessage, setTriageSavedMessage] = useState('')
   const [showManualFeatureEditor, setShowManualFeatureEditor] = useState(false)
   const [showManualParkingEditor, setShowManualParkingEditor] = useState(false)
   const [showManualPulseEditor, setShowManualPulseEditor] = useState(false)
+  const [todayCommandDrawerOpen, setTodayCommandDrawerOpen] = useState(false)
   const hasHydratedRemote = useRef(false)
   const initialLocalStateRef = useRef(appState)
   const triageStatusRef = useRef<HTMLDivElement | null>(null)
@@ -230,6 +236,11 @@ function App() {
     [appState.features, selectedFeatureId],
   )
 
+  const handoffPreviewFeature = useMemo(
+    () => appState.features.find((feature) => feature.id === handoffPreviewFeatureId) ?? null,
+    [appState.features, handoffPreviewFeatureId],
+  )
+
   const selectedParkingItem = useMemo(
     () => appState.parking_lot.find((item) => item.id === selectedParkingId) ?? null,
     [appState.parking_lot, selectedParkingId],
@@ -306,6 +317,25 @@ function App() {
       .slice(0, 6)
   }, [appState.pulses, selectedRelease])
 
+  const focusFeature = useMemo(
+    () => groupedFeatures.now.find((feature) => feature.status !== 'done') ?? groupedFeatures.now[0] ?? groupedFeatures.next[0] ?? appState.features[0] ?? null,
+    [appState.features, groupedFeatures.next, groupedFeatures.now],
+  )
+
+  const duplicateParkingGroups = useMemo(() => {
+    const groups = new Map<string, ParkingLotItem[]>()
+    appState.parking_lot.forEach((item) => {
+      const key = item.title.toLowerCase().replace(/[^a-z0-9æøå]+/gi, ' ').trim()
+      if (!key) return
+      groups.set(key, [...(groups.get(key) ?? []), item])
+    })
+    return Array.from(groups.values()).filter((items) => items.length > 1)
+  }, [appState.parking_lot])
+
+  const activeReleaseSummary = selectedRelease
+    ? `${selectedRelease.name} · ${selectedReleaseRequiredDoneCount}/${selectedReleaseRequiredFeatures.length || 0} required done`
+    : 'No active release selected'
+
   const parkingByRisk = useMemo(
     () =>
       PARKING_RISK_ORDER.map((risk) => ({
@@ -328,6 +358,12 @@ function App() {
     [appState.pulses],
   )
 
+  const pulseDraftFeature = useMemo(
+    () => appState.features.find((feature) => feature.id === pulseDraft.featureId) ?? null,
+    [appState.features, pulseDraft.featureId],
+  )
+  const pulseDraftCanUpdateProgress = !selectedPulseId && Boolean(pulseDraftFeature) && (pulseDraft.pulseType === 'RESULT' || pulseDraft.pulseType === 'TEST_RESULT')
+
   const triagePlacement = triageEditable.placement || triageRecommendation?.suggested_placement || 'parking_lot'
   const triageIsFeaturePlacement = triagePlacement === 'now' || triagePlacement === 'next' || triagePlacement === 'later'
   const triageNeedsClarification = triagePlacement === 'needs_clarification'
@@ -354,23 +390,46 @@ function App() {
           ? 'status-connecting'
           : ''
 
+  useEffect(() => {
+    const closeTopSheet = (event: KeyboardEvent) => {
+      if (event.key !== 'Escape') return
+      if (handoffPreviewOpen) {
+        setHandoffPreviewOpen(false)
+        return
+      }
+      if (triageOpen) {
+        setTriageOpen(false)
+        return
+      }
+      if (pulseSheetOpen) {
+        setSelectedPulseId(null)
+        setPulseDraft(initialPulseDraft)
+        setShowManualPulseEditor(false)
+        return
+      }
+      if (parkingSheetOpen) {
+        setSelectedParkingId(null)
+        setParkingDraft(initialParkingDraft)
+        setShowManualParkingEditor(false)
+        return
+      }
+      if (featureSheetOpen) {
+        setSelectedFeatureId(null)
+        setFeatureDraft(initialFeatureDraft)
+        setShowManualFeatureEditor(false)
+      }
+    }
+
+    window.addEventListener('keydown', closeTopSheet)
+    return () => window.removeEventListener('keydown', closeTopSheet)
+  }, [featureSheetOpen, handoffPreviewOpen, parkingSheetOpen, pulseSheetOpen, triageOpen])
+
   const markdownPackage = useMemo(() => createMarkdownPackage(appState), [appState])
   const sessionPrompt = useMemo(
     () => createAgentSessionPrompt(appState, { featureId: promptFeatureId || undefined, target: promptTarget }),
     [appState, promptFeatureId, promptTarget],
   )
 
-  const updateProject = (field: keyof AppState['project'], value: string) => {
-    setAppState((current) => ({
-      ...current,
-      project: {
-        ...current.project,
-        [field]: value,
-        updated_at: nowIso(),
-      },
-    }))
-  }
-
   const updatePhase = (phaseId: string, field: keyof ProjectPhase, value: string | number) => {
     setAppState((current) => ({
       ...current,
@@ -647,6 +706,7 @@ function App() {
     setTriageOpen(true)
     setTriageError('')
     setTriageEditMode(false)
+    setTriageClarificationAnswer('')
     setTriageSavedMessage('')
     setTriageStatus(triageRecommendation && !seed ? 'ready' : 'idle')
     if (seed) {
@@ -662,6 +722,7 @@ function App() {
     setTriageStatus('idle')
     setTriageError('')
     setTriageEditMode(false)
+    setTriageClarificationAnswer('')
   }
 
   const openDecisionPulse = (pulseId?: string | null) => {
@@ -732,7 +793,7 @@ function App() {
       .map((pulse) => ({ message: pulse.message, evidence_refs: pulse.evidence_refs })),
   })
 
-  const runAiTriage = async () => {
+  const runAiTriage = async (optionalContextOverride?: string) => {
     const rawIdea = triageDraft.rawIdea.trim()
     if (!rawIdea) {
       setTriageError('Write the idea first. The scope goblin needs bait.')
@@ -740,6 +801,8 @@ function App() {
       return
     }
 
+    const optionalContext = optionalContextOverride ?? triageDraft.optionalContext.trim()
+
     setTriageStatus('loading')
     setTriageError('')
     setTriageSavedMessage('')
@@ -748,7 +811,7 @@ function App() {
     try {
       const recommendation = await triageIdeaWithAi({
         raw_idea: rawIdea,
-        optional_context: triageDraft.optionalContext.trim(),
+        optional_context: optionalContext,
         app_context: buildAiTriageContext(),
       })
       const timestamp = nowIso()
@@ -756,7 +819,7 @@ function App() {
         id: `rec_${slugify(rawIdea)}_${timestamp.replace(/[^0-9]/g, '')}`,
         created_at: timestamp,
         raw_idea: rawIdea,
-        optional_context: triageDraft.optionalContext.trim(),
+        optional_context: optionalContext,
         context_summary: `${appState.project.name}: ${appState.project.current_goal}`,
         ...recommendation,
         user_decision: 'pending',
@@ -777,6 +840,7 @@ function App() {
       })
       setTriageStatus('ready')
       setTriageEditMode(false)
+      setTriageClarificationAnswer('')
       setStatusMessage(`AI suggested ${placementLabels[fullRecommendation.suggested_placement]} with ${fullRecommendation.scope_risk} scope risk.`)
     } catch (error) {
       setTriageStatus('error')
@@ -1011,10 +1075,28 @@ function App() {
       featureId,
       pulseType: 'ACTION',
     }))
+    setShowManualPulseEditor(true)
     setActiveTab('pulse-log')
     setStatusMessage(feature ? `Pulse composer aimed at “${feature.title}”.` : 'Pulse composer ready.')
   }
 
+  const openFeatureResultCapture = (featureId: string) => {
+    const feature = appState.features.find((entry) => entry.id === featureId)
+    setSelectedPulseId(null)
+    setPulseDraft((current) => ({
+      ...initialPulseDraft,
+      source: 'agent-session',
+      agentId: current.agentId || 'OpenClaw',
+      featureId,
+      pulseType: 'RESULT',
+      message: feature ? `Agent result for “${feature.title}”: ` : 'Agent result: ',
+      evidenceRefs: 'Pasted agent/session result',
+    }))
+    setShowManualPulseEditor(true)
+    setActiveTab('pulse-log')
+    setStatusMessage(feature ? `Paste the agent result for “${feature.title}”.` : 'Paste the agent result and save it as history.')
+  }
+
   const beginParkingEdit = (item: ParkingLotItem) => {
     setSelectedParkingId(item.id)
     setParkingDraft({
@@ -1147,14 +1229,15 @@ function App() {
     setPulseDraft(initialPulseDraft)
   }
 
-  const savePulse = () => {
+  const buildPulseFromDraft = () => {
     if (!pulseDraft.message.trim()) {
       setStatusMessage('Pulse message is required.')
-      return
+      return null
     }
 
     const timestamp = nowIso()
-    const pulse: PulseEvent = {
+    return {
+      pulse: {
         id: selectedPulseId ?? `pulse_${Date.now().toString(36)}`,
         timestamp: selectedPulse?.timestamp ?? timestamp,
         project_id: appState.project.id,
@@ -1166,25 +1249,58 @@ function App() {
         confidence_score: Number(pulseDraft.confidence) || 0,
         evidence_refs: linesToArray(pulseDraft.evidenceRefs),
         trace_id: pulseDraft.traceId.trim() || undefined,
+      } satisfies PulseEvent,
+      timestamp,
+    }
   }
 
-    if (selectedPulseId) {
+  const persistPulse = (
+    pulse: PulseEvent,
+    successMessage: string,
+    featureProgress?: { featureId: string; status: (typeof FEATURE_STATUSES)[number]; column: FeatureColumn; timestamp: string },
+  ) => {
     setAppState((current) => ({
       ...current,
-        pulses: current.pulses.map((entry) => (entry.id === selectedPulseId ? pulse : entry)),
-      }))
-      setStatusMessage('Pulse updated.')
-    } else {
-      setAppState((current) => ({
-        ...current,
-        pulses: [pulse, ...current.pulses],
-      }))
-      setStatusMessage('Pulse added.')
+      features: featureProgress
+        ? current.features.map((feature) =>
+            feature.id === featureProgress.featureId
+              ? {
+                  ...feature,
+                  status: featureProgress.status,
+                  column: featureProgress.column,
+                  updated_at: featureProgress.timestamp,
                 }
-
+              : feature,
+          )
+        : current.features,
+      pulses: selectedPulseId ? current.pulses.map((entry) => (entry.id === selectedPulseId ? pulse : entry)) : [pulse, ...current.pulses],
+    }))
+    setStatusMessage(successMessage)
     resetPulseDraft()
   }
 
+  const savePulse = () => {
+    const draftPulse = buildPulseFromDraft()
+    if (!draftPulse) return
+    persistPulse(draftPulse.pulse, selectedPulseId ? 'Pulse updated.' : 'Pulse added.')
+  }
+
+  const savePulseWithFeatureProgress = (status: (typeof FEATURE_STATUSES)[number], column: FeatureColumn) => {
+    const draftPulse = buildPulseFromDraft()
+    if (!draftPulse) return
+    if (!draftPulse.pulse.feature_id) {
+      setStatusMessage('Link a feature before using the build-loop progress buttons.')
+      return
+    }
+
+    const feature = appState.features.find((entry) => entry.id === draftPulse.pulse.feature_id)
+    persistPulse(
+      draftPulse.pulse,
+      feature ? `Pulse added and “${feature.title}” moved to ${status}.` : `Pulse added and feature moved to ${status}.`,
+      { featureId: draftPulse.pulse.feature_id, status, column, timestamp: draftPulse.timestamp },
+    )
+  }
+
   const deletePulse = (pulseId: string) => {
     setAppState((current) => ({
       ...current,
@@ -1194,6 +1310,28 @@ function App() {
     setStatusMessage('Pulse deleted.')
   }
 
+  const answerClarifyingQuestion = async () => {
+    const answer = triageClarificationAnswer.trim()
+    if (!answer) {
+      setTriageError('Give the AI a real answer first.')
+      setTriageStatus('error')
+      return
+    }
+
+    const mergedContext = [triageDraft.optionalContext.trim(), `Clarification answer: ${answer}`]
+      .filter(Boolean)
+      .join('\n\n')
+
+    setTriageDraft((current) => ({
+      ...current,
+      optionalContext: mergedContext,
+    }))
+    setTriageRecommendation(null)
+    setTriageEditMode(false)
+    setStatusMessage('Re-running triage with your clarification…')
+    await runAiTriage(mergedContext)
+  }
+
   const copyMarkdown = async (filename: string) => {
     try {
       await navigator.clipboard.writeText(markdownPackage[filename as keyof typeof markdownPackage])
@@ -1203,15 +1341,118 @@ function App() {
     }
   }
 
-  const copySessionPrompt = async () => {
+  const buildHandoffPrompt = (featureId?: string, target = promptTarget) => {
+    const resolvedFeatureId = featureId ?? selectedFeature?.id ?? (promptFeatureId || groupedFeatures.now[0]?.id)
+    return {
+      resolvedFeatureId,
+      prompt: createAgentSessionPrompt(appState, {
+        featureId: resolvedFeatureId || undefined,
+        target,
+      }),
+    }
+  }
+
+  const startFeatureSession = (featureId: string, target: (typeof PROMPT_TARGETS)[number]) => {
+    const feature = appState.features.find((entry) => entry.id === featureId)
+    if (!feature) return null
+
+    const timestamp = nowIso()
+    const pulse: PulseEvent = {
+      id: `pulse_${Date.now().toString(36)}`,
+      timestamp,
+      project_id: appState.project.id,
+      feature_id: feature.id,
+      source: 'buildpulse',
+      agent_id: target,
+      pulse_type: 'SESSION_START',
+      message: `Started ${target} build session for feature “${feature.title}”.`,
+      confidence_score: 0.9,
+      evidence_refs: [
+        'Today build-loop handoff action',
+        feature.release_id ? `Release: ${appState.releases.find((release) => release.id === feature.release_id)?.name || feature.release_id}` : 'No linked release',
+        feature.phase_id ? `Phase: ${appState.phases.find((phase) => phase.id === feature.phase_id)?.title || feature.phase_id}` : 'No linked phase',
+      ],
+    }
+
+    const nextFeature = {
+      ...feature,
+      column: feature.column === 'done' ? feature.column : ('now' as FeatureColumn),
+      status: feature.status === 'done' ? feature.status : ('building' as (typeof FEATURE_STATUSES)[number]),
+      updated_at: timestamp,
+    }
+
+    setAppState((current) => ({
+      ...current,
+      features: current.features.map((entry) => (entry.id === feature.id ? nextFeature : entry)),
+      pulses: [pulse, ...current.pulses],
+    }))
+
+    return nextFeature
+  }
+
+  const copyFocusedHandoff = async (featureId?: string, target = promptTarget, shouldLogIntent = false, promptOverride?: string) => {
+    const { resolvedFeatureId, prompt } = buildHandoffPrompt(featureId, target)
+    const finalPrompt = promptOverride ?? prompt
+
     try {
-      await navigator.clipboard.writeText(sessionPrompt)
-      setStatusMessage('AI session prompt copied to clipboard.')
+      await navigator.clipboard.writeText(finalPrompt)
+      if (resolvedFeatureId) {
+        setPromptFeatureId(resolvedFeatureId)
+      }
+      setPromptTarget(target)
+
+      let feature = resolvedFeatureId ? appState.features.find((entry) => entry.id === resolvedFeatureId) : null
+      if (resolvedFeatureId && shouldLogIntent) {
+        feature = startFeatureSession(resolvedFeatureId, target) ?? feature
+      }
+
+      setStatusMessage(
+        feature
+          ? `${target} handoff for “${feature.title}” copied${shouldLogIntent ? ', session started, and status moved to building' : ''}.`
+          : `${target} handoff copied${shouldLogIntent ? ' and session started' : ''}.`,
+      )
+      return true
     } catch {
       setStatusMessage('Clipboard copy failed. Browser said no.')
+      return false
     }
   }
 
+  const openHandoffPreview = (featureId?: string, target = promptTarget) => {
+    const { resolvedFeatureId, prompt } = buildHandoffPrompt(featureId, target)
+    if (resolvedFeatureId) {
+      setPromptFeatureId(resolvedFeatureId)
+      setHandoffPreviewFeatureId(resolvedFeatureId)
+    }
+    setHandoffPreviewTarget(target)
+    setHandoffPreviewDraft(prompt)
+    setHandoffPreviewOpen(true)
+    setStatusMessage('Preview the handoff, tweak it if needed, then copy when ready.')
+  }
+
+  const syncHandoffPreviewTarget = (target: (typeof PROMPT_TARGETS)[number]) => {
+    const { prompt } = buildHandoffPrompt(handoffPreviewFeatureId || undefined, handoffPreviewTarget)
+    if (handoffPreviewDraft.trim() !== prompt.trim()) {
+      const shouldReplace = window.confirm('Switching target will replace your current edits with the new preset. Continue?')
+      if (!shouldReplace) return
+    }
+
+    const { prompt: nextPrompt } = buildHandoffPrompt(handoffPreviewFeatureId || undefined, target)
+    setHandoffPreviewTarget(target)
+    setHandoffPreviewDraft(nextPrompt)
+  }
+
+  const resetHandoffPreview = () => {
+    if (!handoffPreviewFeatureId) return
+    const { prompt } = buildHandoffPrompt(handoffPreviewFeatureId, handoffPreviewTarget)
+    setHandoffPreviewDraft(prompt)
+    setStatusMessage('Handoff preview reset to the current preset.')
+  }
+
+  const copySessionPrompt = async () => {
+    await copyFocusedHandoff(promptFeatureId || undefined, promptTarget, false)
+  }
+
   const handleImport = async (event: ChangeEvent<HTMLInputElement>) => {
     const file = event.target.files?.[0]
     if (!file) return
@@ -1307,7 +1548,7 @@ function App() {
       tab: 'export' as TabKey,
       operatorNote: 'Use this when another agent or coding session needs clean context without archaeology.',
       evidence: ['JSON export preserves full app state.', 'JSONL export carries pulse history.', 'Markdown package includes agent-facing project, feature, parking, pulse, and context files.'],
-      next: 'Add a “copy focused handoff” button directly on each capability detail.',
+      next: 'Add target-specific prompt presets so OpenClaw, Codex, and Claude get sharper default briefs.',
     },
     {
       title: 'Appwrite Sync',
@@ -1339,8 +1580,8 @@ function App() {
     <div className="app-shell">
       <header className="mobile-shell-header card">
         <div>
-          <p className="eyebrow">BuildPulse v0.3.0</p>
-          <h1>{appState.project.name}</h1>
+          <p className="eyebrow">BuildPulse v0.4.8</p>
+          <h1>BuildPulse</h1>
           <p className="hero-goal compact-goal">
             <strong>Current goal:</strong> {appState.project.current_goal || 'Classify new ideas before they become work.'}
           </p>
@@ -1348,8 +1589,8 @@ function App() {
         <div className="top-status-row">
           <span className={`status-dot ${backendMode === 'appwrite' ? 'healthy' : backendMode === 'connecting' ? 'connecting' : 'degraded'}`} aria-hidden="true" />
           <span>{backendMode === 'appwrite' ? 'Live' : backendMode === 'connecting' ? 'Syncing' : 'Local'}</span>
-          <button type="button" className="ghost small" onClick={() => setActiveTab('status')}>
-            System Status
+          <button type="button" className="ghost small" aria-label="Open system status" onClick={() => setActiveTab('status')}>
+            Status
           </button>
         </div>
       </header>
@@ -1525,16 +1766,20 @@ function App() {
 
                     <div className="triage-step-card triage-decision-box">
                       <p className="eyebrow">Step 3 of 3</p>
-                      <h3>Choose action</h3>
-                      <p>AI advises. You decide.</p>
+                      <h3>{triageNeedsClarification ? 'Clarify before deciding' : 'Choose action'}</h3>
+                      <p>{triageNeedsClarification ? 'Answer the question, then re-run triage with the missing detail.' : 'AI advises. You decide.'}</p>
                       <div className="button-row triage-action-stack">
                         {triageNeedsClarification ? (
                           <>
-                            <button type="button" onClick={() => setTriageEditMode(true)}>Answer Question</button>
+                            <button type="button" className="primary" onClick={() => {
+                              setTriageEditMode(true)
+                              setStatusMessage('Answer the clarification question below, then re-run triage.')
+                            }}>Answer + Retry</button>
                             <button type="button" className="ghost" onClick={() => {
                               setTriageRecommendation(null)
                               setTriageStatus('idle')
                               setTriageEditMode(false)
+                              setTriageClarificationAnswer('')
                             }}>Edit Idea</button>
                             <button type="button" className="danger small" onClick={rejectTriageRecommendation}>Reject</button>
                           </>
@@ -1560,7 +1805,32 @@ function App() {
 
                     {triageEditMode && (
                       <div className="triage-step-card triage-edit-fields form-grid">
-                        <p className="eyebrow">Edit before saving</p>
+                        <p className="eyebrow">{triageNeedsClarification ? 'Answer and refine' : 'Edit before saving'}</p>
+                        {triageNeedsClarification && (
+                          <>
+                            <div className="triage-callout warning full-span">
+                              <strong>Answer the question</strong>
+                              <p>{triageRecommendation?.clarifying_question || 'Clarify the idea, then re-run triage.'}</p>
+                            </div>
+                            <label className="full-span">
+                              Your answer
+                              <textarea
+                                rows={4}
+                                value={triageClarificationAnswer}
+                                onChange={(event) => setTriageClarificationAnswer(event.target.value)}
+                                placeholder="Add the missing detail so the AI can classify the idea properly."
+                              />
+                            </label>
+                            <div className="button-inline-row full-span">
+                              <button type="button" onClick={() => void answerClarifyingQuestion()} disabled={triageStatus === 'loading'}>
+                                {triageStatus === 'loading' ? 'Re-running…' : 'Re-run with Answer'}
+                              </button>
+                              <button type="button" className="ghost small" onClick={() => setTriageEditMode(false)}>
+                                Hide Clarification
+                              </button>
+                            </div>
+                          </>
+                        )}
                         <label>
                           Placement
                           <select value={triageEditable.placement} onChange={(event) => setTriageEditable((current) => ({ ...current, placement: event.target.value as AiPlacement }))}>
@@ -1603,12 +1873,101 @@ function App() {
         </div>
       )}
 
+      {handoffPreviewOpen && handoffPreviewFeature && (
+        <div className="editor-sheet-backdrop handoff-backdrop" role="presentation">
+          <section className="card editor-sheet handoff-sheet" role="dialog" aria-modal="true" aria-label="Handoff preview">
+            <div className="section-heading compact">
+              <div>
+                <p className="eyebrow">v0.4.4 Build handoff</p>
+                <h3>{handoffPreviewFeature.title}</h3>
+                <p>Choose the target, tweak the brief if needed, then copy it cleanly.</p>
+              </div>
+              <button type="button" className="ghost small" onClick={() => setHandoffPreviewOpen(false)}>
+                Close
+              </button>
+            </div>
+
+            <div className="sheet-summary-grid handoff-preview-grid">
+              <div className="focus-panel">
+                <h4>Preview context</h4>
+                <div className="focus-badges">
+                  <span className="pill">{handoffPreviewTarget}</span>
+                  <span className="pill">{handoffPreviewFeature.status}</span>
+                  <span className={`pill ${handoffPreviewFeature.priority}`}>{handoffPreviewFeature.priority}</span>
+                  {handoffPreviewFeature.release_role && <span className="pill">{handoffPreviewFeature.release_role}</span>}
+                </div>
+                <p><strong>Phase:</strong> {appState.phases.find((phase) => phase.id === handoffPreviewFeature.phase_id)?.title || 'No phase linked'}</p>
+                <p><strong>Release:</strong> {appState.releases.find((release) => release.id === handoffPreviewFeature.release_id)?.name || 'No release linked'}</p>
+                <p><strong>Acceptance criteria:</strong> {handoffPreviewFeature.acceptance_criteria.length ? handoffPreviewFeature.acceptance_criteria.join('; ') : 'None yet'}</p>
+                <p><strong>Scope guard:</strong> {handoffPreviewFeature.scope_notes || 'No scope notes yet.'}</p>
+              </div>
+              <div className="focus-panel">
+                <h4>Handoff controls</h4>
+                <div className="button-inline-row">
+                  {PROMPT_TARGETS.map((target) => (
+                    <button
+                      key={target}
+                      type="button"
+                      className={handoffPreviewTarget === target ? 'primary small' : 'ghost small'}
+                      onClick={() => syncHandoffPreviewTarget(target)}
+                    >
+                      {target}
+                    </button>
+                  ))}
+                </div>
+                <p className="tap-hint">Preview mode is the safer path when you want to edit wording, copy the brief, and mark the feature as actively building.</p>
+                <p className="tap-hint">Switching targets resets the draft to that target’s preset.</p>
+                <div className="button-inline-row">
+                  <button type="button" className="ghost small" onClick={resetHandoffPreview}>Reset to preset</button>
+                  <button type="button" className="ghost small" onClick={() => openFeatureHandoff(handoffPreviewFeature.id)}>Open in Export</button>
+                </div>
+              </div>
+            </div>
+
+            <label className="full-span handoff-preview-editor">
+              <span>Editable handoff brief</span>
+              <textarea
+                rows={18}
+                value={handoffPreviewDraft}
+                onChange={(event) => setHandoffPreviewDraft(event.target.value)}
+              />
+            </label>
+
+            <div className="button-row sheet-actions">
+              <button
+                type="button"
+                className="ghost"
+                onClick={async () => {
+                  const ok = await copyFocusedHandoff(handoffPreviewFeature.id, handoffPreviewTarget, false, handoffPreviewDraft)
+                  if (ok) setHandoffPreviewOpen(false)
+                }}
+              >
+                Copy Handoff
+              </button>
+              <button
+                type="button"
+                className="primary"
+                onClick={async () => {
+                  const ok = await copyFocusedHandoff(handoffPreviewFeature.id, handoffPreviewTarget, true, handoffPreviewDraft)
+                  if (ok) setHandoffPreviewOpen(false)
+                }}
+              >
+                Copy + Start Session
+              </button>
+              <button type="button" className="ghost" onClick={() => setHandoffPreviewOpen(false)}>
+                Cancel
+              </button>
+            </div>
+          </section>
+        </div>
+      )}
+
       {featureSheetOpen && (
         <div className="editor-sheet-backdrop" role="presentation">
           <section className="card editor-sheet" role="dialog" aria-modal="true" aria-label={selectedFeature ? 'Feature details' : 'Manual feature'}>
             <div className="section-heading compact">
               <div>
-                <p className="eyebrow">{selectedFeature ? 'Feature focus' : 'Manual feature'}</p>
+                <p className="eyebrow">{selectedFeature ? 'Build session' : 'Manual feature'}</p>
                 <h3>{selectedFeature ? selectedFeature.title : 'Add Feature'}</h3>
                 <p>{selectedFeature ? (selectedFeature.description || 'No description yet.') : 'Use this when you deliberately want to bypass AI triage.'}</p>
               </div>
@@ -1626,13 +1985,23 @@ function App() {
 
             {selectedFeature && (
               <div className="sheet-summary-grid">
-                <div className="focus-panel">
+                <div className="focus-panel session-command-panel">
                   <div className="focus-badges">
                     <span className={`pill ${selectedFeature.priority}`}>{selectedFeature.priority}</span>
                     <span className="pill">{selectedFeature.status}</span>
                     <span className="pill">{columnLabels[selectedFeature.column]}</span>
                     {selectedFeature.release_role && <span className="pill">{selectedFeature.release_role}</span>}
                   </div>
+                  <h4>Next sane action</h4>
+                  <p>Start a focused AI session, then come back and record the result. This is the v0.4 loop.</p>
+                  <div className="button-inline-row sticky-action-row">
+                    <button type="button" className="primary small" onClick={() => openHandoffPreview(selectedFeature.id, 'OpenClaw')}>
+                      Start AI Session
+                    </button>
+                    <button type="button" className="ghost small" onClick={() => openFeatureResultCapture(selectedFeature.id)}>
+                      Record Result
+                    </button>
+                  </div>
                   <h4>Acceptance Criteria</h4>
                   {selectedFeature.acceptance_criteria.length ? (
                     <ul>
@@ -1662,10 +2031,26 @@ function App() {
                   )}
                   <div className="button-inline-row">
                     <button type="button" className="ghost small" onClick={() => openFeaturePulse(selectedFeature.id)}>
-                      Log Feature Pulse
+                      Add Activity Note
                     </button>
                     <button type="button" className="ghost small" onClick={() => openFeatureHandoff(selectedFeature.id)}>
-                      Prepare AI Handoff
+                      Open Session Export
+                    </button>
+                  </div>
+                  <p className="tap-hint">Quick-copy is here for speed. Use Start AI Session when the wording matters.</p>
+                  <p className="tap-hint">Quick copy targets</p>
+                  <div className="button-inline-row">
+                    <button type="button" className="ghost small" onClick={() => void copyFocusedHandoff(selectedFeature.id, 'OpenClaw', false)}>
+                      Copy for OpenClaw
+                    </button>
+                    <button type="button" className="ghost small" onClick={() => void copyFocusedHandoff(selectedFeature.id, 'Claude Code', false)}>
+                      Copy for Claude Code
+                    </button>
+                    <button type="button" className="ghost small" onClick={() => void copyFocusedHandoff(selectedFeature.id, 'Codex', false)}>
+                      Copy for Codex
+                    </button>
+                    <button type="button" className="ghost small" onClick={() => void copyFocusedHandoff(selectedFeature.id, 'Generic Agent', false)}>
+                      Copy Generic Brief
                     </button>
                   </div>
                 </div>
@@ -1909,8 +2294,19 @@ function App() {
                 <textarea rows={4} value={pulseDraft.evidenceRefs} onChange={(event) => setPulseDraft((current) => ({ ...current, evidenceRefs: event.target.value }))} />
               </label>
             </div>
+            {pulseDraftCanUpdateProgress && (
+              <div className="result-progress-strip" aria-label="Build-loop progress shortcuts">
+                <span>Finish the loop for {pulseDraftFeature?.title}</span>
+                <button type="button" className="ghost small" onClick={() => savePulseWithFeatureProgress('testing', 'now')}>
+                  Save + Move to Testing
+                </button>
+                <button type="button" className="primary small" onClick={() => savePulseWithFeatureProgress('done', 'done')}>
+                  Save + Mark Done
+                </button>
+              </div>
+            )}
             <div className="button-row sheet-actions">
-              <button type="button" onClick={savePulse}>{selectedPulse ? 'Save Changes' : 'Add Pulse'}</button>
+              <button type="button" onClick={savePulse}>{selectedPulse ? 'Save Changes' : 'Add Pulse Only'}</button>
               <button type="button" className="ghost" onClick={resetPulseDraft}>Clear</button>
               {selectedPulse && (
                 <button type="button" className="danger" onClick={() => deletePulse(selectedPulse.id)}>
@@ -1939,7 +2335,7 @@ function App() {
           <section className="card functionality-hero">
             <div>
               <p className="eyebrow">Secondary status</p>
-              <h3>{appState.project.name} is now a local-first v0.3 cockpit with Appwrite sync and release-planning structure.</h3>
+              <h3>{appState.project.name} is now a local-first v0.4 cockpit with release structure, AI triage, and one-tap handoff prep.</h3>
               <p>
                 The planning loop works from browser storage first, then syncs to Appwrite for the deployed Unraid runtime. If sync degrades, the cockpit should still stay usable locally.
               </p>
@@ -2029,8 +2425,18 @@ function App() {
                 <h3>{selectedStatusCard.title}</h3>
                 <p>{selectedStatusCard.operatorNote}</p>
               </div>
+              <div className="button-inline-row">
+                {selectedStatusCard.title === 'AI Handoff + Export' && (
+                  <button type="button" className="ghost small" onClick={() => void copyFocusedHandoff(undefined, 'OpenClaw')}>
+                    Copy Focused Handoff
+                  </button>
+                )}
+                <button type="button" className="ghost small" onClick={() => setActiveTab(selectedStatusCard.tab)}>
+                  {selectedStatusCard.action}
+                </button>
                 <span className={`pill functionality-${selectedStatusCard.status}`}>{selectedStatusCard.status}</span>
               </div>
+            </div>
             <div className="functionality-detail-grid">
               <article>
                 <h4>Proof it exists</h4>
@@ -2076,65 +2482,171 @@ function App() {
 
       {activeTab === 'feature-plan' && (
         <section className="view-stack plan-view">
-          <section className="card plan-home-card">
+          <section className="card today-card">
             <div className="section-heading compact">
               <div>
-                <p className="eyebrow">Home / Plan</p>
-                <h2>Triage first. Create later. Log always.</h2>
-                <p>{appState.project.current_goal || 'Classify new ideas before they become work.'}</p>
+                <p className="eyebrow">Today</p>
+                <h2>Capture → Brief → Build</h2>
+                <p>One decision at a time. Capture the idea, pick the next move, hand it to an agent.</p>
               </div>
-              <div className="button-inline-row">
-                <button type="button" className="primary-triage-button" onClick={() => openTriage()}>
-                  Triage Idea
+            </div>
+
+            <div className="today-command-bar" aria-label="Today primary workflow">
+              <button type="button" className="primary-triage-button today-primary-command" onClick={() => openTriage()}>
+                Capture new idea
               </button>
-                <button type="button" className="ghost" onClick={() => setShowManualFeatureEditor((current) => !current)}>
-                  {showManualFeatureEditor || selectedFeature ? 'Hide Add Feature' : 'Add Feature'}
+              <button
+                type="button"
+                className="ghost today-drawer-toggle"
+                aria-expanded={todayCommandDrawerOpen}
+                aria-controls="today-command-drawer"
+                onClick={() => setTodayCommandDrawerOpen((current) => !current)}
+              >
+                {todayCommandDrawerOpen ? 'Hide' : 'More'}
+              </button>
+            </div>
+
+            {todayCommandDrawerOpen && (
+              <div id="today-command-drawer" className="today-command-drawer" aria-label="Secondary Today commands">
+                <div>
+                  <p className="eyebrow">Build</p>
+                  <button
+                    type="button"
+                    className="drawer-command primary"
+                    disabled={!focusFeature}
+                    onClick={() => {
+                      if (!focusFeature) return
+                      setTodayCommandDrawerOpen(false)
+                      openHandoffPreview(focusFeature.id, 'OpenClaw')
+                    }}
+                  >
+                    Start AI session
+                  </button>
+                  <button
+                    type="button"
+                    className="drawer-command"
+                    disabled={!focusFeature}
+                    onClick={() => {
+                      if (!focusFeature) return
+                      setTodayCommandDrawerOpen(false)
+                      openFeatureResultCapture(focusFeature.id)
+                    }}
+                  >
+                    Record result
+                  </button>
+                  <button
+                    type="button"
+                    className="drawer-command"
+                    disabled={!focusFeature}
+                    onClick={() => {
+                      if (!focusFeature) return
+                      setTodayCommandDrawerOpen(false)
+                      beginFeatureEdit(focusFeature)
+                    }}
+                  >
+                    Focus details
+                  </button>
+                </div>
+                <div>
+                  <p className="eyebrow">Sort</p>
+                  <button
+                    type="button"
+                    className="drawer-command"
+                    onClick={() => {
+                      setTodayCommandDrawerOpen(false)
+                      setShowManualFeatureEditor((current) => !current)
+                    }}
+                  >
+                    Manual feature
+                  </button>
+                  <button
+                    type="button"
+                    className="drawer-command"
+                    onClick={() => {
+                      setTodayCommandDrawerOpen(false)
+                      setActiveTab('parking-lot')
+                    }}
+                  >
+                    Parked ideas
+                  </button>
+                  <button
+                    type="button"
+                    className="drawer-command"
+                    onClick={() => {
+                      setTodayCommandDrawerOpen(false)
+                      setActiveTab('pulse-log')
+                    }}
+                  >
+                    Pulse history
+                  </button>
+                </div>
+                <div>
+                  <p className="eyebrow">Ship</p>
+                  <button
+                    type="button"
+                    className="drawer-command"
+                    onClick={() => {
+                      setTodayCommandDrawerOpen(false)
+                      setActiveTab('roadmap')
+                    }}
+                  >
+                    Release view
+                  </button>
+                  <button
+                    type="button"
+                    className="drawer-command"
+                    onClick={() => {
+                      setTodayCommandDrawerOpen(false)
+                      setActiveTab('export')
+                    }}
+                  >
+                    Session handoff
                   </button>
                 </div>
               </div>
+            )}
 
-            <div className="flow-breadcrumbs" aria-label="BuildPulse flow">
-              <span>Raw idea</span>
-              <span>AI recommendation</span>
-              <span>User decision</span>
-              <span>DECISION pulse</span>
+            <div className="today-grid">
+              <article className="focus-panel today-focus-card">
+                <p className="eyebrow">Focus</p>
+                {focusFeature ? (
+                  <>
+                    <h3>{focusFeature.title}</h3>
+                    <p>{focusFeature.description || 'No description yet.'}</p>
+                    <div className="focus-badges">
+                      <span className={`pill ${focusFeature.priority}`}>{focusFeature.priority}</span>
+                      <span className="pill">{focusFeature.status}</span>
+                      <span className="pill">{columnLabels[focusFeature.column]}</span>
                     </div>
+                    <p className="today-card-note">Use Commands for build, result, and detail actions.</p>
+                  </>
+                ) : (
+                  <p>No focus feature yet. Add an idea and let triage decide if it deserves to become work.</p>
+                )}
+              </article>
 
-            <div className="cockpit-counts plan-counts">
-              <span>Now <strong>{groupedFeatures.now.length}</strong></span>
-              <span>Next <strong>{groupedFeatures.next.length}</strong></span>
-              <span>Later <strong>{groupedFeatures.later.length}</strong></span>
-              <span>Parking Lot <strong>{appState.parking_lot.length}</strong></span>
+              <article className="focus-panel today-release-card">
+                <p className="eyebrow">Current release</p>
+                <h3>{selectedRelease?.name || 'No release selected'}</h3>
+                <p>{selectedRelease?.goal || 'Pick the release that matters now.'}</p>
+                <div className="compact-stack">
+                  <small>{activeReleaseSummary}</small>
+                  <small>{selectedReleaseBlockers.length ? `${selectedReleaseBlockers.length} required item(s) still open` : 'No required blockers detected'}</small>
+                  <small>{selectedRelease?.forbidden_feature_titles.length ? `Forbidden right now: ${selectedRelease.forbidden_feature_titles.slice(0, 3).join(', ')}` : 'No forbidden-work list yet'}</small>
                 </div>
+                <p className="today-card-note">Release controls live in Commands.</p>
+              </article>
 
-            <details className="card inline-details compact-project-details">
-              <summary>Project details</summary>
-              <div className="form-grid project-grid compact-project-form">
-                <label>
-                  Project name
-                  <input value={appState.project.name} onChange={(event) => updateProject('name', event.target.value)} />
-                </label>
-                <label>
-                  One-line pitch
-                  <input value={appState.project.one_line_pitch} onChange={(event) => updateProject('one_line_pitch', event.target.value)} />
-                </label>
-                <label className="full-span">
-                  Description
-                  <textarea rows={3} value={appState.project.description} onChange={(event) => updateProject('description', event.target.value)} />
-                </label>
-                <label className="full-span">
-                  Current goal
-                  <input value={appState.project.current_goal} onChange={(event) => updateProject('current_goal', event.target.value)} />
-                </label>
-                <label className="full-span">
-                  Notes
-                  <textarea rows={3} value={appState.project.notes} onChange={(event) => updateProject('notes', event.target.value)} />
-                </label>
+              <article className="focus-panel today-decision-card">
+                <p className="eyebrow">Needs decision</p>
+                <h3>{duplicateParkingGroups.length ? `${duplicateParkingGroups.length} duplicate idea group${duplicateParkingGroups.length === 1 ? '' : 's'}` : 'No obvious duplicate pile-ups'}</h3>
+                <p>{appState.parking_lot.length} parked · {appState.pulses.length} pulses</p>
+                <p className="today-card-note">Decision controls live in Commands.</p>
+              </article>
             </div>
-            </details>
           </section>
 
-          <p className="tap-hint">Tap any feature card to open a dedicated sheet with the full details and actions.</p>
+          <p className="tap-hint">Open details only when you need them. The happy path is: add idea → start session → record result.</p>
           <div className="board-grid accordion-board">
             {FEATURE_COLUMNS.map((column) => (
               <details key={column} className="column card feature-column-details" open={column === 'now'}>
@@ -2148,25 +2660,17 @@ function App() {
                   {groupedFeatures[column].length ? (
                     groupedFeatures[column].map((feature) => {
                       return (
-                        <button key={feature.id} type="button" className="item-card feature-card compact-feature-card" onClick={() => beginFeatureEdit(feature)}>
+                        <button key={feature.id} type="button" className="item-card feature-card compact-feature-card simplified-feature-card" onClick={() => beginFeatureEdit(feature)}>
                           <div className="item-card-header">
                             <strong>{feature.title}</strong>
-                            <span className={`pill ${feature.priority}`}>{feature.priority}</span>
-                          </div>
-                          <div className="feature-signal-row">
-                            <span>{columnLabels[feature.column]}</span>
                             <span className="pill">{feature.status}</span>
+                          </div>
+                          <p>{feature.description || feature.scope_notes || 'No outcome written yet.'}</p>
+                          <div className="feature-signal-row">
+                            <span className={`pill ${feature.priority}`}>{feature.priority}</span>
                             <span>{feature.acceptance_criteria.length} criteria</span>
+                            <span>Open details</span>
                           </div>
-                          {(feature.phase_id || feature.release_id) && (
-                            <div className="feature-signal-row roadmap-badges">
-                              {feature.phase_id && <span>{appState.phases.find((phase) => phase.id === feature.phase_id)?.title || 'Phase'}</span>}
-                              {feature.release_id && <span>{appState.releases.find((release) => release.id === feature.release_id)?.name || 'Release'}</span>}
-                              {feature.release_role && <span className="pill">{feature.release_role}</span>}
-                            </div>
-                          )}
-                          {feature.triaged_at && <small>AI triaged {formatDateTime(feature.triaged_at)}</small>}
-                          <span className="tap-chip">Tap to open</span>
                         </button>
                       )
                     })

src/features/export/exporters.ts

@@ -39,6 +39,47 @@ const renderFeature = (feature: Feature) => {
 const sortPulsesNewestFirst = (pulses: PulseEvent[]) =>
   [...pulses].sort((a, b) => b.timestamp.localeCompare(a.timestamp))
 
+const isFeatureDone = (feature: Feature) => feature.status === 'done' || feature.column === 'done'
+
+const targetPresets: Record<string, { intro: string; workingStyle: string[]; deliverBack: string[] }> = {
+  OpenClaw: {
+    intro: 'Work like a proactive operator: act, verify, and keep the slice small enough to ship cleanly.',
+    workingStyle: [
+      'Use local repo evidence before making claims.',
+      'Prefer direct fixes plus a quick verification gate.',
+      'Keep follow-up notes short and operational.',
+    ],
+    deliverBack: ['What changed', 'Files touched', 'How you verified it', 'Any blocker or parked follow-up'],
+  },
+  'Claude Code': {
+    intro: 'Work like a careful coding pair: make the smallest coherent change, explain tradeoffs briefly, and leave the tree tidy.',
+    workingStyle: [
+      'Prefer narrowly scoped edits over broad rewrites.',
+      'Call out any assumption that could affect correctness.',
+      'End with concise verification notes and next-risk if any.',
+    ],
+    deliverBack: ['Summary', 'Files changed', 'Verification', 'Risks or follow-ups'],
+  },
+  Codex: {
+    intro: 'Work like a focused implementation run: minimal scope, crisp diffs, and explicit evidence before claiming success.',
+    workingStyle: [
+      'Bias toward direct implementation over long discussion.',
+      'Preserve existing behavior unless the task explicitly changes it.',
+      'Name the exact verification step you ran.',
+    ],
+    deliverBack: ['Changes made', 'Touched files', 'Verification run', 'Remaining follow-up'],
+  },
+  'Generic Agent': {
+    intro: 'Deliver one clean, well-bounded improvement without drifting into adjacent ideas.',
+    workingStyle: [
+      'Stay anchored to the focus feature.',
+      'Avoid speculative architecture work.',
+      'Return with concrete evidence, not just intention.',
+    ],
+    deliverBack: ['What changed', 'Files touched', 'How you verified it', 'Any blocker or parked follow-up'],
+  },
+}
+
 export const createAgentSessionPrompt = (
   state: AppState,
   options?: {
@@ -48,12 +89,36 @@ export const createAgentSessionPrompt = (
 ) => {
   const grouped = groupFeatures(state.features)
   const target = options?.target || 'AI coding agent'
+  const preset = targetPresets[target] || targetPresets['Generic Agent']
   const focusFeature = options?.featureId ? state.features.find((feature) => feature.id === options.featureId) ?? null : grouped.now[0] ?? null
   const focusRelease = focusFeature?.release_id ? state.releases.find((release) => release.id === focusFeature.release_id) ?? null : null
   const focusPhase = focusFeature?.phase_id ? state.phases.find((phase) => phase.id === focusFeature.phase_id) ?? null : null
   const relatedPulses = sortPulsesNewestFirst(state.pulses)
     .filter((pulse) => (focusFeature ? pulse.feature_id === focusFeature.id : true))
     .slice(0, 6)
+  const releaseFeatures = focusRelease
+    ? state.features.filter((feature) => feature.release_id === focusRelease.id)
+    : []
+  const requiredReleaseFeatures = focusRelease
+    ? releaseFeatures.filter((feature) => focusRelease.required_feature_ids.includes(feature.id))
+    : []
+  const completedRequiredFeatures = requiredReleaseFeatures.filter(isFeatureDone)
+  const remainingRequiredFeatures = requiredReleaseFeatures.filter((feature) => !isFeatureDone(feature))
+  const releaseBlockers = sortPulsesNewestFirst(state.pulses)
+    .filter((pulse) => {
+      if (pulse.pulse_type !== 'BLOCKER') return false
+      if (focusFeature && pulse.feature_id === focusFeature.id) return true
+      if (!focusRelease) return false
+      return releaseFeatures.some((feature) => feature.id === pulse.feature_id)
+    })
+    .slice(0, 4)
+  const forbiddenWarnings = [
+    ...(focusRelease?.forbidden_feature_titles || []).map((title) => `${title} — forbidden in this release.`),
+    ...state.parking_lot.map((item) => `${item.title} — ${item.reason_parked || item.description || 'Parked for later.'}`),
+  ]
+  const readinessSummary = focusRelease
+    ? `Required done: ${completedRequiredFeatures.length}/${requiredReleaseFeatures.length || focusRelease.required_feature_ids.length || 0}`
+    : 'No release linked to this feature yet.'
 
   const renderFeatureBlock = (feature: Feature | null) => {
     if (!feature) return '- No specific feature selected yet. Choose the smallest useful next move.'
@@ -75,6 +140,7 @@ export const createAgentSessionPrompt = (
   return [
     `You are the ${target} for ${state.project.name}.`,
     '',
+    preset.intro,
     'Read the project context below and ship the smallest high-quality improvement that satisfies the focus feature without scope creep.',
     '',
     '## Project',
@@ -97,15 +163,28 @@ export const createAgentSessionPrompt = (
     '## Next Up',
     grouped.next.length ? grouped.next.map((feature) => `- ${feature.title} (${feature.status})`).join('\n') : '- Nothing queued yet.',
     '',
-    '## Current Release Context',
+    '## Current Phase + Release Context',
     focusRelease
-      ? [`- Release: ${focusRelease.name}`, `- Goal: ${focusRelease.goal}`, `- Status: ${focusRelease.status}`, `- Definition of done: ${focusRelease.definition_of_done.length ? focusRelease.definition_of_done.join('; ') : '—'}`].join('\n')
-      : '- No release linked to this feature yet.',
+      ? [
+          `- Phase: ${focusPhase?.title || '—'} (${focusPhase?.status || '—'})`,
+          `- Release: ${focusRelease.name}`,
+          `- Goal: ${focusRelease.goal}`,
+          `- Status: ${focusRelease.status}`,
+          `- Release readiness: ${readinessSummary}`,
+          `- Remaining required features: ${remainingRequiredFeatures.length ? remainingRequiredFeatures.map((feature) => feature.title).join('; ') : 'None'}`,
+          `- Definition of done: ${focusRelease.definition_of_done.length ? focusRelease.definition_of_done.join('; ') : '—'}`,
+        ].join('\n')
+      : `- Phase: ${focusPhase?.title || '—'} (${focusPhase?.status || '—'})\n- No release linked to this feature yet.`,
     '',
-    '## Parking Lot / Do Not Implement Yet',
-    state.parking_lot.length
-      ? state.parking_lot.map((item) => `- ${item.title} — ${item.reason_parked || item.description || 'Parked for later.'}`).join('\n')
-      : '- Nothing parked yet.',
+    '## Relevant Blockers',
+    releaseBlockers.length
+      ? releaseBlockers.map((pulse) => `- ${formatDateTime(pulse.timestamp)} · ${getFeatureLabel(state.features, pulse.feature_id)} · ${pulse.message}`).join('\n')
+      : '- No current blocker pulses for this feature or release.',
+    '',
+    '## Parking Lot / Forbidden Work',
+    forbiddenWarnings.length
+      ? forbiddenWarnings.map((item) => `- ${item}`).join('\n')
+      : '- Nothing parked or forbidden right now.',
     '',
     '## Recent Relevant Pulses',
     relatedPulses.length
@@ -118,11 +197,11 @@ export const createAgentSessionPrompt = (
     '- Preserve working behavior and avoid needless rewrites.',
     '- Prefer the smallest shippable step with clear evidence.',
     '',
+    '## Working Style',
+    ...preset.workingStyle.map((item) => `- ${item}`),
+    '',
     '## Deliver back',
-    '- What changed',
-    '- Files touched',
-    '- How you verified it',
-    '- Any blocker or follow-up you intentionally parked',
+    ...preset.deliverBack.map((item) => `- ${item}`),
   ].join('\n')
 }
 

src/features/project/projectDefaults.ts

@@ -10,7 +10,7 @@ export const createSeedState = (): AppState => ({
     one_line_pitch: 'A calm planning cockpit for AI-assisted product building.',
     description:
       'BuildPulse helps capture features, park distracting ideas, log progress as Pulse events, and export clean context for AI coding agents.',
-    current_goal: 'Ship v0.3 with Phases, Releases, and clear release-readiness signals.',
+    current_goal: 'Sharpen v0.4 handoff workflows so coding agents get the right context fast.',
     notes: 'First dogfood project: BuildPulse manages BuildPulse.',
     created_at: seedDate,
     updated_at: seedDate,
@@ -40,9 +40,9 @@ export const createSeedState = (): AppState => ({
       id: 'phase_structured_release_planning',
       title: 'Phase 3: Structured Release Planning',
       goal: 'Make releases concrete: what is required, what is forbidden, and how close the build is to ready.',
-      status: 'active',
+      status: 'done',
       order: 3,
-      notes: 'This is the v0.3 step.',
+      notes: 'v0.3 shipped with phases, releases, and readiness signals.',
       created_at: seedDate,
       updated_at: seedDate,
     },
@@ -50,9 +50,9 @@ export const createSeedState = (): AppState => ({
       id: 'phase_session_handoff',
       title: 'Phase 4: Session Handoff',
       goal: 'Give agents cleaner, more targeted context packages for implementation sessions.',
-      status: 'upcoming',
+      status: 'active',
       order: 4,
-      notes: 'Planned v0.4 direction.',
+      notes: 'Current v0.4 step: faster, more focused handoff workflows for coding sessions.',
       created_at: seedDate,
       updated_at: seedDate,
     },
@@ -118,13 +118,50 @@ export const createSeedState = (): AppState => ({
         'Local/cloud model router',
         'Session prompt generator',
       ],
+      status: 'shipped',
+      notes: 'Shipped. Release planning structure is live; still no live integrations.',
+      created_at: seedDate,
+      updated_at: seedDate,
+    },
+    {
+      id: 'release_v040_focused_handoffs',
+      phase_id: 'phase_session_handoff',
+      name: 'v0.4 — Focused Session Handoffs',
+      goal: 'Cut the friction between choosing a feature and giving a coding agent a sharp, minimal brief.',
+      definition_of_done: [
+        'Each feature detail exposes one-tap copy actions for OpenClaw, Claude Code, Codex, and a generic brief.',
+        'Prompt generation includes phase, release, readiness, blockers, parking-lot, and forbidden-work guardrails.',
+        'Preview/edit before copy is available with explicit INTENT pulse controls and mobile-safe actions.',
+      ],
+      required_feature_ids: ['export_screen', 'feature_focused_handoff_shortcuts'],
+      optional_feature_ids: ['pulse_log_screen'],
+      forbidden_feature_titles: ['Live OpenClaw/Hermes Agent Status', 'WebSocket agent telemetry', 'GitHub / Gitea sync'],
       status: 'in_progress',
-      notes: 'Keep this on planning structure only. No live integrations yet.',
+      notes: 'v0.4.1 adds preview/edit before copy and cleaner INTENT controls; result capture comes next.',
       created_at: seedDate,
       updated_at: seedDate,
     },
   ],
   features: [
+    {
+      id: 'feature_focused_handoff_shortcuts',
+      title: 'One-tap target-specific handoffs',
+      description: 'Let operators copy a sharp AI handoff for OpenClaw, Claude Code, Codex, or a generic agent directly from feature detail.',
+      column: 'now',
+      priority: 'must',
+      status: 'building',
+      acceptance_criteria: [
+        'Feature detail exposes separate copy actions for OpenClaw, Claude Code, Codex, and Generic.',
+        'Preview/edit is available before copy, with target switching and reset-to-preset behavior.',
+        'INTENT pulse logging is explicit from the preview flow instead of hidden behind a toggle.',
+      ],
+      scope_notes: 'This is the v0.4 loop: quick-copy when you know the target, preview/edit when you want a safer brief, then let the agent work.',
+      phase_id: 'phase_session_handoff',
+      release_id: 'release_v040_focused_handoffs',
+      release_role: 'required',
+      created_at: seedDate,
+      updated_at: seedDate,
+    },
     {
       id: 'feature_plan_screen',
       title: 'Feature Plan screen',