---
title: "Guides"
type: index
id: "guides"
description: "Practical guides, model-selection playbooks, agent recipes, and methodology notes for humans and AI agents."
last_updated: "2026-04-24"
---
# Guides
Practical guides, model-selection playbooks, agent recipes, and methodology notes. Each guide is structured with YAML metadata and available via the [raw markdown index](/content/guides/_index.md) for agent consumption.
## Agent and Model Selection
| Guide | Level | Description |
|-------|-------|-------------|
| [Agent Usage Guide](agent-usage.md) | Agent | Concrete fetch patterns for discovery, raw markdown, schema, per-item JSON, recommendations, changes, and hashes |
| [Choose a Coding Model](choose-a-coding-model.md) | Decision Playbook | Choose models for software engineering, code review, refactoring, and coding-agent workflows |
| [Choose a Research Model](choose-a-research-model.md) | Decision Playbook | Choose models for research, synthesis, long-document analysis, and evidence review |
| [Choose a Local Model](choose-a-local-model.md) | Decision Playbook | Choose open-weight or local models for private, offline, or self-hosted workflows |
| [Choose a Cheap Model](choose-a-cheap-model.md) | Decision Playbook | Minimize cost without losing acceptable quality or reliability |
| [Choose a Private Model](choose-a-private-model.md) | Decision Playbook | Choose deployment patterns for privacy, compliance, and sensitive data |
| [Best-For Task Matrix](best-for-task-matrix.md) | Matrix | Map common AI tasks to best, cheap, local, and cautionary options |
| [Agent Tooling Compatibility](agent-tooling-compatibility.md) | Matrix | Compare coding agents, dev frameworks, orchestration tools, and no-code agents |
| [Data Methodology](data-methodology.md) | Methodology | How sources, verification, scores, pricing freshness, sponsorship, and agent-safe interpretation work |
| [Benchmark Methodology](benchmark-methodology.md) | Methodology | Interpret model scores, confidence, verification, and task fit |
| [AI Failure Modes](failure-modes.md) | Risk Guide | Negative guidance for models, local deployment, cheap models, and agent autonomy |
## Recipes
| Guide | Level | Description |
|-------|-------|-------------|
| [Build a Coding Agent Stack](build-a-coding-agent-stack.md) | Recipe | Build a coding-agent workflow with repo access, tests, review, and rollback |
| [Build an Agent-Readable Docs Site](build-an-agent-readable-docs-site.md) | Recipe | Make documentation readable by AI agents with markdown, discovery, schema, feeds, and hashes |
| [Choose a Model for Customer Support](choose-model-for-customer-support.md) | Recipe | Choose models and guardrails for support automation, routing, drafting, retrieval, and escalation |
| [Build an AI Research Assistant](build-an-ai-research-assistant.md) | Recipe | Build a research assistant that preserves sources, uncertainty, and evidence |
| [Use Local Models for Private Documents](local-models-for-private-documents.md) | Recipe | Use local/private models with sensitive documents, retrieval, access control, and logging |
## Foundations
| Guide | Level | Description |
|-------|-------|-------------|
| [What Is AI? A Complete Beginner's Guide](getting-started.md) | Beginner | What AI is, how it works, and how to start using it today |
| [Prompt Engineering Guide](prompting.md) | Beginner to Advanced | How to write prompts that get you exactly what you need from AI |
Guides
Practical guides, model-selection playbooks, agent recipes, and methodology notes. Each guide is structured with YAML metadata and available via the raw markdown index for agent consumption.
Agent and Model Selection
| Guide |
Level |
Description |
| Agent Usage Guide |
Agent |
Concrete fetch patterns for discovery, raw markdown, schema, per-item JSON, recommendations, changes, and hashes |
| Choose a Coding Model |
Decision Playbook |
Choose models for software engineering, code review, refactoring, and coding-agent workflows |
| Choose a Research Model |
Decision Playbook |
Choose models for research, synthesis, long-document analysis, and evidence review |
| Choose a Local Model |
Decision Playbook |
Choose open-weight or local models for private, offline, or self-hosted workflows |
| Choose a Cheap Model |
Decision Playbook |
Minimize cost without losing acceptable quality or reliability |
| Choose a Private Model |
Decision Playbook |
Choose deployment patterns for privacy, compliance, and sensitive data |
| Best-For Task Matrix |
Matrix |
Map common AI tasks to best, cheap, local, and cautionary options |
| Agent Tooling Compatibility |
Matrix |
Compare coding agents, dev frameworks, orchestration tools, and no-code agents |
| Data Methodology |
Methodology |
How sources, verification, scores, pricing freshness, sponsorship, and agent-safe interpretation work |
| Benchmark Methodology |
Methodology |
Interpret model scores, confidence, verification, and task fit |
| AI Failure Modes |
Risk Guide |
Negative guidance for models, local deployment, cheap models, and agent autonomy |
Recipes
| Guide |
Level |
Description |
| Build a Coding Agent Stack |
Recipe |
Build a coding-agent workflow with repo access, tests, review, and rollback |
| Build an Agent-Readable Docs Site |
Recipe |
Make documentation readable by AI agents with markdown, discovery, schema, feeds, and hashes |
| Choose a Model for Customer Support |
Recipe |
Choose models and guardrails for support automation, routing, drafting, retrieval, and escalation |
| Build an AI Research Assistant |
Recipe |
Build a research assistant that preserves sources, uncertainty, and evidence |
| Use Local Models for Private Documents |
Recipe |
Use local/private models with sensitive documents, retrieval, access control, and logging |
Foundations