# Docs Index

> [!CAUTION]
> **EXPERIMENTAL - LABS PROJECT**
>
> This package is not production-ready. No stability guarantees, no support, no warranty. See `../README.md` for the full disclaimer.

Use this page as the entry point for the documentation set.

## Read This First

| If you need... | Start here |
|---|---|
| Install, package overview, and top-level architecture | [`../README.md`](../README.md) |
| A first-run walkthrough | [`getting-started.md`](getting-started.md) |
| Example prompts and outcomes | [`use-cases.md`](use-cases.md) |
| Which agent or skill to use | [`agents-and-skills-guide.md`](agents-and-skills-guide.md) |
| Who owns a capability and where the canonical low-level guidance lives | [`capability-map.md`](capability-map.md) |
| Full lifecycle protocol, gates, and handoffs | [`dev-workflow.md`](dev-workflow.md) |
| Deep architecture and operational reference | [`fluent-ai-skills-reference.md`](fluent-ai-skills-reference.md) |

## Canonical Docs

| Document | Responsibility |
|---|---|
| [`../README.md`](../README.md) | Package landing page and installation entry point |
| [`getting-started.md`](getting-started.md) | New-user walkthrough |
| [`use-cases.md`](use-cases.md) | Scenario and prompt catalog |
| [`agents-and-skills-guide.md`](agents-and-skills-guide.md) | Canonical routing, invocation, and SDLC fit |
| [`capability-map.md`](capability-map.md) | Capability ownership backstop (includes CLI coverage matrix) |
| [`dev-workflow.md`](dev-workflow.md) | Lifecycle execution protocol and approval gates |
| [`deployment-promotion-runbook.md`](deployment-promotion-runbook.md) | Deployment, promotion, rollback, and `flow-run` command reference |
| [`mcp-servers.md`](mcp-servers.md) | MCP server setup matrix (includes optional hosting providers) |
| [`chrome-devtools-mcp-reference.md`](chrome-devtools-mcp-reference.md) | Browser automation reference |
| [`workflow-reference.md`](workflow-reference.md) | Workflow and user-action edge-case reference |
| [`manifest-safety.md`](manifest-safety.md) | Manifest write-safety guardrails |

## Current Maintenance Direction

- Prefer one doc per question, not multiple docs answering the same question.
- Keep routing and invocation guidance in `agents-and-skills-guide.md`.
- Keep ownership and “source of truth” decisions in `capability-map.md`.
- Keep lifecycle gates and orchestration rules in `dev-workflow.md`.
- Avoid hardcoding inventory counts unless they are actively maintained from `metadata.json`.
