v0.3 Prototype Contract

Date: 2026-06-21

Surface: Cloudflare Pages project candidate logan-life-cockpit-research

변경 요약

v0.3은 v0.2의 Product Gate를 실제 prototype 직전 계약층으로 내린다. 이번 릴리즈는 앱 구현이 아니라 구현 전에 필요한 네 가지 계약을 추가한다.

prototype contract
object lifecycle
URL policy
evidence bundle

추가된 문서

Route	역할
`book/03-prototype-contract`	7-Day Energy Route Probe의 개발 계약
`book/04-object-lifecycle`	Task, EnergyState, Quest, Session, RouteLog lifecycle
`reference/url-policy`	research handbook, future app, future public product URL 경계
`delivery/evidence-bundle`	handbook/prototype 완료 증거 묶음

적용한 기준

Source	Life Cockpit 적용
Capitome dev handbook	자연어 요청을 make/no-go, development contract, evidence로 내림
Book URL Policy	URL을 장기 계약으로 보고 research/app/public surface를 분리

Prototype Contract

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

보호선

medical advice, diagnosis, treatment, medication guidance 금지
guilt score, penalty streak, hidden sensing 금지
user account, cloud sync, notification-heavy loop는 이번 prototype 밖
future app URL은 private/noindex 정책을 기본으로 둠
public acquisition URL은 별도 launch decision 전까지 만들지 않음

Verification

Before release/deploy, run:

npm run build
git diff --check
curl -fsS http://127.0.0.1:35003/book/03-prototype-contract/ | rg 'Prototype Contract'
curl -fsS http://127.0.0.1:35003/reference/url-policy/ | rg 'Life Cockpit URL Policy'