#architecture 6 articles

• A global kill-switch must not block the operation that fixes itgotchas / spfxThe lock defends itself against being lifted; infrastructure operations (version pin, re-check, config, diagnostics) belong outside it
• Markdown vs DOCX vs site pages: choosing a knowledge format for RAG on SharePointguidesMarkdown vs DOCX vs site pages vs list items — extraction quality, token economics, and the author-here-publish-Markdown pattern
• SharePoint REST vs Microsoft Graph — which API for which jobguidesA decision table by capability, the SPFx auth difference, common wrong picks, and throttling budgets
• Silent catch-to-empty fallbacks + destructive writes = data lossgotchas / rest-apicatch → [] + delete-then-insert = data loss; strict and safe reads (+ a settings read that hides its failure lets a full-object save overwrite the config with defaults)
• Tenant-wide enumeration in Graph is app-only — check Delegated vs Application before you buildgotchas / graphgetAllSites rejects delegated tokens; check the Permissions table first
• What each format costs the model: tokens for the same content as .md, .docx, .pdf and a SharePoint pageguidesReal numbers: the same article as .md/.docx/.pdf/a SharePoint page — why extraction, not format, drives the token bill; plus a CZ-vs-EN language tax and a reproducible harness