pr-to-spec
Analyze code changes and detect intent drift using pr-to-spec CLI
Best for CI pipelinesWorks with GitHubLow risk
⌘source
- author
@jeremylongshore- language
- Python
★2.1kstars
281forks
May 1, 2026
✦overview.md
Key Features
- ·Analyze branch changes vs main
- ·Detect intent drift
- ·Declare change intent
- ·JSON output for agents
- ·Exit codes for automation
Use Cases
- →Check PR changes for alignment with declared goals
- →Automate review of staged changes before commit
- →Enforce scope constraints in CI pipeline
Best for
- ✓CI pipelines
- ✓PR review automation
- ✓code enforcement
Not ideal for
- !manual code review
- !design discussions
FAQs
name
pr-to-spec
description
Analyze code changes and detect intent drift using pr-to-spec CLI
version:0.8.0
author:Jeremy Longshore
triggers:["/pr-to-spec","pr-to-spec scan","pr-to-spec check","pr-to-spec intent"]
pr-to-spec Skill
Convert code changes into structured, agent-consumable specs with intent drift detection.
Commands
/pr-to-spec scan
Analyze current branch changes vs main and output a structured spec.
pr-to-spec scan --branch main --json
Use --diff N to scan last N commits, or --staged for staged changes only.
/pr-to-spec check
Scan current changes AND check for drift against declared intent.
pr-to-spec check --json
Returns exit code 3 if drift is detected, 2 if high-risk, 0 if clean.
/pr-to-spec intent set
Declare what this change is supposed to do.
pr-to-spec intent set --goal "Add rate limiting to API" --scope "src/middleware/**" --forbid "src/db/**" --max-risk medium
/pr-to-spec intent show
Show the current intent declaration.
pr-to-spec intent show --json
Agent Protocol
All --json output is wrapped in the agent protocol envelope:
{
"version": 1,
"command": "check",
"status": "drift_detected",
"exit_code": 3,
"signals": [...],
"spec": {...},
"intent": {...}
}
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Clean — no issues |
| 1 | Error |
$install
1-click copynpx skills add jeremylongshore/claude-code-plugins-plus-skills --skill pr-to-specSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.