project-stage-detect

Analyzes project artifacts to detect development stage, identify gaps, and recommend next steps.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill project-stage-detect-claretagrapelike32
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-stage-detect
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/project-stage-detect
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill project-stage-detect-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When joining an existing game project or losing track of progress, it is hard to know what stage development is in, which artifacts are missing, and what to do next. This Skill scans your project structure and produces a stage assessment with prioritized recommendations. ## Core Features & Use Cases - Artifact Scanning: Counts and inspects design docs, source files, ADRs, prototypes, sprint plans, and tests across standard directories. - Stage Classification: Classifies the project as Concept, Systems Design, Technical Setup, Pre-Production, Production, Polish, or Release using explicit overrides or heuristics. - Collaborative Gap Analysis: Asks clarifying questions about missing artifacts instead of assuming, and requests approval before writing the stage report. - Use Case: You inherit a game codebase with scattered docs and code. Run the analysis to learn the project is in Pre-Production, that combat code lacks a design doc, and that the next step is creating a systems index. ## Quick Start Ask the assistant to analyze where this project currently stands in development and generate a stage report with recommended next steps.

Frequently Asked Questions about project-stage-detect

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

FAQPage Schema
How do I find out what stage my game project is in?

Run the project stage detection analysis, which scans design docs, source code, architecture records, prototypes, and production plans. It classifies the project into stages from Concept through Release and reports completeness percentages per domain.

How to audit a game project for missing documentation?

The analysis compares code and design artifacts, flagging gaps such as combat code without a matching GDD or ADRs without an architecture overview. It asks clarifying questions about each gap rather than assuming the documentation is simply missing.

Can I filter the project audit by role like programmer or designer?

Yes, passing a role argument focuses the recommendations. Programmers get architecture and test coverage gaps, designers get GDD completeness issues, and producers get sprint plan and milestone tracking gaps.

Does the stage detection write files automatically?

No, it follows a collaborative protocol that shows findings and asks for approval before writing the report to production/project-stage-report.md. It never silently creates artifacts.

How does the skill handle an explicitly set project stage?

It checks production/stage.txt first and uses that value as an explicit override, which is how gate-check transitions like Production to Polish are recorded. Auto-detection heuristics only apply when no override exists.