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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly understand where a project stands in its development lifecycle by examining existing artifacts and identifying what’s missing before you invest more effort.

Core Features & Use Cases

  • Automated artifact scanning: Checks design documentation, source code structure, architecture docs (ADRs), production plans, prototypes, and tests to estimate completeness.
  • Heuristic + override stage classification: Uses production/stage.txt when present, otherwise infers Concept → Systems Design → Technical Setup → Pre-Production → Production → Polish → Release.
  • Gap-first collaboration: Produces clarifying questions for each detected gap instead of merely listing missing files.
  • Role-filtered recommendations: Optionally tailors next steps for programmer, designer, or producer priorities, then prepares a stage report template with approval before writing.

Quick Start

Ask the assistant to run a full project audit with this skill and then return the stage summary with questions for each gap.

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 repository to detect its current development stage and completeness?

Auditing your repository stage involves scanning design docs, source code, architecture decision records, production plans, prototypes, and tests to estimate completeness and infer the current lifecycle stage using backward heuristics.

What is a project stage detection heuristic and when do I need it?

A project stage detection heuristic infers your project's lifecycle phase, from Concept to Release, by examining existing artifacts. You need it during onboarding, milestone preparation, or existing-project audits to identify missing documentation before investing more effort.

Can I override the detected development stage in my repo analysis?

Yes, you can override the detected development stage by creating an explicit `production/stage.txt` file in your repository. The audit will read this file directly instead of relying on backward heuristics to infer your project's phase.

How do I identify gaps in architecture decision records and documentation completeness?

To identify gaps in architecture decision records and documentation completeness, the skill generates a stage report draft and produces clarifying questions for each detected missing artifact, asking for approval before writing any new files.

Does this project audit tool provide role-filtered next-step recommendations?

Yes, the project audit tool optionally tailors next-step recommendations by filtering priorities for programmers, designers, or producers, ensuring the generated stage report template aligns with your specific team role's requirements.