GSD Executor

Execute GSD plans atomically with per-task commits and state management.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/0futuresystems/future-water-systems --skill gsd-executor-0futuresystems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: GSD Executor
Source: https://github.com/0futuresystems/future-water-systems/tree/main/.agent/skills/executor
Command: npx skills add https://github.com/0futuresystems/future-water-systems --skill gsd-executor-0futuresystems

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the execution of complex plans, ensuring tasks are completed atomically with robust error handling and state management.

Core Features & Use Cases

  • Atomic Task Execution: Executes plans task by task, committing each one individually.
  • Deviation Handling: Automatically fixes bugs, missing critical functionality, and blocking issues.
  • Checkpoint Protocols: Pauses execution at defined checkpoints for human verification or decision-making.
  • State Management: Loads and updates project state to maintain continuity across executions.
  • Use Case: When developing a new feature, this Skill can take a detailed PLAN.md, implement each step, commit the code, and alert you at critical integration points for your approval.

Quick Start

Execute the plan located at .gsd/PLAN.md, starting from the current state.

Frequently Asked Questions about GSD Executor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I execute a development plan atomically with per-task git commits?

Atomic task execution processes a development plan step by step, committing each task individually to git to ensure isolated changes. It manages project state through STATE.md to maintain continuity across executions.

What is the best way to automate plan execution and handle code deviations automatically?

Automated plan execution handles deviations by automatically fixing bugs, missing critical functionality, and blocking issues encountered during task processing. It pauses at defined checkpoints for human verification when intervention is required.

Can I pause workflow automation at checkpoints for human verification?

Yes, workflow automation supports checkpoint protocols that pause execution at defined checkpoints for human verification or decision-making. This allows critical integration points to require manual approval before proceeding.

How does state management work when resuming interrupted plan execution?

State management loads and updates project state through STATE.md to maintain continuity across interrupted executions. Upon completion, it generates SUMMARY.md to document the executed plan tasks and outcomes.

Do I need a specific plan format to start automating task execution?

Task execution requires a detailed plan file located at .gsd/PLAN.md to begin processing. The executor reads this plan structure to implement each step, commit the code, and manage authentication gates.

Why does automated plan execution stop midway through a task?

Automated plan execution pauses midway when encountering checkpoint protocols requiring human intervention, or when managing authentication gates. It also stops to handle deviations by fixing blocking issues before resuming the workflow.