project-stage-detect

Classify a software project's development stage from design, code, and test artifacts.

1|Updated May 15, 2026
One-click install
npx skills add https://github.com/dnkrow/skill --skill project-stage-detect-dnkrow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-stage-detect
Source: https://github.com/dnkrow/skill/tree/main/claude-global/project-stage-detect
Command: npx skills add https://github.com/dnkrow/skill --skill project-stage-detect-dnkrow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly understand where a project is in development by assessing what artifacts exist and what gaps could block progress.

Core Features & Use Cases

  • Stage classification from artifacts: Detects a likely stage using design docs, source code structure, production planning artifacts, prototypes, architecture docs, and test signals.
  • Gap identification with questions: Surfaces likely documentation and process gaps without assuming intent, then asks targeted clarifying questions.
  • Actionable stage report workflow: Produces a structured stage analysis plan and requests approval before writing any report artifact.

Quick Start

Run /project-stage-detect to generate a project stage assessment and a prioritized set of gap questions.

Frequently Asked Questions about project-stage-detect

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

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

A project stage detection scan analyzes your design documents, source code structure, architecture docs, prototypes, and test signals to classify the current development phase. It identifies documentation gaps and asks targeted questions before generating an actionable stage report.

What is the best way to audit an existing codebase for milestone planning readiness?

An artifact-based development audit assesses codebase milestone readiness by scanning production planning artifacts, architecture decisions, and test signals. It surfaces process gaps through targeted clarifying questions, ensuring you understand roadmap readiness before proceeding.

Can I use a manual override file to specify my project stage instead of automatic detection?

Yes, you can use an optional production/stage.txt file to override the automatic artifact-based stage classification. When this file is present, the skill uses your manual specification instead of scanning design documents and source code structure to infer the development stage.

How does gap analysis work when onboarding to an existing codebase with missing documentation?

Gap analysis for codebase onboarding scans existing design and architecture docs to identify missing artifacts, then asks targeted clarifying questions instead of assuming intent. It surfaces documentation and process gaps through a collaborative approval gate before writing an output report.

Does the project stage detection process write reports automatically without user approval?

No, the project stage detection process follows a collaborative approval gate and does not write report artifacts automatically. It generates a structured stage analysis plan, asks clarifying questions to resolve gaps, and explicitly requests your approval before creating any output files.