project-stage-detect

Analyze repository artifacts to determine development stage and identify gaps.

Updated Feb 8, 2024
One-click install
npx skills add https://github.com/kay6198835/Game-RPG --skill project-stage-detect-kay6198835
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-stage-detect
Source: https://github.com/kay6198835/Game-RPG/tree/main/.claude/skills/project-stage-detect
Command: npx skills add https://github.com/kay6198835/Game-RPG --skill project-stage-detect-kay6198835

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically analyzes a codebase to determine its development stage and identify gaps to guide planning and execution.

Core Features & Use Cases

  • Scans key areas: Design docs (design/gdd, narrative, levels), Source (src), Production artifacts, Prototypes, Architecture docs (docs/architecture), Tests.
  • Classifies project stage using explicit gate (production/stage.txt if exists) or heuristic based on artifact presence.
  • Generates a collaborative gap list with clarifying questions to avoid assumptions.
  • Produces a standard Project Stage Report by template and can tailor role-based recommendations.

Quick Start

Run /project-stage-detect to perform an initial project-stage analysis.

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 a codebase?

To identify project gaps, scan key areas including design docs, source, production artifacts, and tests. The analysis generates a collaborative gap list with clarifying questions to avoid assumptions and outputs a structured stage report.

How do I perform a gap analysis on my repository artifacts?

To identify project gaps, scan key areas including design docs, source, production artifacts, and tests. The analysis generates a collaborative gap list with clarifying questions to avoid assumptions and outputs a structured stage report.

Can I get role-based recommendations during project onboarding or audits?

Yes, you can get role-based recommendations during onboarding, milestone planning, or audits. The analysis produces a standard Project Stage Report that tailors specific recommendations for different roles based on the detected gaps.

What artifacts are required to classify a project stage successfully?

Classifying a project stage requires scanning artifacts across design docs, source code, production artifacts, prototypes, architecture docs, and tests. If an explicit production/stage.txt file exists, it is used as the gate; otherwise, artifact presence determines the stage.

Does project stage detection work without existing architecture docs?

Yes, project stage detection works without architecture docs by applying heuristics based on available artifacts. It flags missing architecture documentation within the generated gap list and provides recommended actions to address the omission.