project-stage-detect

Analyze project artifacts to determine development stage and identify gaps.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/solace-ill/vector-flow --skill project-stage-detect-solace-ill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-stage-detect
Source: https://github.com/solace-ill/vector-flow/tree/main/.claude/skills/project-stage-detect
Command: npx skills add https://github.com/solace-ill/vector-flow --skill project-stage-detect-solace-ill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically analyze project state, detect stage, identify gaps, and recommend next steps based on existing artifacts. Use when user asks 'where are we in development', 'what stage are we in', 'full project audit'.

Core Features & Use Cases

  • Scan key directories across design, code, production, prototypes, and architecture docs to determine current completeness and gaps.
  • Classify the project stage using artifact presence and optional gate hints, and surface actionable recommendations.
  • Generate a collaborative gap-identification workflow by prompting clarifying questions before proposing changes.

Quick Start

Run a project-wide analysis on the current repository to determine stage and surface actionable gaps.

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 my project?

To detect the current development stage, scan key directories across design, code, production, and architecture docs. This validates artifact presence and state, classifies the project stage, and surfaces actionable gap recommendations.

What is a project gap analysis and when do I need one?

A project gap analysis identifies missing artifacts across design, source tree, production plans, and ADRs. You need one when onboarding to existing projects, conducting milestone audits, or asking where the project stands in development.

How do I run a full project audit on my existing codebase?

Run a project-wide analysis on your repository to audit artifact completeness. This generates a stage report validating design docs, source tree, and architecture records, prompting clarifying questions when gaps exist.

Can I use artifact analysis to find missing design docs and ADRs?

Yes, artifact analysis validates the presence and state of design docs and ADRs. By scanning project directories, it automatically surfaces missing architectural records and design documents to enable quick decision making.

What is the best way to identify project gaps before a milestone audit?

The best way to identify gaps before a milestone audit is analyzing project artifacts across design, code, and architecture. This classifies the current stage, surfaces a comprehensive gap report, and recommends next steps.

Why does project stage detection prompt clarifying questions?

Project stage detection prompts clarifying questions to generate a collaborative gap-identification workflow. Before proposing changes, it asks questions to ensure accurate next-step recommendations when missing artifacts are found.