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.