# Sprout for Builders

> Sprout is the operating system for the family, driven by your home agent and the Sprout agent. Plug your agent into Sprout over MCP and ship something your kid will see in five minutes. This file lists every docs page with a one-line summary; for the full corpus see llms-full.txt.

## Overview
- [Introduction](https://sproutgoodhabits.com/docs): The landing. What Sprout is, the cast (two agents, two apps, one platform), how to start, the nouns, the roadmap.

## Start
- [What Sprout is](https://sproutgoodhabits.com/docs/start/what-sprout-is): Conceptual landing for the Start tab. The cast, the model, the three follow-on pages.
- [Plug your agent in](https://sproutgoodhabits.com/docs/start/plug-your-agent): Add the Sprout MCP to your client (Claude Code, Codex, OpenClaw, ChatGPT) and complete the OAuth handshake.
- [Your first task](https://sproutgoodhabits.com/docs/start/first-task): A daily check-in your kid sees on the iPad. Two MCP calls; no skill required.
- [Save it as a skill](https://sproutgoodhabits.com/docs/start/save-as-skill): Wrap the procedure into a reusable home_agent skill that updates today's task with real context each morning.

## Build
- [Overview](https://sproutgoodhabits.com/docs/how-to): A catalog of patterns plus walkthroughs that chain them into real family use cases.
- [Interactive canvas](https://sproutgoodhabits.com/docs/how-to/canvas): Kid-facing HTML in a sandboxed iframe with avatar reactions via the Sprout SDK.
- [Conversational task](https://sproutgoodhabits.com/docs/how-to/journal): Coached chat tuned by the engagement levers in conversationSpec.
- [Reports and briefs](https://sproutgoodhabits.com/docs/how-to/reports): Publish structured cards to the family inbox. Reports (detailed analyses) and briefs (scannable digests).
- [Autonomous loop](https://sproutgoodhabits.com/docs/how-to/automate): A skill on a heartbeat fires the cycle daily. Parent intervenes through Sprout in-app agent.
- [Reactive loop](https://sproutgoodhabits.com/docs/how-to/reactive): Home agent reacts to Sprout-pushed events (screentime requests, gem milestones). Rule-based decisions; defer ambiguous ones to the parent via a skill. Push twin of Autonomous loop.
- [Context bridge](https://sproutgoodhabits.com/docs/how-to/context): Home agent reads outside data and carries the summary into Sprout. Mostly home-agent-side. Direct upload + use-in-canvases planned.
- [Program (Soon)](https://sproutgoodhabits.com/docs/how-to/program): Promote a one-topic loop into a structured curriculum with recursive units.
- [Photo and video proof (Soon)](https://sproutgoodhabits.com/docs/how-to/proof): Two planned routes for kid-captured completion proof. Camera task (runMode: camera + cameraTaskSpec) for capture-is-the-task moments; canvas + sprout.uploadAsset() for capture inside a richer activity.
- [Walkthrough: Solar system learning loop](https://sproutgoodhabits.com/docs/how-to/walkthrough/solar-system): From a 3rd-grade worksheet to a self-improving daily learning loop. Chains all six patterns.
- [Walkthrough: Chore + photo proof](https://sproutgoodhabits.com/docs/how-to/walkthrough/chore-photo-proof): Daily room-cleaning chore with photo evidence. Optional home-agent print pipeline.
- [Walkthrough: Weekly family brief](https://sproutgoodhabits.com/docs/how-to/walkthrough/weekly-brief): Sunday-night digest card. Reports and briefs + Autonomous loop in ~30 lines.
- [Walkthrough: Music Lab](https://sproutgoodhabits.com/docs/how-to/walkthrough/music-lab): A four-unit Program (Note Reading, Pitch Ear, Compose & Create, Listen) complementing piano lessons. Chains canvas + conversational + autonomous loop + reports.

## Skills
- [Catalog](https://sproutgoodhabits.com/docs/skills): Reusable .md skills to drop into your home agent's library. One in-prod (Screen reader), rest are templates.
- [Screen reader](https://sproutgoodhabits.com/docs/skills/screen-reader): Read text aloud word-by-word with synced highlighting inside a canvas. In production at Sprout.
- [Quiz template](https://sproutgoodhabits.com/docs/skills/quiz-template): Multiple-choice quiz canvas scaffold with avatar reactions and a single sprout.score completion call.
- [Daily check-in opener](https://sproutgoodhabits.com/docs/skills/daily-checkin): Three-question reflective journal: highlight, lowlight, today's intention.
- [School connector](https://sproutgoodhabits.com/docs/skills/school-connector): Read a school document, summarize topic and vocab cap, resolve which kid it's for.
- [Journal analyzer](https://sproutgoodhabits.com/docs/skills/journal-analyzer): Analyze a conversational task transcript and post themes/gaps/next-topic card.
- [Morning brief](https://sproutgoodhabits.com/docs/skills/morning-brief): Daily 7am card summarizing yesterday's activity per kid and today's plan.
- [Next-session planner](https://sproutgoodhabits.com/docs/skills/next-session-planner): Read yesterday's analyzer card and author tomorrow's canvas + journal.

## Model
- [The cast](https://sproutgoodhabits.com/docs/concepts/three-parties): Your agent, Sprout's agent, the two apps, Sprout Systems, and where the lines are drawn.
- [Home Agent Protocol](https://sproutgoodhabits.com/docs/concepts/home-agent-protocol): The session, two primitives (tools, resources), instructions, dry-run, errors, idempotency, cadence caps, pull-vs-push, scopes and sensitivity tiers.
- [The nouns](https://sproutgoodhabits.com/docs/concepts/objects): Card-grid directory of all nouns.
- [Task](https://sproutgoodhabits.com/docs/concepts/task): The kid-facing unit. Self-check, conversation, canvas. Camera planned.
- [Skill](https://sproutgoodhabits.com/docs/concepts/skill): Saved procedure. generic vs home_agent. Lifecycle is exists-or-archived.
- [Canvas](https://sproutgoodhabits.com/docs/concepts/canvas): Interactive HTML. Sandboxed. SDK reference at sprout://canvas/sdk.
- [Heartbeat](https://sproutgoodhabits.com/docs/concepts/heartbeat): Cron trigger that wakes the Sprout agent. assignmentSkillId optional.
- [Reward](https://sproutgoodhabits.com/docs/concepts/reward): Gems earned per task, spent on parent-defined rewards.
- [Screen-time](https://sproutgoodhabits.com/docs/concepts/screen-time): Request/review gate, high-sensitivity scope.
- [Activity](https://sproutgoodhabits.com/docs/concepts/activity): Family feed. Today: poll. Soon: SSE stream to home agent.
- [Program](https://sproutgoodhabits.com/docs/concepts/program): Multi-step structured plans, recursive units, slot substitution.

## Reference
- [Reference overview](https://sproutgoodhabits.com/docs/reference): Catalog of every MCP tool grouped by noun.
- [Task tools](https://sproutgoodhabits.com/docs/reference/task): task.create, task.update, task.list, task.describe, task.complete, task.review, task.delete.
- [Skill tools](https://sproutgoodhabits.com/docs/reference/skill): skill.write, skill.update, skill.list, skill.get, skill.invoke, skill.post_result.
- [Canvas tools](https://sproutgoodhabits.com/docs/reference/canvas): canvas.create, canvas.update, canvas.list, canvas.get, canvas.delete.
- [Heartbeat tools](https://sproutgoodhabits.com/docs/reference/heartbeat): heartbeat.create, heartbeat.update, heartbeat.describe, heartbeat.list.
- [Reward and gems tools](https://sproutgoodhabits.com/docs/reference/reward): reward.*, gems.adjust, gems.query_balance, gems.list_transactions.
- [Screen-time tools](https://sproutgoodhabits.com/docs/reference/screen-time): screentime.list_requests, screentime.query_state, screentime.review_request.
- [Program tools](https://sproutgoodhabits.com/docs/reference/program): program.create, program.update, program.delete, program.assign, program.list, program.get.
- [Utilities](https://sproutgoodhabits.com/docs/reference/utilities): family.query_overview, project.list, project.get, mcp.whoami, mcp.health.
- [Subscriptions](https://sproutgoodhabits.com/docs/reference/subscriptions): resources/subscribe over SSE. Push notifications when child state changes.
- [How safety works](https://sproutgoodhabits.com/docs/reference/safety): Sprout's perimeter vs your agent's job. Audience evaluation by metadata.

## Help
- [Overview](https://sproutgoodhabits.com/docs/help): Support entry point.

## MCP Resources
- sprout://skill/authoring-guide: Long-form skill authoring guide your agent reads before skill.write.
- sprout://canvas/sdk: Canvas SDK contract your agent reads before canvas.create.
- sprout://heartbeat/authoring-guide: Long-form heartbeat authoring guide your agent reads before heartbeat.create.
- sprout://task/authoring-guide: Long-form task tool-call language your agent reads before task.create.

## Conventions
- MCP server endpoint: https://api.sproutgoodhabits.com/mcp
- Auth: OAuth 2.0; scopes (family:read, task:write, skill:write, canvas:write, heartbeat:write, etc.) approved at consent time.
- Idempotency: write tools accept an Idempotency-Key header.
- Error codes: BAD_INPUT, PERMISSION_DENIED, DOMAIN_NOT_FOUND, INTERNAL_ERROR.
- Cadence cap: heartbeats max 4 fires per 24h, server-enforced.