ADR-047 ActifActive governance

System rule: no `:visited` state on navigation

DateDate
2026-06-05
DécideursDecision makers
Design System Lead

Context

During the site redesign, a pattern flaw was identified: navigation elements can inherit the browser's :visited state (a purple tint, or other color drift), which breaks visual consistency and hierarchy. A menu, a tab, a sidebar, a table of contents, or a header icon-button is not "read / unread" content: its appearance shouldn't depend on browsing history.

The site was already neutralizing :visited in a piecemeal, scattered way (only .top-nav and .github-btn), while other navigation surfaces (.sidebar, .toc, .footer-links, .audit-footer-link) were not. The explicit human request: make it a system-wide rule, not just a local website fix.

Decision

Adopt a no-visited-nav governance rule (see .claude/rules/no-visited-nav.md):

Every navigation element realigns its :visited color with the unvisited state. The rule applies to **the site, the agtc-* components, and consuming applications**.

Rule scope

✅ In scope (no visited state)❌ Out of scope (visited state allowed)
Header nav (+ CTA), sidebar, TOC, tabs, breadcrumbs, pagination, menus, header/footer icon-buttons, footer nav linksContent links in prose, result/archive lists where "already read" helps the user

Sorting criterion: if the element is used to move around the product → navigation → no visited state. If it points to a resource to read → visited state allowed.

Reference implementation (site)

A single, commented CSS block in site/build.js, neutralizing :visited on every navigation surface via a semantic token (never a hardcoded value), declared before the :hover/.active rules (at equal specificity, the later selector wins over a visited AND hovered link). The pre-existing piecemeal :visited declarations (.top-nav, .github-btn) are removed in favor of this consolidated block.

Accessibility (WCAG 2.2)

Neutral, even beneficial: removing the :visited distinction doesn't reduce any useful information on navigation (the active/current state is still carried by .active + aria-current). No contrast ratio is degraded — the visited color becomes identical to the already-validated unvisited color. On content links, where :visited can aid orientation, the rule doesn't apply (WCAG 1.4.1 — not conveying information through color alone — is in any case still satisfied by the .active/underline states).

Rejected alternatives

  • Keeping the browser's default :visited state on navigation: a purple tint

inconsistent with the brand, breaks hierarchy — rejected.

  • Limiting the fix to the website only (no system rule): perpetuates the drift in

components and consuming applications — contrary to the explicit "whole system" request.

  • Neutralizing :visited globally on every <a> (including content): deprives

content/archive links of a sometimes-useful orientation cue — too broad, rejected in favor of a "navigation" scope.

Consequences

  • New versioned rule .claude/rules/no-visited-nav.md, applicable to every agent and

every surface (site + components + apps).

  • site/build.js: :visited neutralization consolidated across 6 navigation

surfaces (top-nav, sidebar, toc, footer-links, audit-footer-link, icon buttons), via semantic tokens. Build: 662 defined · 177 referenced · 0 phantom.

  • Future components exposing navigation (agtc-link used in nav, agtc-segmented,

future agtc-tabs) will need to neutralize :visited in their shadow DOM per the same rule.

  • No token added or modified — a purely governance/pattern decision.

Contexte

Au cours du redesign du site, un défaut de pattern a été relevé : les éléments de navigation peuvent hériter de l'état :visited du navigateur (teinte violette, ou dérive de couleur), ce qui casse la cohérence visuelle et la hiérarchie. Un menu, un onglet, une sidebar, une table des matières ou un bouton-icône d'en-tête n'est pas du contenu « lu / non lu » : son apparence ne doit pas dépendre de l'historique de navigation.

Le site neutralisait déjà :visited de façon ponctuelle et dispersée (uniquement .top-nav et .github-btn), tandis que d'autres surfaces de navigation (.sidebar, .toc, .footer-links, .audit-footer-link) ne l'étaient pas. La demande humaine est explicite : en faire une règle de portée système entière, pas seulement une correction locale du site web.

Décision

Adoption d'une règle de gouvernance no-visited-nav (voir .claude/rules/no-visited-nav.md) :

Tout élément de navigation réaligne sa couleur :visited sur l'état non-visité. La règle s'applique au **site, aux composants agtc-* et aux applications consommatrices**.

Périmètre de la règle

✅ Concerné (pas d'état visité)❌ Non concerné (état visité autorisé)
Nav header (+ CTA), sidebar, TOC, onglets, fil d'Ariane, pagination, menus, boutons-icônes header/footer, liens de pied de navigationLiens de contenu dans la prose, listes de résultats/archives où « déjà lu » aide l'utilisateur

Critère de tri : si l'élément sert à se déplacer dans le produit → navigation → pas d'état visité. S'il pointe vers une ressource à lire → état visité autorisé.

Implémentation de référence (site)

Bloc CSS unique et commenté dans site/build.js, neutralisant :visited sur toutes les surfaces de navigation via token sémantique (jamais de valeur en dur), déclaré avant les règles :hover/.active (à spécificité égale, le sélecteur le plus tardif l'emporte sur un lien visité ET survolé). Les déclarations :visited ponctuelles préexistantes (.top-nav, .github-btn) sont supprimées au profit de ce bloc consolidé.

Accessibilité (WCAG 2.2)

Neutre, voire bénéfique : supprimer la distinction :visited ne réduit aucune information utile sur de la navigation (l'état actif/courant reste porté par .active + aria-current). Aucun ratio de contraste n'est dégradé — la couleur visitée devient identique à la couleur non-visitée déjà validée. Sur les liens de contenu, où :visited peut aider l'orientation, la règle ne s'applique pas (WCAG 1.4.1 — ne pas véhiculer l'information par la seule couleur reste de toute façon respecté par les états .active/soulignement).

Alternatives rejetées

  • Garder l'état :visited par défaut du navigateur sur la navigation : teinte violette

incohérente avec la marque, casse la hiérarchie — rejeté.

  • Limiter la correction au seul site web (sans règle système) : reconduit la dérive dans les

composants et les applications consommatrices — contraire à la demande explicite « au système complet ».

  • Neutraliser :visited globalement sur tout <a> (y compris contenu) : prive les liens de

contenu/archives d'un repère d'orientation parfois utile — trop large, rejeté au profit d'un périmètre « navigation ».

Conséquences

  • Nouvelle règle versionnée .claude/rules/no-visited-nav.md, applicable à tout agent et toute

surface (site + composants + apps).

  • site/build.js : neutralisation :visited consolidée sur 6 surfaces de navigation

(top-nav, sidebar, toc, footer-links, audit-footer-link, boutons-icônes), via tokens sémantiques. Build : 662 défini · 177 référencé · 0 fantôme.

  • Les futurs composants exposant de la navigation (agtc-link en usage nav, agtc-segmented, futur

agtc-tabs) devront neutraliser :visited dans leur shadow DOM selon la même règle.

  • Aucun token ajouté ou modifié — décision purement de gouvernance/pattern.
← ADR-046 ADR-048 →