project-stage-detect

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When joining an existing game project or returning to one after a break, it is hard to know what stage development is in, which design documents, code systems, tests, and production artifacts exist, and what is missing before the next milestone. ## Core Features & Use Cases - Artifact Scanning: Counts GDDs, narrative docs, level designs, source files, ADRs, prototypes, and tests across design/, src/, production/, docs/, and tests/ directories. - Stage Classification: Classifies the project as Concept, Systems Design, Technical Setup, Pre-Production, Production, Polish, or Release using heuristics or an explicit production/stage.txt override. - Collaborative Gap Analysis: Asks clarifying questions about missing artifacts instead of assuming, then generates an approval-gated stage report with role-filtered recommendations for programmers, designers, or producers. - Use Case: A developer inherits a Unity project and asks where development stands; the skill scans the repo, reports 60% design completeness with no sprint plan, and recommends running map-systems and sprint-plan next. ## Quick Start Ask the AI to analyze this project, detect its current development stage, identify gaps, and recommend 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 detect what development stage my game project is in?

Run the project-stage-detect skill, which scans design docs, source files, ADRs, prototypes, and tests, then classifies the project into stages from Concept through Release using heuristic indicators or an explicit production/stage.txt override.

How to audit a game project for missing documentation?

The skill counts GDDs, systems docs, narrative docs, ADRs, and test files, then asks clarifying questions about gaps rather than assuming, such as whether undocumented code was prototyped first or tracked in external tools.

Can I get stage analysis filtered for a specific role like programmer or designer?

Yes, pass a role argument such as programmer, designer, or producer. Programmers get architecture and test coverage focus, designers get GDD completeness, and producers get sprint plans and milestone tracking.

Does the stage detection write files automatically?

No. The skill follows a collaborative protocol: it shows a summary of findings and gaps, then asks for explicit approval before writing the stage report to production/project-stage-report.md.

How does the Polish or Release stage get detected?

Polish and Release are explicit-only stages set by the gate-check skill via production/stage.txt. Auto-detection heuristics only cover Concept through Production based on artifact counts.