Plan
- Start and iterate with prototypes, not just documents. Use your coding agent to build something rough, then run
scott pushto bring that context into a planspace. A working prototype resolves more unknowns than a paragraph of speculation. Use the Scott MCP to use Scott context in agent runtimes. - Attach relevant sources. Connect your GitHub repo and reference docs so the agent generates specs grounded in your actual codebase.
- Include code in your plan. Code blobs and prototype references are first-class content. Plans with implementation snippets give reviewers and agents concrete material to react to.
Align
- Share early. The DRI creates the planspace, iterates with the agent, and shares with the team once there’s a code grounded proposal is ready.
- Use comments for specifics. Inline comments are anchored to text in the document. Use them for targeted feedback.
- Fork to explore alternatives. Branch off from an earlier version, try a different direction, and let the team compare working prototypes.
- Request reviews when aligned. Reviews create a formal approval record. Request a review once the planspace has a prototype and at least one round of comment-driven iteration.
Delegate
- Pull the plan into your branch. Run
scott pullto link the planspace to your git branch. This is what enables Scott CI to trace the code back to the intent. - Hand off to any agent. Scott is unopinionated about how you build. Use the approved plan with Cursor, Claude Code, Devin, Copilot, or whatever agent your team prefers via the Scott MCP.
Ship
- Push to GitHub. Open a PR. Scott CI automatically leaves a comment linking the PR to the approved planspace.
How we work at Scott. We use planspaces for every feature that we think others would benefit from knowing about. The DRI creates the planspace, iterates with the agent, and shares it once there’s a prototype + proposal worth reacting to. Reviews happen asynchronously. Some controversial plans go through 2-3 rounds of comments and one formal review before the DRI runs
scott pull and delegates to agents.