One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill project-stage-detect-imclab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-stage-detect
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/project-stage-detect
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill project-stage-detect-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates ambiguity about where a project stands by analyzing your existing artifacts and summarizing completeness, gaps, and likely development stage.

Core Features & Use Cases

  • Automated project audit: Scans design documentation, source code, architecture docs, production planning, prototypes, and tests to estimate completeness across areas.
  • Stage classification with override support: Detects the current stage using heuristics and honors an explicit value from production/stage.txt when present.
  • Collaborative gap identification: Turns missing signals into clarifying questions and role-aware recommendations instead of just listing files.
  • Report generation protocol: Produces a structured report draft from .claude/docs/templates/project-stage-report.md and requests approval before writing output.

Quick Start

Ask the skill to run a full project audit and tell you what stage you are in, what is missing, and what should be prioritized next.

Frequently Asked Questions about project-stage-detect

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

FAQPage Schema
How do I determine the current development stage of my software project?

To determine your software project stage, scan existing artifacts like design docs, source code, architecture records, prototypes, and tests. This artifact-driven audit classifies completeness from Concept through Release, replacing guesswork with a structured status report and clarifying questions.

What is artifact-driven project audit and how does it work?

Artifact-driven project audit analyzes your design documentation, source code, and production planning to estimate completeness across development areas. It uses defined heuristics to classify the project stage and generates role-aware recommendations for missing signals instead of just listing files.

How do I run a project audit to find development gaps and missing requirements?

Run a full project audit to scan design docs, source code, architecture records, and tests. The audit identifies missing signals, turns them into clarifying questions, and produces a structured stage report draft for approval before writing the output.

Can I manually override the detected development stage of my project?

Yes, you can override the detected development stage by providing an explicit value in a production/stage.txt file. The stage classification heuristics will honor this manual override when present, bypassing the automated artifact scanning logic.

Does project stage detection work for XR development and onboarding audits?

Yes, project stage detection applies to XR project onboarding, milestone readiness checks, and general "where are we?" audits. It evaluates prototypes and tests to estimate completeness, making it suitable for teams needing artifact-driven status across XR and software workflows.

What is the best way to prepare for a milestone readiness check?

The best way to prepare for a milestone readiness check is to consolidate your design documentation, source code, architecture records, and prototypes. Scanning these artifacts provides a structured stage report that highlights completeness gaps and prioritizes next steps for the team.