Gildea uses progressive disclosure to keep responses efficient by default while allowing you to request more detail when needed.Documentation Index
Fetch the complete documentation index at: https://docs.gildea.ai/llms.txt
Use this file to discover all available pages before exploring further.
Three levels of detail
Level 1: Signal card (list endpoints)
The lightest view — metadata and a text preview:decomposition_text (thesis or summary text), themes, entities, and verified_text_unit_count. No individual text units.
Level 2: Full decomposition (detail endpoint)
The complete verified breakdown with all text units:Level 3: With evidence (include=evidence)
Full decomposition plus source evidence snippets:Verification detail
Orthogonal to the include parameter,verification_detail controls how much verification metadata is returned:
| Value | Verification fields |
|---|---|
| (default) | verdict, path, human_reviewed, scoring_mode, primary_score |
full | + scoring_method, components_ran, all scores, thresholds, reason_codes |
Why progressive disclosure?
- Bandwidth — signal cards are ~500 bytes; full decomposition with evidence can be 10KB+
- Cost — fewer bytes transferred = faster responses
- Clarity — most use cases only need the signal card for browsing