write-dev-guide

Generate a phased development guide from design docs and architecture references.

1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/n0rvyn/indie-toolkit --skill write-dev-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-dev-guide
Source: https://github.com/n0rvyn/indie-toolkit/tree/main/dev-workflow/skills/write-dev-guide
Command: npx skills add https://github.com/n0rvyn/indie-toolkit --skill write-dev-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams convert project context, design inputs, and architecture considerations into a structured, phased development guide that drives subsequent /write-plan and /run-phase cycles.

Core Features & Use Cases

  • Generates a comprehensive Dev Guide saved under docs/06-plans with clearly defined Phases.
  • Checks for existing dev-guides and marks the current version as inactive for versioning consistency.
  • Integrates with the /write-plan, /run-phase, and verification workflow to ensure alignment across planning and execution.
  • Supports a Decisions section to surface blocking and recommended choices.

Quick Start

Prompt with 'Write a development guide for this project' to begin the phased workflow.

Frequently Asked Questions about write-dev-guide

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

FAQPage Schema
How do I turn project ideas into a phased development plan?

To turn project ideas into a phased development plan, synthesize project context and architecture inputs into a structured guide with defined phases, dependencies, and decision points ready for team review.

What is a development guide and how does it support phased workflows?

A development guide is a structured document outlining phased execution plans anchored to project design docs. It supports phased workflows by defining dependencies, surfacing blocking decisions, and aligning planning with execution cycles.

How do I create a development plan from existing architecture references?

Create a development plan from architecture references by integrating design inputs and architectural constraints into a phased guide. The output outlines dependencies and decision points, ensuring alignment with the project's architectural foundation.

Can I version my development guides when project requirements change?

You can version development guides by checking for existing guides and marking the current version as inactive. This ensures versioning consistency across documents when updating phased plans in the project's plans directory.

How do I surface blocking decisions in a project development plan?

Surface blocking decisions in a project development plan by including a Decisions section within the generated guide. This highlights recommended choices and blockers requiring resolution before subsequent execution phases proceed.

Does the generated development guide integrate with write-plan and run-phase workflows?

The generated development guide integrates directly with write-plan and run-phase workflows. It provides the phased structure and dependency mapping required to drive subsequent planning and execution cycles within the development workflow.