verify-config

Stars11

Forks2

UpdatedApril 25, 2026 at 08:41

Audits CLAUDE.md and .ai/ reference files against actual codebase patterns. Use to detect configuration drift and ensure documentation stays in sync with the codebase.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

I-Synergy

I-Synergy/I-Synergy.Framework

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	verify-config
description	Audits CLAUDE.md and .ai/ reference files against actual codebase patterns. Use to detect configuration drift and ensure documentation stays in sync with the codebase.

Verify Configuration Skill

Audits project documentation against actual codebase conventions to detect and fix drift.

Steps

Read current documentation
- Read CLAUDE.md
- Read .ai/reference/critical-rules.md
- Read .ai/patterns/cqrs-patterns.md
- Extract all documented conventions (data access patterns, naming, file structure, mapping, etc.)
Sample the codebase for actual patterns
- Pick a representative domain from {ApplicationName}.Domain.* as the reference implementation
- Read 2-3 command handlers (Create, Update, Delete)
- Read 2-3 query handlers (GetById, GetList)
- Read the Mappers/Configuration.cs
- Read 2-3 Model records from Models/
- Read 2-3 Response records
- Check Extensions/ServiceCollectionExtensions.cs
Compare and report
- For each documented convention, verify it matches the actual code
- Check for patterns in the code that are NOT documented
- Categorize findings:
  - Correct — documentation matches code
  - Drift — documentation contradicts code
  - Missing — code pattern not documented
  - Stale — documented pattern no longer used
Check .ai/ folder structure
- Verify .claude/settings.json has plansDirectory pointing to local .ai/plans
- Verify .ai/progress/ and .ai/plans/ folders exist
- Check that no project-specific config leaked to global ~/.ai/
Present findings
- Show a summary table of all conventions checked with their status
- For each Drift/Missing/Stale finding, show the documented vs actual pattern
- Propose specific edits to fix any drift found
- Wait for user approval before making changes

Output Format

## Configuration Audit Report

### Summary
- Conventions checked: N
- Correct: N
- Drift detected: N
- Missing documentation: N
- Stale documentation: N

### Findings

| # | Convention | Status | Details |
|---|-----------|--------|---------|
| 1 | Data access style | Correct/Drift/Missing/Stale | ... |
| 2 | ... | ... | ... |

### Recommended Fixes
1. ...
2. ...

More from this repository

same repository

book-to-skill

I-Synergy/I-Synergy.Framework

Converts a technical book (PDF or EPUB) into a structured Claude Code skill — extracting frameworks, mental models, principles, techniques, and anti-patterns the author crystallized. Use when the user wants to study a book through Claude, apply an author's frameworks while working, or build a reusable knowledge base from any PDF or EPUB.

2026-05-0711

keycloak-theme-colors

I-Synergy/I-Synergy.Framework

Update the accent colors in an I-Synergy Keycloak login theme from a single base hex color. Trigger when the user provides a hex color code (like "#0078D7") for a theme, says "align colors with the logo", "update the theme colors", "set the accent to

2026-05-0711

update-skills

I-Synergy/I-Synergy.Framework

Syncs .claude/skills/ and .github/skills/ from .ai/skills/ (the source of truth). Run after adding, editing, or removing a skill in .ai/skills/.

2026-05-0711

upgrade-template

I-Synergy/I-Synergy.Framework

Upgrades an existing project with improvements from the CLAUDE.MD template. Use when the user says "upgrade the template", "sync template changes to a project", "update project X with new skills", or wants to apply template improvements without losing project-specific context. Runs upgrade-template.py which copies new files and diffs changed ones, never touching project-owned paths.

2026-05-0711

book-to-skill

I-Synergy/I-Synergy.Framework

2026-05-0711

keycloak-theme-colors

I-Synergy/I-Synergy.Framework

2026-05-0711

Verify Configuration Skill

Audits project documentation against actual codebase conventions to detect and fix drift.

Steps

Read current documentation

Read CLAUDE.md
Read .ai/reference/critical-rules.md
Read .ai/patterns/cqrs-patterns.md
Extract all documented conventions (data access patterns, naming, file structure, mapping, etc.)

Sample the codebase for actual patterns

Pick a representative domain from {ApplicationName}.Domain.* as the reference implementation
Read 2-3 command handlers (Create, Update, Delete)
Read 2-3 query handlers (GetById, GetList)
Read the Mappers/Configuration.cs
Read 2-3 Model records from Models/
Read 2-3 Response records
Check Extensions/ServiceCollectionExtensions.cs

Compare and report

For each documented convention, verify it matches the actual code
Check for patterns in the code that are NOT documented
Categorize findings:
- Correct — documentation matches code
- Drift — documentation contradicts code
- Missing — code pattern not documented
- Stale — documented pattern no longer used

Check .ai/ folder structure

Verify .claude/settings.json has plansDirectory pointing to local .ai/plans
Verify .ai/progress/ and .ai/plans/ folders exist
Check that no project-specific config leaked to global ~/.ai/

Present findings

Show a summary table of all conventions checked with their status
For each Drift/Missing/Stale finding, show the documented vs actual pattern
Propose specific edits to fix any drift found
Wait for user approval before making changes

Output Format

## Configuration Audit Report ### Summary - Conventions checked: N - Correct: N - Drift detected: N - Missing documentation: N - Stale documentation: N ### Findings | # | Convention | Status | Details | |---|-----------|--------|---------| | 1 | Data access style | Correct/Drift/Missing/Stale | ... | | 2 | ... | ... | ... | ### Recommended Fixes 1. ... 2. ...