docs: add a calibrated Verification Gate to CLAUDE.md and AGENTS.md

[alirezarezvani]

Adds a Verification Gate to the operating manual — the highest-leverage quality habit, customized so it adopts seamlessly with zero contradictions.

The gate

Before multi-step work / a factual or numeric claim / anything others see / anything that sends·publishes·schedules·deletes·acts outside the repo: state (1) done-right, (2) the concrete check (trace numbers to source · confirm a link/quote · run the test · /graph-query · wiki_lint · re-verify the action took effect), (3) the falsifier; then do it, run the checks, and report actual findings — no vague assurances.

Why it's non-contradictory (the customization)

• The declare→check→report loop is universal (operationalizes the existing "verify before you claim done").
• wait-for-OK is scoped to external/irreversible/regulated only — matching the existing draft-not-send default. Reversible/internal work stays produce-then-show, honoring "produce, don't pester" and "you MAY create artifacts without approval."
• Checks are wired to gAIOS's real tools, and repo changes remain CI-gated (ai-review).

Verification

• git diff --numstat: 0 deletions in both files — nothing existing changed.
• Reversible clause matches "produce, don't pester"; external clause matches "draft-not-send" — confirmed by grep.
• Structure intact; wiki_lint green; no secrets.

Type

• docs

[claude]

AI Merge-Gate Review — PR #18

Title check: docs: add a calibrated Verification Gate to CLAUDE.md and AGENTS.md ✅ Valid Conventional Commit.

Base branch: dev — standard bar applies (not the stricter main/production gate).

---

Findings

Dimension	Status	Notes
Correctness	✅ Pass	Purely additive (29 additions, 0 deletions). No existing content modified. The Verification Gate section fits cleanly between Operating Discipline item #5 and ## Your skills. Internally consistent.
Security	✅ Pass	Documentation only. No code, no secrets, no credentials, no executable paths introduced.
gAIOS Guardrails	✅ Pass	No secrets/PHI/PII/confidential figures. No external comms sent. No regulatory/financial/legal claims invented. The added content explicitly operationalises the existing draft-not-send default and produce, don't pester principles — no contradictions.
Clarity	✅ Pass	Gate is well-structured (done-right → check → falsifier). AGENTS.md carries a concise mirror with a pointer to the full version, per its lightweight role.
Scope creep	✅ None	Every added line is traceable to the stated goal. No adjacent clean-up or speculative additions.

---

Summary

Clean, low-risk documentation PR. The Verification Gate operationalises an existing principle ("verify before you claim done — evidence, not assertion") with concrete tooling references (/graph-query, wiki_lint, CI ai-review). The wait-for-OK vs produce-then-show split is correctly scoped to match the existing autonomy model. No concerns.

Verdict: APPROVE