project-stage-detect

Detect a game project's development stage by scanning design documents and source code structure.

Updated May 13, 2026
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill project-stage-detect-francisvarga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-stage-detect
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/project-stage-detect
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill project-stage-detect-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly understand where your game project is in development and what critical gaps might be blocking progress.

Core Features & Use Cases

  • Stage detection from real artifacts: Scans design docs, source structure, architecture notes, production plans, and prototypes to infer the current stage.
  • Gap identification with questions: Highlights missing or weak areas and asks clarifying questions instead of assuming.
  • Collaborative reporting workflow: Creates a structured stage analysis using the project-stage-report template, but requests approval before writing new files.

Quick Start

Run the project-stage-detect skill to generate a stage assessment and a prioritized list of gaps and next steps, tailored to your current repo.

Frequently Asked Questions about project-stage-detect

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

FAQPage Schema
How do I audit my game's development stage and identify missing documentation?

To audit your game's development stage, the Skill scans design documents, source code structure, architecture records, and prototypes to infer current progress. It generates a completeness-focused report highlighting gaps and asking clarifying questions about weak areas.

Can I override the detected project stage manually during a codebase audit?

Yes, you can override the detected project stage manually by providing an explicit stage definition in the production/stage.txt file. The heuristic classification process checks this optional file before scanning directory artifacts to determine your game's current development phase.

How do I check if my game is ready for the next milestone planning phase?

Milestone readiness checks evaluate your existing production artifacts, prototypes, and tests against expected development stages. The Skill applies deterministic directory scanning to classify progress and outputs a structured stage analysis with prioritized next steps for your team.

Does this stage detection tool work for onboarding to an existing game codebase?

Yes, onboarding to an existing codebase is a core scenario supported by the stage detection tool. It analyzes the source code structure and architecture records to provide role-filtered recommendations, helping new team members understand the project's current development phase.

What is gap analysis for game development and how does it classify project progress?

Gap analysis for game development evaluates existing repository artifacts against expected milestones to classify project progress heuristically. Rather than assuming missing elements, it identifies weak areas in your production pipeline and asks clarifying questions to refine the completeness assessment.

Will the stage detection process modify my existing project files during an audit?

No, the stage detection process uses a collaborative reporting workflow that requests approval before writing any new files. It generates a structured stage analysis using a specific report template but ensures you maintain control over repository modifications.