Chopin: compose durable plans with a repository-grounded agent

gist

Chopin is GitHub Next's experimental prototype for people and a repository-grounded agent to co-author durable documents such as plans, RFCs, and decision records. A channel binds Chat, a multiplayer Plan, and a Decisions log that keeps accepted answers out of the prose. The hosted Planner reads the selected GitHub repository through bounded read-only tools and edits the document; it cannot write to GitHub or implement code. A separate coding agent can connect over MCP. There is no public instance; run it locally or self-host.

ideas

• People own decisions; the agent proposes. The Planner co-authors from repository evidence and asks the team when the code cannot settle a choice.
• Decisions live outside the prose. Attributed questionnaire answers and accepted comments stay in a separate log so a later rewrite cannot silently change what the team decided.
• The Planner is read-only on GitHub. It inspects the selected repository and pull requests, then edits the Chopin document; it cannot write to GitHub, edit a checkout, or implement code.
• Coding agents attach over MCP. A separate agent can create documents or consume an approved implementation graph; Chopin's implementation handoff remains experimental.
• No public instance, and one writer. Self-host or run locally with Bun, Docker, and a GitHub App; one Chopin process may write to a database at a time.

quotes