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

# HAI-Co²

> Human-AI Co-Construction: humans and an AI agent co-create a single shared solution in a typed, branchable workspace.

**HAI-Co²** (Human-AI Co-Construction) is a reference implementation of a framework in which a
person and an AI agent **co-create one shared solution**, not a chatbot that answers, but an
equal partner that edits a typed, branchable workspace alongside you.

This site documents the system end to end: what the agent sees on every turn, how the shared
workspace and typed artifacts are wired, how conversations branch like commits, and the
architecture decisions behind it all.

## Get started

<CardGroup cols={3}>
  <Card title="What is HAI-Co²" icon="lightbulb" href="/docs/overview">
    The framework, the four shared surfaces, and how co-construction differs from RLHF and assistance games.
  </Card>

  <Card title="Local installation" icon="download" href="/docs/local-installation">
    Run the full stack on your machine with Docker Compose, then log in to the studio.
  </Card>

  <Card title="Demo walkthrough" icon="play" href="/docs/demo">
    See the studio exercised end to end: charts, preferences, a working document, and a plan.
  </Card>
</CardGroup>

## How it works

<CardGroup cols={2}>
  <Card title="Architecture" icon="sitemap" href="/docs/architecture">
    System topology, data stores, the per-thread tool model, and the decisions behind them.
  </Card>

  <Card title="Agent core logic" icon="robot" href="/docs/agent-core-logic">
    How the agent runs a turn: per-turn context, the ReAct loop, tools, the SSE stream, and artifacts.
  </Card>

  <Card title="Tools" icon="screwdriver-wrench" href="/docs/tools">
    The agent's workspace tools, each documented with its arguments, returns, and the prompt it sees.
  </Card>

  <Card title="Artifacts" icon="chart-line" href="/docs/artifacts">
    The typed-artifact pattern and the produce, persist, stream, render lifecycle of the centre panel.
  </Card>

  <Card title="Conversation branching" icon="code-branch" href="/docs/conversation-branching">
    The turn-as-commit model: fork any past turn into a new thread; restore without destroying history.
  </Card>

  <Card title="Tracing & data collection" icon="magnifying-glass-chart" href="/docs/observability">
    Phoenix tracing plus the replayable first-party dataset HAICO records for every co-construction.
  </Card>
</CardGroup>

## Reference

<CardGroup cols={3}>
  <Card title="Features" icon="list-check" href="/docs/features">
    The end-to-end catalogue of the Co-Construction Studio's capabilities.
  </Card>

  <Card title="Decision records" icon="scale-balanced" href="/docs/adr/index">
    The architecture decision records: the *why* behind the structure.
  </Card>

  <Card title="API reference" icon="code" href="/docs/api-reference">
    Drive the whole loop over HTTP: auth, the endpoint groups, and the generated endpoint reference.
  </Card>
</CardGroup>

## Try it

The live application runs at [haico.gr](https://haico.gr). To run it yourself, start with
[Local installation](/docs/local-installation); to see it exercised end to end, follow the
[demo walkthrough](/docs/demo).