project-stage-detect

Scan design, code, architecture, production, and tests to classify project stage and gaps.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill project-stage-detect-polsegu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-stage-detect
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/project-stage-detect
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill project-stage-detect-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically analyze project state, detect stage, identify gaps, and recommend next steps based on existing artifacts. Use when user asks 'where are we in development', 'what stage are we in', 'full project audit'.

Core Features & Use Cases

  • Artifact scanning across design/docs, code, production artifacts, and tests to determine completeness and readiness.
  • Stage classification using heuristics, with explicit overrides if gate-check files are present.
  • Collaborative gap identification through clarifying questions before proposing actions.

Quick Start

Run the analysis to determine the current project stage and identify the top gaps.

Frequently Asked Questions about project-stage-detect

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

FAQPage Schema
How do I assess what stage of development my project is currently in?

To assess your project stage, scan existing artifacts like design docs, code, architecture, production files, and tests to classify development readiness and identify structural gaps.

What is a project stage detection analysis and when do I need it?

Project stage detection identifies development readiness by scanning artifacts like ADRs and sprint plans. You need it when asking where your project stands or requesting a full project audit.

How to identify gaps in my project's architecture and design docs?

Identify gaps by running an artifact scan across design docs, code, architecture, and tests, which reveals missing components and generates structured recommendations for next steps.

Can I use stage classification heuristics for an existing prototype?

Yes, stage classification heuristics apply to existing projects and prototypes, using gate-check files to override standard classifications and determine readiness for upcoming milestones.

What's the best way to audit project readiness and recommend next milestones?

The best way to audit project readiness is scanning design, code, production, and test artifacts to classify the current stage and output structured gap recommendations for next milestones.

Does project stage detection support role-based filtering for milestone planning?

Yes, project stage detection supports optional role-based filtering during gap identification, allowing teams to focus recommendations on specific responsibilities during sprint planning.