project-stage-detect

Scan repository artifacts to classify development stage and identify gaps.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/scomofo/dragon-forge --skill project-stage-detect-scomofo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-stage-detect
Source: https://github.com/scomofo/dragon-forge/tree/main/.agents/skills/project-stage-detect
Command: npx skills add https://github.com/scomofo/dragon-forge --skill project-stage-detect-scomofo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams answer “where are we in development?” by analyzing the repository’s existing design, code, production artifacts, architecture docs, and tests to infer the project’s current stage and highlight meaningful gaps.

Core Features & Use Cases

  • Artifact Scanning Across Domains: Reviews design/, src/, production/, prototypes/, docs/architecture/, and tests/ to measure completeness.
  • Stage Classification with Overrides: Uses production/stage.txt when present, otherwise applies artifact-based heuristics from Concept through Release.
  • Gap Identification with Clarifying Questions: Produces questions that guide next steps rather than only listing missing files.
  • Actionable Reporting Workflow: Builds a stage report template and (by protocol) requests approval before writing a full analysis file.

Quick Start

Use the project-stage-detect skill to scan the repository and produce a stage analysis with identified gaps and clarifying 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 detect the current development stage of my repository?

You can detect the current development stage by scanning repository artifacts across directories like design, src, production, prototypes, docs/architecture, and tests to measure completeness. The tool applies artifact-based heuristics to classify the stage from Concept through Release, identifying gaps and prioritizing next steps.

What is project stage classification and how does it work?

Project stage classification infers your development phase by auditing repository artifacts like architecture docs and tests. It uses heuristic analysis to map completeness against expected milestones, applying an override if a production/stage.txt file is present.

How do I perform a gap identification audit for milestone readiness?

Perform a gap identification audit by scanning repository artifacts to measure completeness against expected development milestones. The process produces an approval-gated stage report template with clarifying questions that guide your next steps rather than only listing missing files.

Can I manually override the detected project stage?

Yes, you can manually override the detected project stage by creating a production/stage.txt file in your repository. When present, the tool bypasses artifact-based heuristics and uses your explicit stage declaration for the analysis.

What's the best way to audit documentation completeness for project onboarding?

The best way to audit documentation completeness is to scan design, architecture, and production directories to infer the project stage. This artifact audit produces a report highlighting missing elements and generating clarifying questions to accelerate onboarding.