Audit protocol
Skill lubochka/xiigen-mvp-engine/.agents/skills/audit-protocol
Self-building AI code generation engine that generates application flows instead of implementing them. AGPL-3.0.
npx -y skills add lubochka/xiigen-mvp-engine --skill audit-protocolAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 13 days oldThe repository was created 13 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.9 KB, as published. Nobody here has run it
Audit Protocol Skill
Defines what a "deep audit" must cover — a 10-point checklist every audit runs against. Prevents ad-hoc audits that vary by reviewer and time available.
When to Invoke
- When a cross-model review (Gate B of plan-review-skill) is requested
- When reviewing any reviewer's output
- Before declaring any plan "ready for execution"
10-Point Audit Checklist
Every audit must explicitly address all 10 points. Points not checked must be listed in "NOT CHECKED" section with reason.
| # | Check | Skill | Pass Condition |
|---|---|---|---|
| 1 | Chain arithmetic | chain-arithmetic-audit | baseline + Σ(deltas) = final for every metric |
| 2 | Blast radius tagging | blast-radius-tagger | every deliverable tagged; PRODUCTION-CI has validation + rollback |
| 3 | API shape verification | api-shape-verification | all imports have verified export shape, params, return type |
| 4 | Commit atomicity | blast-radius-tagger | GOVERNANCE and PRODUCTION-CI committed before TEST-ONLY |
| 5 | WF verifiability | — | every write-time fix has a grep/lint/test to confirm it landed |
| 6 | Path verification | — | every file path verified against actual codebase (not assumed) |
| 7 | Gate thresholds | — | every pass/fail threshold is explicit — no "~approximately" |
| 8 | Severity assignment | — | every finding tagged: 🔴 BLOCKING | ⚠️ WRITE-TIME | ℹ️ INFORMATIONAL |
| 9 | Severity consistency | — | no finding tagged 🔴 may resolve as "minor" in same review |
| 10 | Coverage declaration | — | Section B explicitly lists what was NOT checked and why |
Severity Definitions
| Tag | Meaning | Required Action |
|---|---|---|
| 🔴 BLOCKING | Execution cannot proceed without fix | Stop, fix, re-review before proceeding |
| ⚠️ WRITE-TIME | Fix during execution, pre-approved | Document as WF-N entry with verification command |
| ℹ️ INFORMATIONAL | Noted, no action required | Log only, no gate impact |
Rules
- Every finding must have exactly ONE severity tag
- A finding tagged 🔴 BLOCKING that "resolves as minor" is a protocol violation — reclassify or escalate
- The audit output must end with a "NOT CHECKED" table listing omissions with reasons
- Gate B of plan-review-skill is not complete until all 10 points are explicitly addressed
Anti-Pattern
Deep audit (Document 5) tagged Issue 2 as 🔴 then concluded "MINOR — internally consistent." That is a severity inconsistency violation (Rule 2). It wastes reviewer attention on a finding that had no action.
Gate Thresholds — MVP Stack (TypeScript)
Point 7 ("Gate thresholds — no ~approximately") is expressed in this MVP's own tooling. A gate threshold is concrete only when it is a count or comparison in NestJS/React tooling:
- build / type gate:
npm run build(server and client) returns 0 errors; - unit gate:
npx jest <path>reports an exactN passed, 0 failed; - e2e / UI gate:
npx playwright test <spec>passes the named scenario.
dotnet test / dotnet build thresholds from the core reference map to these MVP commands.
Blast-radius INTERFACE-tagged findings (point 2/4) require a named rollback path; PRODUCTION
findings are committed before TEST-ONLY ones.
Single-Source Note
This is the single audit-protocol skill the unified HOW-TO-USE-SKILLS.md references — not one
of the scattered CODE-REVIEW / DESIGN-REVIEW addenda. The 10 points, the three-tier severity,
and the mandatory NOT-CHECKED section are the one audit contract; sessions cite this file by SK
number rather than re-deriving an ad-hoc checklist.
Integration
- Invoked by plan-review-skill Gate B
- Invokes: chain-arithmetic-audit, blast-radius-tagger, api-shape-verification
- Results feed into the final gate table before ExitPlanMode