gsd-opencode  by rokicool

AI system for reliable spec-driven code development

Created 3 weeks ago

New!

255 stars

Top 98.8% on SourcePulse

GitHubView on GitHub
Project Summary

This project addresses the common problem of unreliable and inconsistent AI-generated code ("vibecoding") by providing a structured, context-aware meta-prompting and development system. It targets developers who want to leverage AI (specifically Claude Code/OpenCode) for software creation without the overhead of traditional enterprise project management. The primary benefit is enabling consistent, high-quality code generation with a clear, traceable history and robust verification.

How It Works

GSD-opencode employs a sophisticated context engineering and multi-agent orchestration approach. It breaks down development into distinct phases (discuss, plan, execute, verify), ensuring that AI agents receive precisely tailored context at each step. Key mechanisms include detailed context management via dedicated files (PROJECT.md, REQUIREMENTS.md, etc.), XML prompt formatting for atomic tasks, and the orchestration of specialized agents for research, planning, execution, and verification. This multi-agent system operates with fresh context windows for each task, preventing degradation and maintaining high quality, while atomic Git commits provide a traceable and revertible development history.

Quick Start & Requirements

Highlighted Details

  • Model Profile Management: Users can configure AI models for different stages (planning, execution, verification) via /gsd-settings, /gsd-set-profile, and /gsd-set-model commands to balance quality and cost.
  • Phase-Based Workflow: A structured cycle (/gsd-discuss-phase, /gsd-plan-phase, /gsd-execute-phase, /gsd-verify-work) ensures detailed planning, clean execution, and user acceptance testing.
  • Brownfield Development: Includes /gsd-map-codebase for analyzing existing projects before initiating new development.
  • Quick Mode: Offers a streamlined path for ad-hoc tasks like bug fixes or small features using GSD guarantees.

Maintenance & Community

The project is actively maintained, with recent updates aligning with the original TÂCHES v1.9.4. Notable contributors are mentioned, and the project builds upon an established original repository. Specific community links (Discord/Slack) are not provided in the README.

Licensing & Compatibility

The project is released under the MIT License, permitting commercial use and integration with closed-source projects, subject to the standard terms of the MIT license.

Limitations & Caveats

OpenCode requires a restart after changing model profiles or configurations for updates to take effect. The project previously introduced a breaking change in command syntax, updating from /gsd: to /gsd-. The effectiveness of GSD is dependent on the underlying capabilities of the OpenCode environment.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
44
Issues (30d)
19
Star History
257 stars in the last 27 days

Explore Similar Projects

Feedback? Help us improve.