<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/development/how-to/add-architectural-gate-exemption/">
  <id>https://docs.spec-kitty.ai/development/how-to/add-architectural-gate-exemption/</id>
  <title>Add an exemption to an architectural gate</title>
  <updated>2026-10-01T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/development/how-to/add-architectural-gate-exemption/"/>
  <summary>How to exempt a source site from a tests/architectural gate by content, never by line number: hand-curated allowlists, census gates and the dead-symbol YAML.</summary>
  <content type="html">&lt;span id=&quot;add-an-exemption-to-an-architectural-gate&quot;&gt;&lt;/span&gt;
&lt;p&gt;&lt;strong&gt;Audience&lt;/strong&gt;: maintainers and agents whose change trips a &lt;code dir=&quot;auto&quot;&gt;tests/architectural/&lt;/code&gt; gate on a
site that is genuinely allowed (a sanctioned &lt;code dir=&quot;auto&quot;&gt;os.path.join&lt;/code&gt;, a guarded &lt;code dir=&quot;auto&quot;&gt;reset --hard&lt;/code&gt;, a known
OS-detection branch).&lt;/p&gt;
&lt;p&gt;Every exemption identifies its site by &lt;strong&gt;content&lt;/strong&gt;, never by line number. A line-pinned
entry goes red on any unrelated edit above it and, once stale, can silently bless a new
violation on its old line. The positional-anchor ban
(&lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_ratchet_positional_anchor_ban.py&lt;/code&gt;) rejects line-pinned entries
anywhere under &lt;code dir=&quot;auto&quot;&gt;tests/architectural/&lt;/code&gt;, and its own exemption set is pinned empty.&lt;/p&gt;
&lt;h2 id=&quot;1-identify-which-kind-of-allowlist-the-gate-uses&quot;&gt;1. Identify which kind of allowlist the gate uses&lt;/h2&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Kind&lt;/th&gt;&lt;th&gt;Examples&lt;/th&gt;&lt;th&gt;Entry form&lt;/th&gt;&lt;th&gt;Stale entry&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Hand-curated&lt;/td&gt;&lt;td&gt;join allowlist, kernel/doctrine import exemptions, os-detect / lock-ban / clock &lt;code dir=&quot;auto&quot;&gt;_exemptions/*.txt&lt;/code&gt;&lt;/td&gt;&lt;td&gt;content descriptor&lt;/td&gt;&lt;td&gt;&lt;strong&gt;fails&lt;/strong&gt; the gate&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Census&lt;/td&gt;&lt;td&gt;destructive-op, mutation-ownership, overwrite-ownership gates&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;CensusKey(...)&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;warns&lt;/strong&gt; only&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Dead-symbol YAML&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;test_no_dead_symbols.py&lt;/code&gt; via &lt;code dir=&quot;auto&quot;&gt;tests/architectural/dead_symbol_allowlist.yaml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;(module, name)&lt;/code&gt; entry with a category and rationale&lt;/td&gt;&lt;td&gt;&lt;strong&gt;fails&lt;/strong&gt; the gate&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;2a-hand-curated-gate-add-a-content-descriptor&quot;&gt;2a. Hand-curated gate: add a content descriptor&lt;/h2&gt;
&lt;p&gt;The descriptor form is &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;repo-relative path&gt;::&amp;#x3C;qualname&gt;::&amp;#x3C;token_substring&gt;[::&amp;#x3C;occurrence&gt;]&lt;/code&gt;.
&lt;code dir=&quot;auto&quot;&gt;qualname&lt;/code&gt; is the enclosing scope and &lt;code dir=&quot;auto&quot;&gt;token_substring&lt;/code&gt; is a distinctive fragment of the
statement’s normalised tokens. Add &lt;code dir=&quot;auto&quot;&gt;occurrence&lt;/code&gt; (0-based) only when the same qualname and
token appear more than once in the file.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;In an &lt;code dir=&quot;auto&quot;&gt;_exemptions/*.txt&lt;/code&gt; file, write one descriptor per line.&lt;/li&gt;
&lt;li&gt;In a Python allowlist, add a &lt;code dir=&quot;auto&quot;&gt;ContentDescriptor&lt;/code&gt; entry with a non-empty rationale.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Render the line rather than hand-typing it:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;python&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;from&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; tests.architectural._content_identity &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; render_descriptor_line&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Matching goes only through &lt;code dir=&quot;auto&quot;&gt;tests/architectural/_content_identity.py&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;resolve_allowlist&lt;/code&gt; + &lt;code dir=&quot;auto&quot;&gt;partition_findings&lt;/code&gt;). One entry suppresses at most one finding.&lt;/p&gt;
&lt;h2 id=&quot;2b-census-gate-add-a-censuskey&quot;&gt;2b. Census gate: add a &lt;code dir=&quot;auto&quot;&gt;CensusKey&lt;/code&gt;&lt;/h2&gt;
&lt;p&gt;The gate’s failure message prints the unexpected site as
&lt;code dir=&quot;auto&quot;&gt;rel::qualname::op#ordinal (line N) tokens=...&lt;/code&gt;. The line is a locator only. Add a literal
to the gate’s &lt;code dir=&quot;auto&quot;&gt;_ALLOWLIST&lt;/code&gt;:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;python&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#B2CCD6;--1:#096E72&quot;&gt;CensusKey&lt;/span&gt;&lt;span style=&quot;--1:#403F53&quot;&gt;&lt;span style=&quot;--0:#D6DEEB&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#D7DBE0&quot;&gt;rel&lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;src/...&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D7DBE0;--1:#403F53&quot;&gt;qualname&lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D7DBE0;--1:#403F53&quot;&gt;token_line&lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D7DBE0;--1:#403F53&quot;&gt;op&lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D7DBE0;--1:#403F53&quot;&gt;op_ordinal&lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;): (&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;why this destructive operation is safe here&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;),&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;op_ordinal&lt;/code&gt; counts identical &lt;code dir=&quot;auto&quot;&gt;(qualname, token_line, op)&lt;/code&gt; sites in source order. A second
identical operation in the same function therefore becomes a new, unexpected site and fails
the gate. If the gate is registered in &lt;code dir=&quot;auto&quot;&gt;tests/architectural/_baselines.yaml&lt;/code&gt; (for example the
mutation-ownership gate’s &lt;code dir=&quot;auto&quot;&gt;destructive_op_allowlist&lt;/code&gt;), raise that ceiling in the same change and justify it in review.
Baselines are shrink-only by default.&lt;/p&gt;
&lt;h2 id=&quot;2c-dead-symbol-gate-add-a-yaml-entry&quot;&gt;2c. Dead-symbol gate: add a YAML entry&lt;/h2&gt;
&lt;p&gt;First try to wire the symbol, drop it from &lt;code dir=&quot;auto&quot;&gt;__all__&lt;/code&gt;, or delete it. If an exemption is
genuinely warranted, append an entry under &lt;code dir=&quot;auto&quot;&gt;entries:&lt;/code&gt; in
&lt;code dir=&quot;auto&quot;&gt;tests/architectural/dead_symbol_allowlist.yaml&lt;/code&gt;:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;module&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;specify_cli.example.module&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;   &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# the module whose __all__ declares the name&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;ExampleSymbol&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;category&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;category_c_example&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;         &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# must be declared under categories:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;rationale&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;why this public symbol has no src/ caller yet&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# optional -- see below&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;issue&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;#1234&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;                       &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# required where the category sets requires_issue: true&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;An entry’s &lt;code dir=&quot;auto&quot;&gt;rationale:&lt;/code&gt; is optional: if omitted, the gate falls back to its
category’s rationale (loader rule L6 — the &lt;em&gt;effective&lt;/em&gt; rationale is never
empty, but an entry does not have to restate its category’s reason). Give an
entry its own &lt;code dir=&quot;auto&quot;&gt;rationale:&lt;/code&gt; only when this specific symbol needs a reason
beyond the category’s.&lt;/p&gt;
&lt;p&gt;The loader (&lt;code dir=&quot;auto&quot;&gt;tests/architectural/_dead_symbol_allowlist.py&lt;/code&gt;) refuses unknown keys
(never add &lt;code dir=&quot;auto&quot;&gt;line:&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;body_hash:&lt;/code&gt;), a present-but-empty rationale, an undeclared category, a
duplicate &lt;code dir=&quot;auto&quot;&gt;(module, name)&lt;/code&gt;, and a declared category with no entries. In the same change,
raise the &lt;code dir=&quot;auto&quot;&gt;test_no_dead_symbols: allowlist_entries&lt;/code&gt; leaf in
&lt;code dir=&quot;auto&quot;&gt;tests/architectural/_baselines.yaml&lt;/code&gt; by one and justify it in review. The widened
&lt;code dir=&quot;auto&quot;&gt;widened_grandfathered_470&lt;/code&gt; section has its own leaf.&lt;/p&gt;
&lt;h3 id=&quot;declaring-a-new-category&quot;&gt;Declaring a new category&lt;/h3&gt;
&lt;p&gt;A new &lt;code dir=&quot;auto&quot;&gt;category_*&lt;/code&gt; is declared under &lt;code dir=&quot;auto&quot;&gt;categories:&lt;/code&gt;, with its own required rationale and
&lt;code dir=&quot;auto&quot;&gt;requires_issue&lt;/code&gt; policy:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;categories&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;category_x_example&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;rationale&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;a one-line reason every entry in this category shares&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;requires_issue&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;   &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# true forces every entry (and the widened section) to carry issue:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Rule L9 refuses a category with no entries (no tombstones): declare the category and its
first entry in the same change, and delete the category once its last entry is removed.&lt;/p&gt;
&lt;p&gt;A body edit to an allowlisted symbol needs no allowlist edit. A move or rename is
reported as a &lt;code dir=&quot;auto&quot;&gt;GONE&lt;/code&gt; entry plus a new offender; update the entry’s &lt;code dir=&quot;auto&quot;&gt;module:&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;name:&lt;/code&gt;.
See &lt;a href=&quot;/development/reference/ci-gate-mechanics/#moving-or-renaming-a-symbol-that-is-dead-symbol-allowlisted&quot;&gt;CI and Architectural Gate Mechanics&lt;/a&gt;
and the &lt;a href=&quot;/adr/4.x/2026-10-01-1-dead-symbol-allowlist-module-name-identity/&quot;&gt;identity ADR&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;3-verify&quot;&gt;3. Verify&lt;/h2&gt;
&lt;p&gt;Run the gate you touched and the positional-anchor ban:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;PWHEADLESS&lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;.venv/bin/python&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-m&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;pytest&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;tests/architectural/&amp;#x3C;gate&gt;.py&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;tests/architectural/test_ratchet_positional_anchor_ban.py&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-q&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Do not run the full &lt;code dir=&quot;auto&quot;&gt;tests/architectural/&lt;/code&gt; suite locally; CI owns it.&lt;/p&gt;
&lt;h2 id=&quot;see-also&quot;&gt;See also&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/development/how-to/review-gates/&quot;&gt;Review gates: pre-PR / pre-review checklist&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Entry-format contract: &lt;code dir=&quot;auto&quot;&gt;kitty-specs/ratchet-baseline-census-gate-remediation-01M3EW3Z/contracts/allowlist-entry-formats.md&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
