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

# Prompthon Agentic Labs Structure

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

This document holds the internal structure and reference notes that support
Prompthon Agentic Labs. It is intentionally separate from the top-level README
so the front door can stay lightweight.

## Current status

* The top-level lab lanes are now scaffolded in the repository.
* Imported reference material is kept outside the published docs surface.
* Audience guides and contributor templates are in place for future content
  work.
* The first public lab article wave is drafted.
* Public contributor guidance now covers articles, radar notes, source
  projects, and curated reference notes.

## What this lab covers

* Agent system fundamentals and terminology
* Reusable agent patterns and workflow mechanisms
* Systems concerns such as context, protocols, evaluation, and reliability
* Ecosystem comparisons across global and Chinese agent tooling
* Story-led case studies for major agent product categories
* Fast-moving radar and publication extensions

## Repository structure

| Path                    | Purpose                                                                                 |
| ----------------------- | --------------------------------------------------------------------------------------- |
| `foundations/`          | Core concepts, terminology, and mental models                                           |
| `patterns/`             | Reusable agent design patterns and mechanisms                                           |
| `systems/`              | Production-minded systems topics such as evaluation and interoperability                |
| `ecosystem/`            | Topic-first comparisons of tools, models, and platforms                                 |
| `case-studies/`         | Story-led examples for major agent archetypes                                           |
| `radar/`                | Fast-moving market and protocol tracking                                                |
| `reading-paths/`        | Audience-first entry points into the lab                                                |
| `publications/`         | Metadata and structure for external reading extensions                                  |
| `contributor-kit/`      | Templates and editorial scaffolding for contributions                                   |
| local reference archive | Imported source material and planning documents kept outside the published docs surface |

Lane-local example projects live only where code is natural in v1:

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

Curated contributor-facing source maps live in
`contributor-kit/reference-notes/`.

## Editorial direction

* Path-first, not chapter-first
* Story-led pages that move from problem to architecture to tradeoffs
* Topic-first ecosystem coverage with explicit global and Chinese lanes
* Repo-native content outside `references/`, with source-aware adaptation

## Reference base and reuse boundary

Reference material should be used for curation and planning, not as publishable
copy or citation scaffolding.

Tutorial-oriented repositories should not be carried forward as public
citations. Prefer official product documentation, framework repositories,
protocol specifications, and runnable solution repositories when a page needs
external sources.

If content is later adapted from any upstream material, attribution and license
constraints must be reviewed before publication.
