intended-vs-implemented

An agent skill by phuryn, from phuryn/pm-skills. Tags: api, debugging, developer-tools, documents.

What it does

The method for finding the gap between what a system is supposed to do and what the code actually does — the class of bug generic scanners miss because they have no model of intent. Defines what counts as documented intent, what counts as implementation evidence, which mismatches matter, and how to avoid hand-wavy findings. Use when auditing AI-built code, reviewing access control against documented permissions, or checking whether a codebase matches its own documentation.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

npx skills add phuryn/pm-skills --skill intended-vs-implemented

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/phuryn/pm-skills
cp -r pm-skills/pm-ai-shipping/skills/intended-vs-implemented ~/.claude/skills/intended-vs-implemented

Safety box score

Not rated yet. A safety box score grades what a skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. Anyone can request one from this page; it is saved for everyone. How the score works.

Source

Repository

phuryn/pm-skills (all skills from this repository)

Path

pm-ai-shipping/skills/intended-vs-implemented/SKILL.md

Branch

main

Updated

2026-09-19

Related skills

• deprecation-and-migration — Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another.
• code-review — Review code for actionable defects. Correctness is the core; performance and security are optional sub-cases of the same engine.
• shipping-artifacts — The durable documentation set that makes an AI-built (vibe-coded) app reviewable before shipping.
• test-scenarios — Create comprehensive test scenarios from user stories with test objectives, starting conditions, user roles, step-by-step actions, and expected outcomes.
• archify-review — Review Archify issues, PRs, or code through value, cost, and impact to support evidence-based maintenance decisions.
• claude-api — Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration.