Why is the PROJECT.md file the focus of this skill?

PROJECT.md serves as the 'source of truth' for high-level strategy, allowing both human developers and AI agents to have a shared understanding of project boundaries, architecture, and goals.

What is semantic validation in this context?

Semantic validation focuses on the underlying intent and strategic purpose of requirements rather than just looking for specific keywords or literal text matches in the code.

How does this skill help prevent scope creep?

It continuously cross-references new features and code changes against the SCOPE section of your PROJECT.md, flagging items that are explicitly out-of-scope or deviate from defined objectives.

Can it help update my documentation automatically?

While it primarily identifies misalignments, it provides specific resolution strategies and templates to help you or the AI agent update PROJECT.md when implementation reflects a necessary change in strategy.

Project Alignment Validator

Name: Project Alignment Validator
Author: akaszubski

byakaszubski

•

コラボレーションツール

Validates software features and implementations against high-level project goals, scope, and architectural constraints defined in PROJECT.md.

The Project Alignment Validator is a specialized skill for Claude Code designed to ensure development work stays synchronized with strategic project documentation. By utilizing semantic validation instead of simple keyword matching, it analyzes the intent behind your code to ensure it serves core goals, respects technical constraints, and follows architectural patterns. This tool is essential for maintaining project integrity, preventing scope creep, and identifying critical gaps between current implementation and the desired strategic state.

主な機能

01Impact-based prioritization for implementation and documentation gaps

0210 GitHub stars

03Standardized alignment checklists for GOALS, SCOPE, and CONSTRAINTS

04Structured conflict resolution patterns for documentation-code discrepancies

05Automated gap assessment for features, documentation, and architecture

06Semantic validation of project intent and strategic goals

ユースケース

01Verifying that new feature implementation aligns with the defined project scope

02Resolving conflicts between outdated project documentation and current code state

03Performing health checks to identify technical debt or architectural drift

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add akaszubski/autonomous-dev project-alignment-validation

For use in Claude.ai and ChatGPT

Download Skill