gsd-executor

Execute PLAN.md workflows with atomic commits, deviation handling, and checkpointing.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/cshyang/nochore --skill gsd-executor-cshyang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-executor
Source: https://github.com/cshyang/nochore/tree/main/capabilities/incubator/skills/gsd/agents/executor
Command: npx skills add https://github.com/cshyang/nochore --skill gsd-executor-cshyang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The GSD Executor orchestrates the end-to-end execution of PLAN.md documents by enforcing atomic task commits, automatic deviation handling, and structured checkpointing to ensure reliable progress and full traceability.

Core Features & Use Cases

  • Atomic per-task commits: Each task results in a discrete Git commit, providing granular history and easy rollback.
  • Deviation handling and recovery: Automatically detects blockers or gaps, applies safe fixes, and resumes progress without manual intervention.
  • Checkpointing and continuation: Pauses at defined checkpoints and resumes after verification or automation, preserving state and memory.
  • SUMMARY and STATE maintenance: Generates SUMMARY.md and updates STATE.md to capture decisions, progress, and outcomes for future sessions.

Quick Start

Provide a PLAN.md describing the workflow and trigger the executor using the designated orchestration command to begin automated plan execution.

Frequently Asked Questions about gsd-executor

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

FAQPage Schema
How do I automate plan execution with atomic commits and checkpoints?

Automating plan execution with atomic commits and checkpoints requires an orchestrator that processes PLAN.md files. The GSD Executor manages this by enforcing discrete Git commits per task, handling deviations automatically, and preserving state for reliable continuation across sessions.

What is atomic task execution in software development workflows?

Atomic task execution in software development workflows means each task results in a discrete Git commit, providing granular history and easy rollback. This approach ensures reliable progress and full traceability when executing complex plans described in PLAN.md documents.

How do I handle deviations automatically during workflow execution?

Handling deviations automatically during workflow execution involves detecting blockers or gaps, applying safe fixes, and resuming progress without manual intervention. The GSD Executor automates this recovery process to maintain continuous progress throughout the plan execution lifecycle.

Can I pause and resume complex plan execution while preserving state?

Yes, you can pause and resume complex plan execution while preserving state through checkpointing. The executor pauses at defined checkpoints and resumes after verification or automation, maintaining state and memory through STATE.md updates for future sessions.

Does automated plan execution work with existing PLAN.md documents?

Automated plan execution works directly with existing PLAN.md documents. You provide a PLAN.md describing the workflow and trigger the executor using the designated orchestration command to begin automated execution with per-task commits and state tracking.

What's the best way to track progress and decisions during automated plan execution?

The best way to track progress and decisions during automated plan execution is through SUMMARY.md and STATE.md maintenance. The executor generates SUMMARY.md to capture decisions and outcomes while updating STATE.md to reflect current progress for future sessions.