# Contracts and Debugging

URL: /chirp/docs/quality/contracts-debugging/
Section: contracts-debugging
Tags: contracts, debugging, htmx, devtools

--------------------------------------------------------------------------------

Use this section when Chirp needs to prove the server-rendered UI is wired correctly before users see it: route contracts, htmx targets, OOB regions, Suspense blocks, SSE payloads, and debug tooling. Shield Debugging Swaps chirp check, DevTools, debug headers, and swap failure modes Diagnose broken htmx, OOB, Suspense, SSE, and boosted navigation updates. File Text Route Directory Contract Reserved files, route metadata, sections, and shell contracts Understand what app.check() validates for filesystem routes and app shells. OOB Registry Fail-loud region validation Register shell regions and catch missing OOB blocks before users see empty swaps.

--------------------------------------------------------------------------------

Metadata:
- Word Count: 94
- Reading Time: 1 minutes