> ## 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.

# Sample Projects

<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>

Starter projects are small, repo-owned code examples attached to the handbook
lanes. They exist to give readers something inspectable after a concept page:
clear files, narrow boundaries, and an obvious next step without claiming to be
production apps.

Use this page as the entrypoint before opening an individual project guide or
GitHub folder.

## Current starter projects

| Lane         | Project guide                                                                                       | Source code                                                                                                                                  | Status    | Focus                                                                                                           |
| ------------ | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------- |
| Patterns     | [Agent Memory Retrieval Starter](/patterns/examples/agent-memory-retrieval-starter)                 | [GitHub folder](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/patterns/examples/agent-memory-retrieval-starter)           | `starter` | active notes, working memory, retrieval inputs, and durable artifacts                                           |
| Patterns     | [Prompt Cache Agent Starter](/patterns/examples/prompt-cache-agent-starter)                         | [GitHub folder](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/patterns/examples/prompt-cache-agent-starter)               | `starter` | stable prompt prefixes, dynamic memory boundaries, cache reads, cache writes, and tiny cost/latency comparisons |
| Systems      | [Weather MCP Server Starter](/systems/examples/weather-mcp-server-starter)                          | [GitHub folder](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/systems/examples/weather-mcp-server-starter)                | `starter` | request validation and protocol-facing tool boundaries                                                          |
| Ecosystem    | [LangGraph Starter](/ecosystem/examples/langgraph-starter)                                          | [GitHub folder](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/ecosystem/examples/langgraph-starter)                       | `starter` | a minimal graph-shaped plan, route, synthesize flow                                                             |
| Case Studies | [Deep Research Agent Starter](/case-studies/examples/deep-research-agent-starter)                   | [GitHub folder](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/case-studies/examples/deep-research-agent-starter)          | `starter` | planning, evidence collection, and citation-aware synthesis                                                     |
| Case Studies | [Customer Support Email Agent Starter](/case-studies/examples/customer-support-email-agent-starter) | [GitHub folder](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/case-studies/examples/customer-support-email-agent-starter) | `starter` | email triage, local policy grounding, and safe reply drafting                                                   |

## How to use these starters

* Start with the related lab page linked from each project index.
* Use [Environment Setup](/reading-paths/environment-setup) before running starter-code
  checks locally.
* Run `python3 scripts/verify_example_projects.py` from the repository root to
  smoke-test the current example code.

## Why they are here

These projects are public starter examples, not hidden internal drafts or
upstream ports. They clarify system shape, code boundaries, and extension
points in this repo's own terms.

They are also intentionally incomplete:

* no sample project in the current repo claims to be a finished production app
* some examples validate core Python behavior without yet wiring a real
  framework, protocol transport, search adapter, or persistence layer
* each project index should say clearly whether the project is `starter`,
  `partial`, or `runnable`

## Where future starters belong

Future starter projects should stay lane-local:

* `patterns/examples/`
* `systems/examples/`
* `ecosystem/examples/`
* `case-studies/examples/`