plan-gap-sm
CommunityScript-driven gap-analysis planning with a deterministic state machine
Authorneozenith
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill automates the process of turning a one-sentence initiative brief into a completed, TDD-grounded work breakdown by driving a tiered gap-analysis spec through a deterministic state machine.
Core Features & Use Cases
- Deterministic State Machine: The script manages phase tracking and transitions, ensuring consistency and avoiding errors.
- Automated Gate Evaluation: Evidence-based transition gates determine the next state, reducing reliance on model judgment.
- Composed Prompts: Inlines the current state's instructions and document context into a single prompt for efficient agent processing.
- Durable State: The machine's state persists on disk, allowing for pause/resume and auditability.
- Use Case: Ideal for long-horizon work-breakdown planning where phase tracking must not live in the model's head, ensuring efficient and accurate execution.
Quick Start
To initialize the machine state for a plan folder:
uv run .claude/skills/plan-gap-sm/scripts/pgsm.py init docs/plans/my-initiative --brief "One-sentence initiative description"
Dependency Matrix
Required Modules
uvpythonmypyruffpytestcoveragedeepevalclaude
Components
scriptsreferencesassets
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: plan-gap-sm Download link: https://github.com/neozenith/agentic-dotfiles/archive/main.zip#plan-gap-sm Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 620,000+ vetted skills library on demand.