Triggers — keyword → learn-doc routing

This is the routing table for the reference annex. When Sush mentions a topic or you're about to do work in an area, this file tells you which learn-doc(s) to read on demand.

Why a separate file: Carrying this table inside copilot-instructions.md made the always-loaded soul file fatter every time a new playbook shipped. Externalising it means new playbooks don't tax every session's context window. (Borrowed from obsidian-memory-for-ai v3.1 — see memory-system-evolution.md for the full evaluation.)

How to use: - Sush says a keyword (left column) → you read the file(s) (right column) before acting. - If multiple keywords match, read all matching files in parallel. - If no keyword matches but you suspect depth exists, scan index.md for the topic.

Topic routing

Keyword / trigger	Read these files	Why
Cosmos, Atlas, cosmos-atlas, planet metaphor, new planet, planet pivot	cosmos-philosophy.md, cosmos-nav-playbook.md, cosmos-config-manifest.md, cosmos-audit.md, cosmos-intelligence-playbook.md	The metaphor governs the whole universe; nav playbook governs the cross-planet rail
shift, Shift Pulse	shift-playbook.md	Three Dials framework, deploy gotchas, audit personas
Plain AI, plainai, for people like us	plain-ai-playbook.md, plus ~/.copilot/plain-ai-voice-guardrail.md if content edit	Content model, voice rules, cache trap, wrangler workaround
Plain AI Curriculum, /learn/, lesson JSON, course schema	~/.copilot/plain-ai-curriculum-philosophy.md	Constitution, Permanent NO list, value test
agentic, agents.aguidetocloud.com, AI agents tools	agentic-planet-playbook.md	14-pillar IA, iteration history, gotchas
Claw, OpenClaw, claw.aguidetocloud.com	claw-planet-playbook.md, claw-v0b-followups-prompt.md	Multi-vendor scope, 10-§ IA, voice guardrails
Brain Bar, brain bar lessons	brain-bar-lessons.md	Decision logs from the Brain Bar
New planet OR scope expansion of an existing one	planet-pivot-playbook.md	Meta-playbook: 6 patterns, anti-patterns, full file map
blog, notebook layout, blog SEO	blog-notebook-system.md, blog-notebook-followups-prompt.md	Field-notebook architecture, shortcodes, handwritten-over-emoji rule
voice, tone, brag-allergy, writing as Sush	voice-and-tone.md	Phrasing fingerprints, voice library, creative-juice pattern
Zen, design system, tokens, light/dark	zen-system-quickref.md	Tokens, parity-file map, CSS-var mapping
deploy, push, build, cache_version, pre-push	deployment-playbook.md, parallel-git-rules.md	20-step pre-push checklist, parallel-safe git rules
Hugo build issues, lock-file, dev server	hugo-build.md	Why pwsh hugo-safe.ps1 is mandatory, lock-file recovery
New free tool integration	tool-integration-checklist.md	12 mandatory touch points
Production incident, regression, "what broke last time"	incident-log.md	Every customer-facing bug + the guardrail it spawned
Site cleanup, audit log, redirects	site-audit-2026-05.md	What's deleted, what's kept-but-redundant, Cloudflare _redirects gotcha
Layer 1/2 redesign work, OG/SEO push, practice page paid-loop	may-2026-zen-shipping.md	Full chronological log of the Zen redesign campaign
LinkedIn post draft (customer-session or T3 moment only)	linkedin-advisor-playbook.md	3-hook formula, posted log, 90-day dedupe
MSFT internal scouting, mcaps repos, internal MCPs	msft-gold-explore-queue.md	44+ catalogued internal MCPs, pending queue items
PAC (Personal Atlas Cockpit), v0.2.x architecture	pac-architecture.md	Electron+Vite+React stack, WorkIQ MCP wiring, layout invariants
atlas-portfolio, the C360 / Copilot pipeline / Lynx dashboard	architecture-and-data-first-playbook.md (case study), plus C:\ssClawy\atlas-portfolio\BUILD-LOG.md (full phase log)	The shipped tool + the playbook of what made it work
atlas-portfolio scrape · lynx refresh · weekly refresh · refresh-full · refresh-qa · pipeline health · which scraper for X · where does X data come from	atlas-portfolio-data-pipeline.md	Source-of-truth map, execution DAG, QA sentinel checks, weekly tracker template, failure-mode catalogue. READ BEFORE any scrape work.
HELM design, bento, mosaic, card shape, today tab redesign, typography (IBM Plex), --sans swap, grid-template-areas, story-shape, sticky hero, freshness ink, growable cards, sparklines, hover halos, pinned cards, quiet-day, "make it feel better", "polish HELM", "card looks wrong", "tab is too busy", "feels cluttered"	atlas-helm-design-philosophy.md	🎨 THE LIVING CONSTITUTION. Read before ANY HELM visual-surface change. Bento mosaic principle · story-shape map · IBM Plex Sans typography plan · amber/cyan discipline · Path A grid-template-areas · 8 better-than-asked queued moves. Doc is fluid — you may EDIT it as the philosophy evolves; bump the change log. Phase 200 series in ~/.copilot/atlas-portfolio-phases.md carries the execution plan.
Memory system itself — soul file, journal, learn-docs, tiers	memory-system-architecture.md, memory-system-evolution.md	6-tier map; evaluation of borrowed patterns and the why
Connect / performance review prep	C:\ssClawy\connect-tracking\framework.md, rolling-journal.md	10 buckets, cycle archive process
M365, email client, MSAL, Graph auth, admin consent, Clawpilot config, shell-first, embedded browser, Path C, /me scopes	m365-clawpilot-playbook.md	The Issy intel: auth recipe with /me-level scopes, MCP config, skills pattern, Direct Graph vs WorkIQ routing, the Path C Helm + Clawpilot connector. Read first if asked to wire M365 (email / chat / calendar) into anything OR before building a new chat-driven app. Set 27 May 2026.

Implicit triggers (no keyword, fires by action)

When you are about to…	Read this first
Touch a practice exam file (PracticeQuiz.tsx, question JSON, practice.astro, build pipeline)	Practice Exam SLA section of copilot-instructions.md + incident-log.md
git push from a C:\ssClawy\* repo touching practice exam files	Run node test-guided-qa.cjs first
git push from cosmos-atlas touching cosmos.ts/css/atlas.json/PlanetIcon.astro/index.astro	Run node scripts/qa-audit.mjs first
Touch nav, footer, fonts, tokens, theme toggle, or shared chrome	Apply to BOTH Hugo and Astro in the same commit (Zen "One Body, Two Organs")
Touch aguidetocloud.com styling	zen-system-quickref.md guardrails (no hardcoded colours, no backdrop-filter, etc.)
Reply / send / forward email, Teams, calendar change	🚨 #2 RULE in copilot-instructions.md — never without explicit one-time bypass
Send an autonomous internal email or Teams message after bypass	🚨 #3 RULE in copilot-instructions.md — Atlas signature footer mandatory
Add content under plainai/content/	~/.copilot/plain-ai-voice-guardrail.md four voice tests
Add content under Plain AI Curriculum (/learn/)	~/.copilot/plain-ai-curriculum-philosophy.md value test + Wikipedia test
Stash/branch work to set it aside	parallel-git-rules.md § Stash Discipline — push WIP to remote, never local-only
Starting a new tool, dashboard, report, or scrape-driven build	architecture-and-data-first-playbook.md — Rules #5 + #6 case study + 12-step checklist. Use the checklist literally.
Iterating on a feature for the 3rd+ time without it landing	architecture-and-data-first-playbook.md — almost certainly a Rule #5 violation. Stop, surface alternatives.
About to write a loader / renderer against an "assumed" data shape	architecture-and-data-first-playbook.md § The probe-script pattern. Write the probe first.
Touching ANY HELM visual surface (today-tab.js · overview · customer cards · scout cards · theme.css · render.js HTML scaffolding · per-account pages · or about to ship a Phase 200+ row)	atlas-helm-design-philosophy.md — read FIRST. Story-shape mapping, typography target, amber discipline, Path A grid pattern. Doc is fluid; if your work surfaces a new principle, EDIT the doc and bump the change log.

How to update this file

• Adding a new playbook? Add a row here AND a row in index.md AND nothing in copilot-instructions.md unless the playbook earns a soul-file-level rule (see Promote-on-2+-Occurrences rule in the soul file).
• If a soul-file section is mostly a pointer like "Full playbook: …", that pointer should move here instead. Soul file should carry rules, not directions.
• Last reviewed: 22 May 2026.