From 48923db3d08bdaf079667a5aa4b96811268b5268 Mon Sep 17 00:00:00 2001 From: Kpa-clawbot Date: Fri, 3 Apr 2026 13:01:31 -0700 Subject: [PATCH] Add deep linking rule to AGENTS.md (#535) Adds a rule to AGENTS.md requiring all new UI states to be URL-addressable (deep-linkable). Part of #536. Co-authored-by: you --- AGENTS.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 90296b57..c50c7a69 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -362,6 +362,12 @@ One logical change per commit. Each commit is deployable. Each commit has its te - Tests: `test-{feature}.js` in repo root - No build step, no transpilation — write ES2020 for server, ES5/6 for frontend (broad browser support) +### Deep Linking +All new UI states that a user might want to share or bookmark MUST be reflected in the URL hash. +This includes: tabs, filters, selected items, view modes. Use query parameters on the hash +(e.g., `#/packets?observer=ABC&timeRange=24h`) for filter state. +Existing patterns: `#/nodes/{pubkey}?section=node-neighbors`, `#/analytics?tab=collisions`, `#/packets/{hash}`. + ## What NOT to Do - **Don't check in private information** — no names, API keys, tokens, passwords, IP addresses, personal data, or any identifying information. This is a PUBLIC repo. - Don't add npm dependencies without asking