mkdocs.yml

site_name: Agentic AI for Serious Engineers
site_url: https://sunilprakash.com/agentic-ai/
site_description: A practical field guide to building reliable, evaluable, and production-grade agent systems
site_author: Sunil Prakash
repo_url: https://github.com/sunilp/agentic-ai
repo_name: sunilp/agentic-ai
edit_uri: edit/main/docs/

theme:
  name: material
  palette:
    - scheme: default
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    - scheme: slate
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
  logo: assets/images/logo.svg
  favicon: assets/images/favicon.png
  font: false
  custom_dir: docs/overrides
  features:
    - navigation.tabs
    - navigation.sections
    - navigation.top
    - navigation.indexes
    - navigation.path
    - search.suggest
    - search.highlight
    - content.tabs.link
  icon:
    repo: fontawesome/brands/github

plugins:
  - search
  - tags
  - minify:
      minify_html: true
  - git-revision-date-localized:
      enable_creation_date: false
      enabled: false
  - social

markdown_extensions:
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - admonition
  - pymdownx.details
  - attr_list
  - md_in_html
  - tables
  - toc:
      permalink: true
  - meta

nav:
  - Home: index.md
  - Principles: principles.md
  - The Book:
    - book/index.md
    - Foundations:
      - How LLMs Actually Work: book/00a-how-llms-work.md
      - From API Calls to Tool Use: book/00b-api-to-tools.md
      - Your First Agent, No Framework: book/00c-first-agent.md
      - The Same Agent, With a Framework: book/00d-frameworks.md
      - Connecting Your Agent to MCP: book/00e-connecting-to-mcp.md
    - Part I - Building:
      - 1. What "Agentic" Actually Means: book/01-what-agentic-means.md
      - 2. Tools, Context, and the Agent Loop: book/02-tools-context-agent-loop.md
      - 3. Workflow First, Agent Second: book/03-workflow-first-agent-second.md
      - 4. Multi-Agent Systems Without Theater: book/04-multi-agent-without-theater.md
    - Part II - Judging:
      - 5. Human-in-the-Loop as Architecture: book/05-human-in-the-loop.md
      - 6. Evaluating and Hardening Agents: book/06-evaluating-and-hardening.md
      - 7. When Not to Use Agents: book/07-when-not-to-use-agents.md
    - Part III - Operating:
      - 8. Metacognition and Self-Reflection: book/08-metacognition.md
      - 9. Deploying and Scaling: book/09-deployment.md
      - 10. Governance and Auditability: book/10-governance.md
      - 11. Security Deep Dive: book/11-security.md
    - Part IV - Advanced Patterns:
      - 12. Memory Management: book/12-memory-management.md
      - 13. Agent Protocols in Production: book/13-agent-protocols-in-production.md
  - Projects:
    - LLM Explorer: projects/llm-explorer.md
    - Tool-Using Assistant: projects/tool-using-assistant.md
    - Research Agent: projects/research-agent.md
    - Framework Comparison: projects/framework-comparison.md
    - Document Intelligence Agent: projects/doc-intelligence-agent.md
    - Incident Runbook Agent: projects/incident-runbook-agent.md
    - Memory Agent: projects/memory-agent.md
  - Evidence:
    - Baseline Eval Report: proof/baseline-eval-report.md
    - Architecture Comparison: proof/workflow-vs-agent-comparison.md
    - Trace Examples: proof/trace-example.md
    - Failure Case Studies: proof/failure-cases.md
  - Code Reference: code/reference.md
  - Roadmap: roadmap.md

extra:
  analytics:
    provider: google
    property: G-4KDCBS18GZ
  social:
    - icon: fontawesome/solid/house
      link: https://sunilprakash.com
      name: sunilprakash.com
    - icon: fontawesome/brands/github
      link: https://github.com/sunilp/agentic-ai
    - icon: fontawesome/brands/linkedin
      link: https://www.linkedin.com/in/sunilprakash/
  meta:
    - name: "google-site-verification"
      content: ""

extra_css:
  - css/custom.css

copyright: >
  Copyright &copy; 2026 <a href="https://sunilprakash.com">Sunil Prakash</a> --
  Code: MIT | Book: <a href="https://www.amazon.com/dp/B0GVG6848F">Available on Amazon</a>