Skip to content

feat(skills): add ai-wafr — kernel-backed, evidence-verified WA review - #142

Closed
ibrahimcesar wants to merge 1 commit into
mainfrom
feat/ai-wafr-kernel-skill
Closed

feat(skills): add ai-wafr — kernel-backed, evidence-verified WA review#142
ibrahimcesar wants to merge 1 commit into
mainfrom
feat/ai-wafr-kernel-skill

Conversation

@ibrahimcesar

Copy link
Copy Markdown
Member

What

Adds a new skill ai-wafr: a kernel-backed Well-Architected review that drives the offline ai-wafr binary (the AI-WAFR reference protocol kernel) instead of performing the review in the prompt. It is the evidence-verified counterpart to the prompt-layer aws-well-architected-framework-review — complementary, not a replacement.

Why

The prompt-layer skill produces the model's findings directly and fast. The kernel-backed skill produces a verifiable bundle: an evidence ledger with exact locators, agent proposals kept structurally separate from human decisions (independent reviewer evaluation recorded before agent feedback is revealed), findings verified against a pinned framework contract and a hash-chained event log, and a loopback-only explorable report. Use it when a review must be auditable or governance-grade.

Contract (thin by design)

  1. Ensure the binary — build-from-source today; verified download against published SHA256SUMS once signed releases exist. Never run an unverified binary.
  2. ai-wafr bootstrap --workspace . and follow the pinned protocol verbatim.
  3. Facilitate the state machine (start → scan/add-evidence → propose → human evaluate → adjudicate/assess → verify → serve); the human owns every decision.

The skill carries no risk logic of its own — every rule comes from the kernel's bootstrap output, so the review is identical in every host.

Changes

  • skills/ai-wafr/SKILL.md + metadata.json — auto-discovered by install.sh across all supported agents; no wiring needed.
  • skills.sh.json — new "Verified Reviews (kernel-backed)" grouping.

Honest limits (stated in the skill)

  • The bundled pack is reference-derived and unverified — no HRI/MRI classifications.
  • Binary install is build-from-source until signed releases are published.
  • The install step must verify integrity.

No relative Markdown links (link-check safe); no references/ tree or Power mirror (parity checks unaffected).

Adds the AI-WAFR skill: a kernel-backed Well-Architected review that drives the
offline ai-wafr binary rather than performing the review in the prompt. The skill's
contract is thin — ensure the binary (build-from-source today; verified download once
signed releases publish), run `ai-wafr bootstrap --workspace .`, and follow the pinned
protocol verbatim. It carries no risk logic of its own; every rule comes from the
kernel's bootstrap output, so the review is identical in every host.

The kernel records an evidence ledger with exact locators, keeps agent proposals
structurally separate from human decisions (independent reviewer evaluation before agent
feedback is revealed), verifies findings against a pinned framework contract and a
hash-chained event log, and produces a re-verifiable bundle plus a loopback-only
explorable report. It is the evidence-verified counterpart to the prompt-layer
aws-well-architected-framework-review skill — complementary, not a replacement.

- skills/ai-wafr/SKILL.md + metadata.json (auto-discovered by install.sh across all
  supported agents; no wiring needed).
- skills.sh.json: new "Verified Reviews (kernel-backed)" grouping.

Honest limits stated in the skill: the bundled pack is reference-derived and unverified
(no HRI/MRI); binary install is build-from-source until signed releases exist; the
install step must verify integrity (no unverified binary).
@ibrahimcesar

Copy link
Copy Markdown
Member Author

Closing — not opening this yet. Keeping the ai-wafr kernel-backed skill local for now.

@ibrahimcesar
ibrahimcesar deleted the feat/ai-wafr-kernel-skill branch August 24, 2026 14:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant