> ## Documentation Index
> Fetch the complete documentation index at: https://dev.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

> **[What is HAI-Co²](/docs/overview.md)**
>
> The framework, the four shared surfaces, and how co-construction differs from RLHF and assistance games.

> **[Local installation](/docs/local-installation.md)**
>
> Run the full stack on your machine with Docker Compose, then log in to the studio.

> **[Demo walkthrough](/docs/demo.md)**
>
> See the studio exercised end to end: charts, preferences, a working document, and a plan.

## How it works

> **[Architecture](/docs/architecture.md)**
>
> System topology, data stores, the per-thread tool model, and the decisions behind them.

> **[Agent core logic](/docs/agent-core-logic.md)**
>
> How the agent runs a turn: per-turn context, the ReAct loop, tools, the SSE stream, and artifacts.

> **[Tools](/docs/tools.md)**
>
> The agent's workspace tools, each documented with its arguments, returns, and the prompt it sees.

> **[Artifacts](/docs/artifacts.md)**
>
> The typed-artifact pattern and the produce, persist, stream, render lifecycle of the centre panel.

> **[Conversation branching](/docs/conversation-branching.md)**
>
> The turn-as-commit model: fork any past turn into a new thread; restore without destroying history.

> **[Tracing & data collection](/docs/observability.md)**
>
> Phoenix tracing plus the replayable first-party dataset HAICO records for every co-construction.

## Reference

> **[Features](/docs/features.md)**
>
> The end-to-end catalogue of the Co-Construction Studio's capabilities.

> **[Decision records](/docs/adr/index.md)**
>
> The architecture decision records: the *why* behind the structure.

> **[API reference](/docs/api-reference.md)**
>
> Drive the whole loop over HTTP: auth, the endpoint groups, and the generated endpoint reference.

## Try it

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.