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.