Add adversarial duals combined documentation

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.