intended-vs-implemented

Audit discrepancies between documented system intent and code implementation.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/Lev-it/lev-skills --skill intended-vs-implemented
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: intended-vs-implemented
Source: https://github.com/Lev-it/lev-skills/tree/main/.claude/skills/intended-vs-implemented
Command: npx skills add https://github.com/Lev-it/lev-skills --skill intended-vs-implemented

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The method finds the gap between what a system is supposed to do and what the code actually does, helping with auditing AI-built code, reviewing access control, and checking codebase documentation.

Core Features & Use Cases

  • Audit Intent: Audits the gap between documented intent and actual code.
  • Code Review: Ensures that access control aligns with documented permissions.
  • Documentation Verification: Checks whether a codebase matches its own documentation.
  • Use Case: Auditing AI-built code for security and correctness bugs, particularly where scanners miss because of missing intent models.

Quick Start

Audit the intent vs. implementation of a codebase with the 'intended-vs-implemented' skill.

Frequently Asked Questions about intended-vs-implemented

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

FAQPage Schema
How do I verify that my codebase matches its documentation?

Auditing AI-built code for security and correctness bugs involves modeling documented system intent and comparing it against the actual implementation to find hidden flaws. This catches security vulnerabilities and correctness bugs that traditional automated scanners miss because they lack an intent model.

What is the best way to audit access control implementation against documented permissions?

The best way to audit access control alignment is to run an intent verification process that compares documented permissions directly against the codebase implementation. This highlights any discrepancies where actual access control logic diverges from the documented system intent.

Why do standard code scanners miss security bugs in AI-built code?

Standard code scanners miss security bugs in AI-built code because they lack a documented intent model to verify against the actual implementation. Identifying these discrepancies requires auditing the gap between what the system is supposed to do and what the code actually does.

Can I use intent verification for security auditing on an existing codebase?

Yes, you can use intent verification for security auditing on an existing codebase to identify discrepancies between documented system intent and actual code. This is particularly effective for reviewing access control alignment and checking codebase documentation accuracy.

When should I not rely solely on automated code analysis for bug identification?

You should not rely solely on automated code analysis when auditing AI-built code, because scanners miss bugs caused by missing intent models. You need to explicitly verify the gap between documented intent and actual implementation to ensure true security and correctness.