.planning/ directory. The project, roadmap, requirements, current state, phase context, research, plans, summaries, verification, UAT, and handoff files carry work across sessions.
Source stamp: open-gsd/gsd-core at 50efae13, reviewed July 18, 2026. Repository license: MIT.
Artifact tree
Workflow and task grain
The recurring lifecycle is discuss, plan, execute, verify, and ship. A roadmap divides a milestone into phases. Phase context and research inform one or more plans. Execution summaries and verification records describe what happened.STATE.md and continuation files show the next session where work stopped and what remains.
GSD’s unit is broader than one implementation plan. It keeps project and milestone memory alongside the plan, making file maintenance part of the method.
Review and handoff conventions
Discussion captures human decisions before planning. Verification and UAT have their own artifacts. A phase can leave an explicit continuation record rather than relying on chat history. These files preserve continuity, but stale files can mislead later sessions if the team does not maintain them.Inspect the same-case output
Inspect the generated GSD.planning/ tree for reliable webhook delivery. It includes the project, requirements, roadmap, state, configuration, and phase context. The phase-plan run stalled and was interrupted, so no completed phase plan is included.
Choose GSD Core when
- work spans many sessions or phases;
- the repository should carry explicit project state;
- research, execution summaries, verification, and UAT need separate records; and
- the team will maintain the planning tree as work changes.