issue-review-two-phases-1

Review GitHub issues through design interview, ToDo list, and refactor planning.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/stevenengland/sten-agent-skills --skill issue-review-two-phases-1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: issue-review-two-phases-1
Source: https://github.com/stevenengland/sten-agent-skills/tree/main/skills/issue-review-two-phases-1
Command: npx skills add https://github.com/stevenengland/sten-agent-skills --skill issue-review-two-phases-1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow provides a structured, multi-phase approach to working on a GitHub issue. It helps teams design, plan, and validate changes before any code is written, reducing rework and misaligned expectations.

Core Features & Use Cases

  • Design Interview Guidance: prompts to drill into architecture, dependencies, and trade-offs during the initial discussion.
  • Structured ToDo Derivation: generates a concrete, approved task list derived from the agreed design.
  • Implementation & Refactor Guidance: outlines a step-by-step coding and refactor process, aligned with clean-code and testing principles.

Quick Start

Walk me through an end-to-end issue review for a given GitHub issue, from design interview through refactor pass, without creating commits.

Frequently Asked Questions about issue-review-two-phases-1

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

FAQPage Schema
What is an end-to-end issue review and when do I need it before coding?▼

An end-to-end issue review validates architecture decisions, planning, and pre-implementation tasks for GitHub issues. You need it before coding to standardize design discussions and reduce rework by aligning expectations upfront.

How do I design and plan GitHub issue implementations without committing code?▼

You plan GitHub issue implementations by running a structured design interview, deriving a ToDo list, and outlining a refactor guide. This validates architecture decisions and generates a step-by-step coding process without creating commits.

Can I generate a TDD and clean-code refactor guide during issue planning?▼

Yes, you can generate a refactor guide aligned with clean-code and TDD principles during issue planning. It outlines a step-by-step coding process to validate implementation decisions before any actual code is written or committed.

Does this issue review workflow work for any GitHub project regardless of architecture?▼

Yes, the issue review workflow applies to GitHub issues across diverse projects. It standardizes architecture decisions and pre-implementation validation, helping teams design and validate changes regardless of the specific project architecture.

What's the best way to structure a design interview for software architecture decisions?▼

The best way to structure a design interview for architecture decisions is using targeted prompts that drill into dependencies and trade-offs. This standardized approach produces an approved task list and a non-committing implementation guide.

Why should I validate pre-implementation planning before writing code on GitHub issues?▼

Validating pre-implementation planning before writing code reduces rework and misaligned expectations. It ensures architecture decisions and ToDo lists are agreed upon upfront, streamlining the actual coding and refactor process.