> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Systems Handbook by Prompthon

> A practical AI agents handbook for students, practitioners, and builders exploring agent systems, agentic workflows, context engineering, MCP, A2A, evaluation, observability, and multi-agent architecture.

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">Need help?</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>Ask in Discord</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>Open a GitHub issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>Support guide</span>
    </a>
  </div>
</div>

AI-agent demos are easy to find. Production-ready agent systems are harder to understand. This handbook maps the workflows, tools, memory systems, context engineering, MCP/A2A interoperability, evaluation, observability, and multi-agent architecture behind real-world AI agents.

Use it to understand, design, build, and operate production-minded AI agents from first principles to framework choices and implementation patterns.

<img className="not-prose my-8 w-full" src="https://mintcdn.com/agentizeai/XG69eHTnu_JYWY5H/assets/agentic-ai-blueprint.png?fit=max&auto=format&n=XG69eHTnu_JYWY5H&q=85&s=4f4b100ca5c285dd75f585cdc2ea2740" alt="Blueprint-style agentic AI system map showing core agent loop concepts" width="1600" height="1067" data-path="assets/agentic-ai-blueprint.png" />

<div className="not-prose mt-5 mb-8 flex flex-wrap gap-3">
  <a className="inline-flex items-center gap-2 rounded-md bg-primary px-4 py-2 text-sm font-medium text-white no-underline" href="https://github.com/Prompthon-IO/agent-systems-handbook" target="_blank" rel="noreferrer">
    <Icon icon="star" size={16} color="#ffffff" />

    <span>Star</span>
  </a>

  <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 px-4 py-2 text-sm font-medium no-underline dark:border-gray-800" href="https://github.com/Prompthon-IO/agent-systems-handbook/subscription" target="_blank" rel="noreferrer">
    <Icon icon="bell" size={16} />

    <span>Watch updates</span>
  </a>

  <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 px-4 py-2 text-sm font-medium no-underline dark:border-gray-800" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/CONTRIBUTING.md" target="_blank" rel="noreferrer">
    <Icon icon="code-pull-request" size={16} />

    <span>Contribute</span>
  </a>

  <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 px-4 py-2 text-sm font-medium no-underline dark:border-gray-800" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
    <Icon icon="discord" iconType="brands" size={16} />

    <span>Discord</span>
  </a>
</div>

<CardGroup cols={2}>
  <Card title="Explorer" icon="compass" href="/reading-paths/explorer">
    Build a broad view of AI, agent systems, trends, and foundational ideas without needing to become an engineer first.
  </Card>

  <Card title="Practitioner" icon="wand-magic-sparkles" href="/reading-paths/practitioner">
    Learn how to apply AI tools, agents, and workflows to study, work, and one-person-company style execution.
  </Card>

  <Card title="Builder" icon="code" href="/reading-paths/builder">
    Follow a technical path through concepts, patterns, systems, architecture choices, and starter projects.
  </Card>

  <Card title="Contributor" icon="code-pull-request" href="/reading-paths/contributor">
    Add, revise, curate, or maintain handbook pages, radar notes, source projects, and reference notes.
  </Card>
</CardGroup>

## What This Site Publishes

The site publishes the curated handbook pages and starter-project guide pages. Source code, notebooks, and embedded frontend/build artifacts remain in the repository, where students can inspect or clone them directly.

<Note>
  This keeps the student reading experience focused while preserving the full project archive for GitHub, local work, and future curated demos.
</Note>