step1

Guide structured Q&A to document decisions and generate a _step1_decisions.md artifact.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/gsa9/3-step-plan-claude-code --skill step1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: step1
Source: https://github.com/gsa9/3-step-plan-claude-code/tree/main/skills/step1
Command: npx skills add https://github.com/gsa9/3-step-plan-claude-code --skill step1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through a structured decision-making process to define project requirements and scope before execution, ensuring clarity and alignment.

Core Features & Use Cases

  • Structured Q&A: Engages in a one-on-one question-and-answer format to explore and refine decisions.
  • Decision Tracking: Automatically tracks decisions made, including rationale, rejected alternatives, and identified risks.
  • Artifact Generation: Creates a _step1_decisions.md file to bridge the gap between decision-making and planning.
  • Use Case: When starting a new software feature, use /step1 to clarify requirements, choose between different technical approaches, and document potential risks before writing any code.

Quick Start

Initiate the decision-making process by typing /step1.

Frequently Asked Questions about step1

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

FAQPage Schema
How do I gather requirements and scope a software project before writing code?

To gather requirements and scope a software project, use a structured decision-making Q&A process that identifies decision points, challenges assumptions, and documents rationale to ensure clarity before execution.

What is the best way to document technical decisions and track rejected alternatives?

The best way to document technical decisions is through an iterative process that tracks choices, rationale, rejected alternatives, and risks, culminating in a markdown artifact for subsequent planning stages.

Can I use a structured Q&A approach to align on project scope with stakeholders?

Yes, you can use a structured Q&A approach to engage stakeholders, refine decisions through one-on-one interaction, and achieve project scope alignment by explicitly documenting choices and identified risks.

How do I start the decision-making process for a new software feature?

You start the decision-making process for a new software feature by initiating a guided iterative dialogue that explores requirements, chooses between technical approaches, and clarifies potential risks.

What format does the decision tracking output use for subsequent planning stages?

The decision tracking output uses a markdown file format named `_step1_decisions.md`, which bridges the gap between decision-making and execution by capturing all documented choices and risks.

When should I not use a structured decision-making process for project planning?

You should not use a structured decision-making process when immediate execution is required without scope definition, as this approach deliberately pauses development to challenge assumptions and document risks first.