PPROMPTWISE— governance layer for AI agents
MITPython 3.10+142 MCP tools
Not another agent — the record-keeper for the ones you already use

Every AI action, on the record.

PromptWise is the governance & intelligence layer for AI coding agents — model routing, cost control, security scanning, and a hash-chained audit trail — compiled down to MCP, SKILL.md, and AGENTS.md: the formats every agent already reads. Runs the same for a solo developer, a small team, or a regulated enterprise.

Who this is for

Same engine, three ways to run it.

No tier, no paywall, no separate "enterprise edition" — the same MIT-licensed core scales from one laptop to a regulated org, just by how many people point their agent at it.

You want it to stay out of your way.

One pip install -e ., one MCP entry, and it's live inside Claude Code, Cursor, or whatever you already run. No new UI to learn, no team to onboard — every check fails open, never blocks your flow.

2-command install → /promptwise

You want proof the process is actually followed.

Advisory quality gates, policy-as-code, and a governed agile method (PRD → stories → TDD → review) run automatically — PASS / CONCERNS / FAIL with a reason attached, not a silent checkbox nobody reads.

Shared config, per-project budgets

You want a record you can hand to an auditor.

A hash-chained audit trail that breaks visibly on tampering, mapped to GDPR, HIPAA, and OWASP controls, exported as a signed, self-contained bundle — no vendor dashboard, no seat license, data never leaves your infrastructure.

Air-gapped by default · self-hosted
The ledger

Six links, one chain — every governed action passes through all of them.

Not a settings page. Each capability writes into the same hash-chained trail, in this order, every time a hook fires.

01
route_request

Right tier, every time

In short: cheapest model that can still do the job, picked for you.

Haiku, Sonnet, or Opus, picked by task type and budget — not by habit. Reasoning effort (low / medium / high) is routed independently, with an outcome-learning adapter that fails open to the static pick when it doesn't yet have enough evidence.

02
security_check · owasp_scan

Nothing ships unchecked

In short: every write is scanned before it lands, offline.

Secrets, prompt injection, PII, and OWASP patterns — scanned air-gapped by default, with a red-team regression harness diffed against a stored baseline so fixes don't quietly reopen old holes.

03
check_policy · run_quality_gate

Policy, as code

In short: an automatic checkpoint before anything merges, with a reason attached.

An advisory quality gate and policy-as-code check run before a change merges — PASS / CONCERNS / FAIL, with a reason attached, not a silent pass.

04
grant_jit_permission

Time-boxed, not forever

In short: temporary access that expires itself — nobody has to remember to revoke it.

Standing exceptions expire on their own — 60 minutes by default, 8 hours max — and decay back to the normal permission prompt without anyone remembering to revoke them.

05
record_audit

Hash-chained, not a log file

In short: tampering with the record breaks the record, visibly.

Every governed action links to the one before it. A tampered or missing entry breaks the chain visibly — export and verify it any time with promptwise:audit.

06
capture_learning

Corrections stick

In short: tell it once, it remembers — no repeat corrections.

A correction becomes a durable, searchable rule, replayed before similar work — local first, air-gapped safe, no round-trip to a vendor to remember what you told it once.

Why it holds up under scrutiny

Built to be trusted, not just installed.

The properties a security review or a procurement checklist actually asks about — not marketing claims.

Fail-open, always

A broken check never blocks your work — advisory by default, hard-deny only for destructive commands.

Air-gapped by default

Scanning and routing run locally — no unconditional network call, no data leaving your machine.

Tamper-evident by design

Hash-chained records, Ed25519-signed exports — a missing or altered entry is visible, not silent.

One install, 142 tools

A single MCP server — no per-feature plugins to track, update, or lose track of.

14 agent hosts, one source

Write your policy once — it compiles to CLAUDE.md, AGENTS.md, and every native rules format.

MIT licensed, self-hosted

No seat license, no vendor lock-in, no dashboard you don't control. It's your repo, your data.

One source, three emitters

The governance core writes its rules once and compiles them down to every format an agent already reads — no proprietary config, no separate plugin per host.

PromptWise core router · roles · compliance context engine 142 MCP tools 83 SKILL.md packs AGENTS.md context Lifecycle hooks

What's actually inside the 142

Not a marketing simplification — the real handler categories the tools are organized into.

142 tools Governance & policy Security & compliance Incident & threat Memory & learning Cost & routing check_policy run_governor run_quality_gate security_check owasp_scan compliance_gap_analysis create_incident correlate_threats detect_agent_drift capture_learning query_memory kb_lookup route_request predict_cost project_cost_report
Coverage

14 hosts, all peers — none more "supported" than another.

One governance core, compiled to whatever your agent already reads.

PromptWise core

Compliance coverage, honestly scoped

A gap analysis, not a certification — every mapped control names the real tool that evidences it; an unevidenced control is reported absent, never guessed.

GDPR Art. 5 / 25 / 32 / 33 HIPAA §164.312 OWASP Agentic Top 10 OWASP NHI Top 10 CSA AI Controls Matrix
142
MCP tools
83
portable skill packs
1,436
tests passing
14
agent hosts supported
MIT
license

Two commands, then /mcp

# clone and install
git clone https://github.com/u2anilgit/PromptWise.git
cd PromptWise
pip install -e .

# restart your agent, then in Claude Code
/mcp
/promptwise