dev-guided

Generate and update problem_statement.md, decisions.md, runbook.md, and progress.md for iterative development.

1|Updated Oct 24, 2025
One-click install
npx skills add https://github.com/anexpn/claude-plugins --skill dev-guided
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-guided
Source: https://github.com/anexpn/claude-plugins/tree/main/skills/dev-guided
Command: npx skills add https://github.com/anexpn/claude-plugins --skill dev-guided

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Human-in-the-loop iterative development. Use when requirements will emerge during implementation, decisions need human approval at each step, or work spans multiple sessions. Creates problem_statement, decisions, runbook, and progress tracking to guide iterative development.

Core Features & Use Cases

  • Initial Setup Phase (no materials): Guides creating problem_statement.md, decisions.md, runbook.md, and progress.md.
  • Implementation Session Phase (materials exist): Loads context, plan, and executes implementation with guided prompts.
  • Decision Logging: Records decisions with rationale to avoid ambiguity.
  • Runbook Feedback: Provides structured points for human input during implementation.

Quick Start

Invoke the skill to start a new session or continue an existing one. The system will create or load docs/development/NNN-<name>/ and guide you through the problem_statement, decisions, runbook, and progress tracking.

Frequently Asked Questions about dev-guided

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

FAQPage Schema
How do I structure iterative development with human approvals at each step?

Iterative development with human checkpoints uses structured documentation to guide each phase. This Skill creates problem_statement.md, decisions.md, runbook.md, and progress.md files that organize requirements, capture approved decisions, define implementation steps, and track completion across sessions—enabling clear handoff points where humans review and approve before proceeding.

What's the best way to handle software projects where requirements emerge during implementation?

Emerging requirements benefit from guided development that documents assumptions upfront, then refines them incrementally. This Skill structures the problem space with an initial problem statement and decisions log, then executes planned sessions (plan-N.md) that surface new requirements, record them with rationale, and update your runbook—keeping work coherent across iterations.

Can I use guided development for projects that span multiple sessions?

Yes. Multi-session projects need persistent context and clear checkpoints. This Skill maintains problem_statement.md, decisions.md, runbook.md, and progress.md as living documents that preserve your work, decisions, and next steps between sessions—so you resume with full context and avoid duplicating effort or losing decisions.

How do I avoid ambiguity in development decisions?

Decision logging with rationale prevents ambiguity and rework. This Skill records each decision in decisions.md with the reasoning behind it, making it explicit why a choice was made and under what constraints—so future sessions and team members understand the context without repeating debates.

What's the workflow for getting human feedback during implementation?

Structured runbooks embed human feedback loops. This Skill generates runbook.md with defined checkpoints where implementation pauses for human input, then orchestrates plan-N.md sessions that prompt you at each step, capture feedback, and log progress—turning ad-hoc reviews into a predictable workflow.

Do I need to create documentation templates manually before starting?

No. This Skill automates template creation. Invoke it with no materials to generate problem_statement.md, decisions.md, runbook.md, and progress.md in docs/development/NNN-<name>/—you fill in content through guided prompts, not by designing the structure yourself.