What Sync tracks
The kinds of knowledge Sync keeps for your project — specs, decisions, constraints, and a roadmap — all in your repo.
Sync keeps a small set of typed documents that your agent reads before it writes and updates as it works. You browse and edit them in the app; they're stored as plain files in your repo, so they're versioned and reviewable in pull requests.
The kinds of knowledge
| Kind | What it captures |
|---|---|
| Spec | What a feature or system is supposed to do — the agent's main reference. |
| Decision | A choice that was made, and why — so it isn't silently undone later. |
| Constraint | A rule the code must respect. |
| Observation | Something true about the system right now — a gotcha, a behavior, a number. |
| Question | Something the agent is unsure about. You answer it, and the answer becomes part of the spec. |
| Doc | Longer-form notes and documentation. |
Each one carries a status that tells you and the agent whether it's still current.
The roadmap
Sync rolls your specs up into a roadmap so there's always a clear answer to "what's next?":
- Goals describe the outcomes you're after.
- Milestones group work toward a goal.
- Specs are the individual units of work.
Work is ordered by how soon it matters (now, next, later), by priority, and by which specs your recent commits are actually touching. This is the plan you point the agent at — so it works on what you've prioritized, and you keep control of the direction on big, complex tasks.
Where it lives
Everything is stored in a .sync/ folder inside your repository — plain text,
committed alongside your code. There's nothing to manage by hand; the app and
your agent keep it up to date, and you review the changes like any other diff.
How staleness works
Every document in Sync carries a status. When code changes, Sync marks the documents that describe it stale — so your agent knows what it can still trust.
Advanced — CLI & automation
The Sync app is the recommended way to use it. For terminal workflows and CI, the same binary is also a CLI.