Feature: Project state analysis capability

[guercheLE]

Feature Request: Project State Analysis Capability

Overview

Add comprehensive project state analysis capabilities that can evaluate project type (greenfield vs brownfield), constitutional compliance, and provide detailed insights for both specification-driven and existing codebase projects.

Current State

• No automated project analysis capabilities
• Manual assessment of project state and compliance
• No tools for evaluating existing codebases

Proposed Features

1. Project State Analysis Scripts

• Unix/Linux Support: scripts/bash/analyze-project-state.sh for Unix/Linux environments
• Windows Support: scripts/powershell/analyze-project-state.ps1 for Windows environments
• Cross-Platform: Consistent behavior across different operating systems
• Comprehensive Analysis: Detailed analysis of project state and structure

2. Project Type Detection

• Greenfield Projects: Identify new projects starting from scratch
• Brownfield Projects: Analyze existing codebases and legacy systems
• Hybrid Projects: Detect projects with mixed new and existing components
• Migration Projects: Identify projects transitioning between methodologies

3. Constitutional Compliance Analysis

• Spec-Driven Compliance: Check adherence to spec-driven development principles
• Documentation Quality: Evaluate documentation completeness and quality
• Process Adherence: Assess compliance with development processes
• Quality Standards: Check adherence to quality and coding standards

4. Analysis Capabilities

• Codebase Analysis: Analyze existing code structure and patterns
• Documentation Analysis: Evaluate documentation completeness and quality
• Process Analysis: Assess development processes and methodologies
• Dependency Analysis: Identify dependencies and relationships

Benefits

• Automated Assessment: Automated project state evaluation
• Better Planning: Informed planning based on project analysis
• Quality Assurance: Ensure compliance with development standards
• Risk Mitigation: Identify potential issues and risks early

Implementation Details

• Create analysis scripts for both platforms
• Implement project type detection algorithms
• Add constitutional compliance checking
• Include comprehensive reporting capabilities

Analysis Types

1. Project Type Analysis: Determine if project is greenfield, brownfield, or hybrid
2. Constitutional Compliance: Check adherence to spec-driven development principles
3. Code Quality Analysis: Evaluate code quality and standards
4. Documentation Analysis: Assess documentation completeness and quality
5. Process Analysis: Evaluate development processes and methodologies

Reporting Features

• Detailed Reports: Comprehensive analysis reports
• Recommendations: Actionable recommendations for improvement
• Compliance Scores: Quantitative compliance assessments
• Risk Assessment: Identification of potential risks and issues

Use Cases

• Project Onboarding: Quick assessment of new projects
• Compliance Audits: Regular compliance checking
• Quality Assurance: Ongoing quality monitoring
• Process Improvement: Identify areas for process improvement

Integration Points

• Workflow Orchestration: Integration with workflow orchestration tools
• AI Assistant Support: Works with all supported AI assistants
• Project Management: Integration with project management tools
• Quality Gates: Integration with quality gates and validation

This feature provides essential capabilities for understanding project state and ensuring compliance with development standards and best practices.

[guercheLE]

Pull Request Created

This issue is addressed by a comprehensive pull request:

PR #5: Feature: Workflow Orchestration - Feature Development, MVP-to-Full, and Project Analysis

This PR addresses multiple related workflow orchestration issues including:

• Issue Feature: MVP to full product transition orchestration #427: MVP to full product transition orchestration
• Issue Feature: Feature workflow orchestration #428: Feature workflow orchestration
• Issue Feature: Project state analysis capability #429: Project state analysis capability

The PR includes the project state analysis capabilities described in this issue.

[guercheLE]

Implementation Details

Feature Idea: I came up with the idea for comprehensive project state analysis capabilities to evaluate project type and constitutional compliance.

Implementation: The feature was implemented using VS Code + GitHub Copilot + Claude Sonnet 4 model to create the project state analysis scripts and capabilities.

[guercheLE]

Correction: Pull Request Reference

Previous comment referenced a non-existent PR.

The referenced PR #5 does not exist in the github/spec-kit repository. This issue (Project state analysis capability) does not currently have a corresponding pull request.

The feature described in this issue is still pending implementation.

[localden]

This seems AI-generated with no direct outline of the problem or verification of how this was tested and validated. Please re-open the issue if you've verified that this behavior exists in Specify - mention your OS, how you're running Specify (arguments, slash-commands in IDE/CLI) and what is the output tree.

[guercheLE]

In short, the proposal is: 1) Someone run the prompt with "create a chat application with all the features an app like that usually have" as the context (greenfield, new app). The prompt fulfills the constitution.md with as much functional and non functional requirements the LLM knows about -> use judgment to fix clarification items -> save result to constitution.md

2. Someone run the prompt with "Understand what this app is all about (functional and non functional requirements)" as the context (browfield, existing app). The prompt traverses the existing app folder collecting requirements -> use judgement to fix clarification items -> save result to constitution.md.

[localden]

@guercheLE this should be covered by #52.

[guercheLE]

Glad to hear about it. Looking forward to testing it on the official repo.