From c1cae66f3804a1db511dce12a1f8783507652ad7 Mon Sep 17 00:00:00 2001
From: Allaun Silverfox <28494262+allaunthefox@users.noreply.github.com>
Date: Sun, 17 May 2026 14:38:12 -0500
Subject: [PATCH] Add adversarial duals combined documentation

---
 ...RSARIAL_DUALS_ANTI_FAMM_ANTI_BRAIDSTORM.md | 70 +++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 6-Documentation/famm/ADVERSARIAL_DUALS_ANTI_FAMM_ANTI_BRAIDSTORM.md

diff --git a/6-Documentation/famm/ADVERSARIAL_DUALS_ANTI_FAMM_ANTI_BRAIDSTORM.md b/6-Documentation/famm/ADVERSARIAL_DUALS_ANTI_FAMM_ANTI_BRAIDSTORM.md
new file mode 100644
index 00000000..8f828e6a
--- /dev/null
+++ b/6-Documentation/famm/ADVERSARIAL_DUALS_ANTI_FAMM_ANTI_BRAIDSTORM.md
@@ -0,0 +1,70 @@
+# Adversarial Duals: Anti-FAMM and Anti-BraidStorm
+
+## Purpose
+
+Register the adversarial dual layer for the project.
+
+```text
+Anti-FAMM       = attacks witness completeness and scar classification
+Anti-BraidStorm = attacks crossing validity and survivor convergence
+```
+
+They are not separate enemy systems. They are Warden-facing adversarial tools.
+
+## Why they exist
+
+Without Anti-FAMM:
+
+```text
+FAMM might only record the failures it is already designed to see.
+```
+
+Without Anti-BraidStorm:
+
+```text
+BraidStorm might promote hypotheses that survive friendly crossings but fail hostile geometry.
+```
+
+With both:
+
+```text
+survivors must survive hostile geometry.
+```
+
+## Combined promotion loop
+
+```text
+candidate route
+→ FAMM score
+→ BraidStorm crossing
+→ Judge receipt
+→ Anti-FAMM shadow attack
+→ Anti-BraidStorm crossing attack
+→ Warden decision
+→ promote / scar / coarsen / reject
+```
+
+## Relationship to other gates
+
+| Gate | Role in adversarial layer |
+|---|---|
+| Shadow Control Gap Map | finds where witness control fails |
+| Sidon Crossing Anti-Alias | catches pair-address / receipt aliasing |
+| Golden Braid Centering | catches unstable or anisotropic strand collapse |
+| Plasma Chiral Drag Witness | checks signed torsion/chirality residuals |
+| Feynman Path Shadow Witness | treats non-surviving histories as cancellation evidence |
+| Builder-Judge-Warden | decides promotion, scar, coarsening, or rejection |
+
+## Warden decision classes
+
+```text
+ALLOW_PROMOTION_CANDIDATE
+BLOCK_OR_REOPEN_ROUTE
+SCAR_AND_COARSEN
+REQUIRE_NEW_WITNESS_CHANNEL
+REJECT_FALSE_SURVIVOR
+```
+
+## Project sentence
+
+Anti-FAMM and Anti-BraidStorm are the adversarial duals of the stack: Anti-FAMM searches for invisible residuals and false scars in the witness projection, while Anti-BraidStorm generates hostile crossing histories to expose false convergence, aliasing, wrong-handed recombination, and receipt drift. Survivors are only promoted after they withstand both.