Wrkr Mental Model
Wrkr Mental Model
Wrkr evaluates your AI dev tool configurations across your GitHub repo/org against policy. Posture-scored, compliance-ready.
Problem-First View
Wrkr answers four recurring governance questions:
- What AI tooling is declared across repo/org surfaces?
- What access and autonomy context is implied by those declarations?
- Which risks are most important to act on first?
- Can we produce deterministic evidence for audits and CI gates?
Discovery vs Control Boundary
- Wrkr: discovery, posture, risk, lifecycle, evidence.
- Control runtime: tool-boundary side-effect enforcement.
Identity Lifecycle Model
stateDiagram-v2
[*] --> discovered
discovered --> under_review: identity review
under_review --> approved: explicit approval
approved --> active: operational use
active --> deprecated: retirement
active --> revoked: policy violation
approved --> revoked: approval revoked
deprecated --> revoked: final retirement
Evidence and Drift Loop
flowchart LR
A["Scan"] --> B["Ranked Findings"]
B --> C["Evidence Bundle"]
C --> D["Verify Chain"]
D --> E["Baseline Init"]
E --> F["Regress Run"]
F -->|exit 5| G["Investigate Drift"]
F -->|exit 0| H["Gate Passed"]
Command Anchors
wrkr scan --json
wrkr evidence --frameworks eu-ai-act,soc2 --json
wrkr verify --chain --json
wrkr regress run --baseline ./.tmp/wrkr-regress-baseline.json --jsonWhen Not To Use
- You require runtime traffic telemetry rather than static config posture.
- You require non-deterministic heuristic scoring in the default pipeline.
Q&A
What is the difference between discovery and control in Wrkr?
Wrkr handles discovery, posture scoring, lifecycle state, and evidence generation. Control systems handle runtime side-effect enforcement.
Why does Wrkr model identity lifecycle states?
Lifecycle states (discovered through revoked) make approvals and operational status explicit and auditable across scans.
What is the recommended drift-management loop?
Use scan -> evidence -> verify -> regress baseline/run. Treat regress exit code 5 as your deterministic drift signal.