3. Prototype Contract

v0.2가 “무엇을 검증할 것인가”를 정했다면, v0.3은 “무엇을 만들고, 무엇은 만들지 않으며, 어떤 증거로 끝났다고 말할 것인가”를 고정한다.

이 문서는 앱 구현 명세가 아니라 prototype 계약이다. 계약이 없으면 Life OS 상상력이 다시 커진다. 첫 slice는 작아야 한다.

Task 10개
Energy state 1개
Quest 후보 3개 이하
10분 Session 1개
done/fork/retry/recover outcome 1개
Route Log 1개

Decision

분류	판단
`software`	`Energy Cockpit + Quest Compiler + Route Log`는 반복 행동을 시스템이 맡아야 하므로 software 후보
`document`	medical/safety boundary, URL policy, evidence bundle은 문서로 먼저 고정
`workflow`	7일 probe 운영 순서는 수동으로도 먼저 실행 가능
`agent-run`	reference app/theory update는 일회성 리서치 pass로 충분
`no-go`	전체 Life OS, habit platform, social/body-doubling network는 이번 slice 밖

Appetite

첫 prototype appetite는 2일 이하다. 2일 안에 만들 수 없으면 범위가 너무 넓은 것이다.

포함	제외
local seed task 입력	calendar/browser/file 자동 sensing
상태 선택	wearable/desktop activity inference
rule-based quest scoring	LLM 자동 coach
10분 session timer	full calendar scheduler
route outcome log	long-term analytics dashboard
pattern read-back 1개	cross-device sync

Development Contract

Intent:
사용자가 지금 상태를 고른 뒤 착수 가능한 10분 route를 보고, session 결과를 Route Log로 남기게 한다.

Scope:
Task seed 10개, EnergyState 선택, Quest 후보 3개 이하, Session start/end, done/fork/retry/recover outcome, Route Log read-back.

Lane/read-back:
public-work legacy / logan research surface.
Prototype app repo는 아직 미정. 이 문서는 /Users/chaselee8811/public-work/logan-life-cockpit-research 안의 product contract다.

BDD scenario:
Given 사용자가 task 10개를 가지고 있고 현재 energy state를 선택했다.
When 사용자가 Energy Cockpit을 연다.
Then 앱은 착수 가능성이 높은 quest 3개 이하를 보여준다.
And 사용자가 quest 하나를 시작하면 10분 Session이 열린다.
And 종료 시 done/fork/retry/recover 중 하나가 Route Log에 남는다.

Test layer:
첫 앱 구현 전에는 handbook build + contract read-back.
앱 구현 시에는 model/unit test, route/request test, browser/system read-back 중 실제 stack에 맞춰 선택.

Done condition:
Prototype 화면에서 task -> quest -> session -> outcome -> route log 흐름을 한 번 끝까지 볼 수 있다.

Risk gate:
medical advice 금지, diagnosis/treatment/medication guidance 금지, sensitive task/state data local-first 기본.
외부 sync, account auth, cloud storage, notification spam, production deploy는 별도 계약 전까지 금지.

Evidence required:
build result, local preview read-back, BDD scenario read-back, route log sample, safety/no-medical-claim check.

Acceptance Scenario

Feature: Energy route probe

  Scenario: Start a 10-minute route from current energy state
    Given I have 10 seeded tasks
    And I select "저전압" as my current energy state
    When I open the Energy Cockpit
    Then I should see no more than 3 quest candidates
    When I start one quest
    Then a 10-minute session should be created
    When I finish the session as "done"
    Then the Route Log should record the task, quest, energy state, and outcome

Prototype Data Contract

Object	Required for prototype	Not yet
`Task`	title, domain, friction_score, interest_score, energy_cost, reward_type, status	project graph, recurring rules
`EnergyState`	label, intensity, selected_at	inferred sensing
`Quest`	task_id, quest_title, entry_action, fallback_action, timebox_minutes	LLM rewrite history
`Session`	quest_id, started_at, ended_at, outcome	pomodoro analytics
`RouteLog`	task, quest, state, outcome, note	full pattern dashboard

No-Go

이번 prototype에서 하지 않는다.

ADHD 진단/치료/약물 조언
user account, subscription, cloud sync
calendar/browser/file 자동 수집
LLM coach persona
streak, penalty, productivity score
social feed, ranking, group challenge
notification-heavy habit loop

다음 문서로 넘길 것

이 계약이 통과되면 다음은 Object Lifecycle, Implementation Stack, URL 정책이다. 앱을 만들기 전에 객체의 상태 전이, 구현 stack의 채택 범위, URL의 공개/비공개 경계를 먼저 잠근다.