How open-gsd/gsd-core works
GSD Core is a context-engineering and spec-driven development framework for AI coding agents. Its principal workflow moves a project through discussion, planning, execution, verification, and shipping, with fresh-context subagents doing intensive work and structured artifacts carrying state between sessions. The repository also includes runtime installation and configuration, agent/runtime integration, capability management, and profiling. README statements support the phase-loop relationships; source-index references support the cited internal calls. Unsampled modules are represented at subsystem level where their exact runtime wiring is not shown.
Main entry points: install-engine.cts Runtime installer · config-loader.cts Project configuration · verification.cts Verify work · planning-workspace.cts Plan and research
Components 21
Setup and configuration
- Runtime installer
src/install-engine.cts - Artifact conversion
src/runtime-artifact-conversion.cts - Runtime artifact layout
src/runtime-artifact-layout.cts - Path security
src/security.cts - Project configuration
src/config-loader.cts - Runtime naming
src/runtime-name-policy.cts - Command projection
src/shell-command-projection.cts
Phase workflow
- Command routing
src/command-routing-hub.cts - Discuss decisions
- Plan and research
src/planning-workspace.cts - Execute plans
- Verify work
src/verification.cts - Ship phase
Project artifacts
- Phase identity
src/phase-id.cts - Planning snapshots
src/planning-snapshot.cts - Session state
src/state-document.cts - Filesystem I/O
src/io.cts
Agent integration
- Capability lifecycle
gsd-core/bin/lib/capability-registry.cjs - Behavioral profiling
src/profile-pipeline.cts - Host integration
src/host-integration-adapters/cline-sdk-binding.cts
Other components
- AI coding agent
Connections 24
- AI coding agent → Runtime installer: selects runtime
README.md - Runtime installer → Artifact conversion: converts artifacts
src/install-engine.cts - Runtime installer → Runtime artifact layout: uses layout
src/install-engine.cts - Runtime installer → Path security: checks paths
src/install-engine.cts - Runtime installer → Project configuration
- Project configuration → Runtime naming: normalizes runtime
src/config-loader.cts - Project configuration → Command projection: projects commands
src/config-loader.cts - AI coding agent → Command routing: invokes commands
- Command routing → Verify work: routes to
src/command-routing-hub.cts - AI coding agent → Discuss decisions: captures decisions
README.md - Discuss decisions → Plan and research: informs plan
README.md - Plan and research → Execute plans: produces plans
README.md - Execute plans → Verify work: submits work
README.md - Verify work → Ship phase: clears phase
README.md - Ship phase → Discuss decisions: repeats phase
README.md - Plan and research → Planning snapshots: persists snapshot
- Planning snapshots → Phase identity: uses phase IDs
src/health-diagnostic-rules/state-consistency.cts - Session state → Phase identity: uses phase IDs
src/health-diagnostic-rules/state-consistency.cts - Verify work → Session state: updates state
- Project configuration → Filesystem I/O: reads config
src/config-loader.cts - Command projection → Runtime naming: escapes names
src/shell-command-projection.cts - AI coding agent → Capability lifecycle: manages capabilities
- AI coding agent → Behavioral profiling: profiles sessions
- AI coding agent → Host integration: uses host binding