project-alignment-validation

Validate semantic alignment between features and PROJECT.md across GOALS, SCOPE, CONSTRAINTS, and ARCHITECTURE.

32|5|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/akaszubski/autonomous-dev --skill project-alignment-validation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-alignment-validation
Source: https://github.com/akaszubski/autonomous-dev/tree/main/plugins/autonomous-dev/skills/project-alignment-validation
Command: npx skills add https://github.com/akaszubski/autonomous-dev --skill project-alignment-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Semantic, non-literal validation of PROJECT.md alignment focusing on GOALS, SCOPE, CONSTRAINTS, and ARCHITECTURE.

Core Features & Use Cases

  • Semantic validation methodology
  • Validation of GOALS, SCOPE, CONSTRAINTS, ARCHITECTURE
  • Cross-skill referencing (alignment with other skills)

Quick Start

Quick start: run semantic validation on a new feature alignment.

Frequently Asked Questions about project-alignment-validation

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

FAQPage Schema
How do I validate semantic alignment between features and PROJECT.md?

Semantic validation checks whether features, documentation, and implementation align with your PROJECT.md's GOALS, SCOPE, CONSTRAINTS, and ARCHITECTURE sections. This Skill applies non-literal, meaning-based validation to identify gaps and conflicts across these dimensions, then delivers actionable remediation recommendations.

What does semantic validation of PROJECT.md actually do?

Semantic validation analyzes GOALS, SCOPE, CONSTRAINTS, and ARCHITECTURE in feature requests and documentation to identify alignment gaps and conflicts. It produces a status view with specific gaps and recommended changes to either update PROJECT.md or adjust implementation to restore alignment.

When should I run validation on my project documentation and features?

Run validation when introducing new features, updating requirements, or encountering scope creep. Semantic validation catches misalignments early—when GOALS shift, SCOPE expands, CONSTRAINTS are violated, or ARCHITECTURE deviates—before they compound into larger problems.

Can I validate alignment across multiple skills or components?

Yes. This Skill supports cross-skill referencing, so you can validate how features align not only with your core PROJECT.md but also with dependencies and related skills, surfacing conflicts between interconnected components.

What's the difference between semantic and literal PROJECT.md validation?

Literal validation checks if text exists; semantic validation understands meaning and intent. This Skill captures context—whether a feature truly serves your stated GOALS, respects CONSTRAINTS, and fits your ARCHITECTURE—not just whether keywords match.

What input do I need to run semantic alignment validation?

You need a PROJECT.md file with defined GOALS, SCOPE, CONSTRAINTS, and ARCHITECTURE sections. The Skill then accepts feature requests, implementation details, or documentation to validate against these sections and report gaps.