# Filigree Documentation

Filigree is an agent-native issue tracker. These docs cover everything from first install to internal architecture.

## Getting Started

New to filigree? Start here:

1. **[Getting Started](getting-started.md)** — Install, initialize a project, create your first issue. 5 minutes.

## Reference

Detailed documentation for every interface:

2. **[CLI Reference](cli.md)** — All CLI commands with full parameter tables.
3. **[MCP Server Reference](mcp.md)** — 43 tools for native AI agent interaction via Model Context Protocol.
4. **[Workflow Templates](workflows.md)** — 24 issue types across 9 packs: state machines, transitions, field schemas, and enforcement levels.
5. **[Python API Reference](api-reference.md)** — `FiligreeDB`, `Issue`, `TemplateRegistry` for programmatic use.

## Guides

How to use filigree in practice:

6. **[Agent Integration](agent-integration.md)** — Multi-agent coordination patterns, atomic claiming, session resumption, and audit trails.
7. **[Examples](examples/)** — Runnable scripts for multi-agent coordination, workflow walkthroughs, CLI scripting, and hierarchical planning.

## Internals

For contributors and those interested in how filigree works:

8. **[Architecture](architecture.md)** — Source layout, SQLite schema, and key design decisions.
