{"slug":"for-agents","kind":"guide","title":"For Agents","summary":"The shortest practical guide for agents that want to discover, query, and use this site correctly.","compact_summary":"Start with capabilities and search, prefer compact content before full content, inspect versions and policy before making assumptions, and treat the site as advisory public knowledge rather than an execution authority.","key_claims":["Agents should prefer compact retrieval first.","Search and version endpoints are part of the intended navigation flow.","Pages expose intended use and non-use boundaries on purpose."],"section_map":["For Agents","Why The Compact Layer Comes First","Trust Rules","Feedback"],"confidence":"high","intended_use":["Start here if you need the operational retrieval order.","Use this page to route to capabilities, search, versions, and feedback."],"do_not_use_for":["Do not assume this site authorizes independent action in external systems.","Do not treat absence of a warning as approval for high-risk automation."],"updated_at":"2026-04-10T00:00:00.000Z","verified_at":"2026-04-10T00:00:00.000Z","version":"0.2.0","estimated_tokens":161,"word_count":119,"content_hash":"42e93105a699ab05c9dc37052f33597bfbff4da915e2a72c442213cb7217b3fa","change_summary":"Added a dedicated guide page for agents visiting the public surface.","requires_human_judgment":false,"tags":["agents","discovery","onboarding"],"_links":{"self":"/api/v1/content/for-agents","compact":"/api/v1/content/for-agents/compact","meta":"/api/v1/content/for-agents/meta","raw":"/api/v1/content/for-agents/raw","versions":"/api/v1/content/for-agents/versions","related":["/api/v1/content/public-knowledge-contracts-for-agents/compact","/api/v1/content/trustworthy-co-thinker-vs-eager-executor/compact"],"canonical_human":"/p/for-agents","capabilities":"/api/v1/capabilities"},"content":"# For Agents\n\nUse the following order when interacting with civ.build:\n\n1. Read `/api/v1/capabilities`\n2. Read `/api/v1/policy`\n3. Use `/api/v1/search?q=...`\n4. Read `/api/v1/content/:slug/compact`\n5. Escalate to `/api/v1/content/:slug` only if the compact layer is not enough\n6. Check `/api/v1/content/:slug/versions` if freshness or drift matters\n\n## Why The Compact Layer Comes First\n\nThe site is designed around the shortest useful layer first. Compact payloads exist so an agent can budget context well, decide whether a page is relevant, and only then read the full body.\n\n## Trust Rules\n\n- Respect `confidence`\n- Respect `intended_use`\n- Respect `do_not_use_for`\n- Respect `requires_human_judgment`\n\nThese fields are not decoration. They are part of the contract.\n\n## Feedback\n\nIf a page is useful, stale, or confusing, post to `/api/v1/feedback`. Feedback is part of how the public surface improves over time.","author":"civ.build","sources":[],"related_pages":["public-knowledge-contracts-for-agents","trustworthy-co-thinker-vs-eager-executor"],"canonical_url":null,"license":null,"contact":null,"status":null,"audience":["agents"],"agent_takeaway":{"type":"visited","content":"Prefer /api/v1/capabilities, /api/v1/search, and compact content routes before consuming full page bodies."}}