01 / PROJECT DOCS
Architecture & decisions
The four documents from plugins/proofpunk/docs/, rendered in full as subpages —
how the 18 skills execute as one system, how they were consolidated from a 664-skill
universe scan, hands-on invocation examples, and the v1.0.0 validation record.
D1Proofpunk Plugin ArchitectureThis is the map a new contributor reads first: what each layer of theRENDERED
D2Consolidation Decisions — ProofpunkHow the source archive's skills were reviewed and consolidated into thisRENDERED
D3Design — proofpunk v1.10.0: deterministic hook enforcement + `/proofpunk:install`**Status**: implemented in this release. Sources cited per section.RENDERED
D4Twelve Improvements — measured, not assertedEvery row below came from walking the real tree this session (six scoutRENDERED
D5Invocation Contracts — how skills, hooks, agents, and plugins actually fireResearched 2026-08-13 from official/vendor sources only. This table is theRENDERED
D6Proofpunk Usage Guide — Claude Code, oh-my-pi, and OpenCode> **Read first:** [architecture.md](architecture.md) — how the 18 skills execute as one delegation DAG: method ownership, the full call graph, execution order per command, and the RENDERED
D7Validation Results — Proofpunk v1.0.0All validation was run against the real plugin source. No mocks, no stubs,RENDERED
02 / SHARED DOCTRINE
13 ruling references
The doctrine every skill loads on demand — the Iron Rule, the End-User Actor Mandate, the
evidence contract, severity model, platform routing, preflight checks, and CI gate
classification. Rendered from plugins/proofpunk/references/.
R1Backend API Validation Reference- **curl**: Pre-installed on macOS/Linux. Verify: `curl --version`DOCTRINE
R2CI / Pre-Commit Quality Gates (shared)Methodology for layered build-quality gates, condensed fromDOCTRINE
R4UI Defect Pattern DatabaseCommon defects across iOS, web, and cross-platform with root causes and fix patterns. Organized by audit phase: triage (Phase 0), visual (Phase 1), interactive (Phase 2), content (DOCTRINE
R5End-User Actor Mandate (shared)The cross-cutting operating principle for every Proofpunk skill:DOCTRINE
R6Evidence Contract (shared)Canonical evidence standard for every Proofpunk skill. Consolidated fromDOCTRINE
R7iOS & macOS Visual Inspection — Apple HIG ChecklistPlatform-specific checks supplementing the universal checklist in SKILL.md.DOCTRINE
R8iOS/macOS Validation Reference- **Xcode CLI tools**: `xcode-select --install` (if `xcodebuild` not found)DOCTRINE
R9Platform Routing (shared)Canonical platform detection and validation routing for Proofpunk skills.DOCTRINE
R10Preflight Checks (shared)Pre-session environment checks to catch blockers BEFORE validation orDOCTRINE
R11Severity Model (shared)Canonical severity classification and verdict rules for all ProofpunkDOCTRINE
R12Web Frontend Validation Reference- **Playwright**: `npx playwright install chromium` (if `chromium.launch()` fails with "executable doesn't exist")DOCTRINE
R13Web Visual Inspection — WCAG 2.2 & Responsive ChecklistPlatform-specific checks supplementing the universal checklist in SKILL.md.DOCTRINE