Integration Contract
Stable browser contracts for moving a mission into SD1 Skills and returning verified Skill completion to the originating workspace.
founder-os-skill-handoff · v1.39
Founder OS stores a browser handoff and opens the mission-specific /skills-session/ route with taxonomy identifiers only. The full /skills/ plugin remains the browse library. Private buyer messages, evidence, or company secrets must not be placed in the URL.
skill={skillKey}
sd1_nonce={one-time nonce}
sd1_contract=sd1-skill-completion-return-v1
return_to=https://4br.ca/founders/app/
sd1-skill-completion-return-v1
The originating workspace accepts automatic completion only when all four values match its active browser mission: completed status, mission key, Skill key, and the one-time nonce created when that Skill was opened.
&mission=proposal
&skill=proposal-clarity
&sd1_nonce={matching nonce}
&sd1_contract=sd1-skill-completion-return-v1
&completed_at={ISO timestamp}
Founder OS creates the nonce and sends the selected mission to the SD1 Mission Session. v1.43 added browser-local session health and exact-session resume. v1.44 expands the preset mission router from 3 to 9 mission/Skill-key pairs while keeping the same one-time nonce, completion payload, and validation rules defined by the stable v1.39 contract.
Browser-level producer + consumer verification is live through /skills-session/. The separate /skills/ plugin library does not yet emit this callback itself, and account/server verification remains a future step.
The nonce protects the browser workflow from casual forged return links. Future account-level verification should use server-side authentication/signatures rather than relying on browser state alone.