Distillation

Date: Sep 9, 2026

• 🔴 (09:30) Repository guidance in AGENTS.md states to always load the repo-setup skill before situation skills; skills under .agents/skills/ are generated from the canonical skills/ tree by scripts/sync-skills.mjs.
• 🔴 (09:30) Repository agent pipeline is triage → explore → plan → implement → review → ship; worker is a deprecated alias of implement. Direct New operator chat / Operator guidance: turns skip triage and should be treated as the task.
• 🔴 (09:31) User requires strict API output-mode and binary-safety contracts to always be preserved: sentry api retains rawApiRequest() status text; empty textual non-2xx bodies fall back to HTTP status/request information; JSON mode exposes {status, statusText, body}; binary Uint8Array successes bypass formatters and remain raw; binary errors expose only status/content-type/byte-count summaries and never bytes or JSON coercion; prompts must not block scripted runs or interleave with stdout JSON.
• 🔴 (09:31) applyPatch() in bspatch.ts must always compute SHA-256 inline and return it, with no separate verification step. TRDIFF10 uses a 32-byte header; the control block is decompressed fully with zstdDecompressSync, while diff and extra blocks stream through createZstdStreamReader.
• 🔴 (09:31) buildIssueListCollapse() in src/commands/issue/list.ts must always begin with ['filtered', 'unhandled'], then conditionally add 'lifetime' and 'stats'.
• 🔴 (09:31) In generateProjectStructure() within script/generate-docs-sections.ts, route-directory groups always use the ├── prefix regardless of position because standalone entries always follow groups. Groups and standalones are sorted alphabetically within their respective sections; the last standalone uses └──, other standalones use ├──, and help.ts is added manually before sorting.
• 🔴 (09:31) Upgrade-path gotcha in src/lib/upgrade.ts: getCurlInstallPaths() must guard a stored install path with existsSync(dirname(stored.path)); if stale, fall back to a process.execPath startsWith match against KNOWN_CURL_DIRS (['.local/bin', 'bin', '.sentry/bin']), then default to ~/.sentry/bin. The stored path must remain preferred when valid because reversing the priority breaks npm-to-nightly migration.