gsd-lean 0.4.1

Lightweight meta-prompting and spec-driven development plugin for Claude Code

GSD-Lean

A lightweight Python plugin/add-on for Get-Shit-Done

What is GSD?

GSD is a meta-prompting, context engineering, and spec-driven development system for Claude Code. It solves context rot by breaking projects into phases with fresh contexts per task, using a discuss → plan → execute → verify loop. Written in JavaScript.

What is GSD-Lean?

A Python reimplementation of GSD's core ideas as a lightweight plugin. Rather than the full system, GSD-Lean focuses on being minimal and easy to extend.

Status: Early development — not yet functional.

How It Works

GSD-Lean guides development through a 5-phase workflow:

stateDiagram-v2
    [*] --> discuss : gsd-lean init

    discuss --> plan : requirements populated
    plan --> discuss : plan rejected
    plan --> execute : plan verified
    execute --> verify
    verify --> execute : tasks remaining
    verify --> complete : all tasks done
    complete --> discuss : new cycle

Phase	What Happens
discuss	Research subagent investigates codebase + web; user preferences probed; REQUIREMENTS.md and DECISIONS.md populated
plan	Requirements decomposed into tasks (T-NNN) in PLAN.md; plan-review subagent verifies completeness
execute	Tasks implemented one by one, status tracked in PLAN.md
verify	Lint, typecheck, tests run against task verification criteria
complete	Summary generated, cycle can restart

Each phase is driven by a skill (/discuss, /plan, /execute, /verify, /complete) that calls CLI commands (gsd-lean transition, gsd-lean plan-status) to manage state.

See PROJECT_KNOWLEDGE.md for detailed architecture — transitions, preconditions, subagents, and CLI reference.