docs: restructure documentation for mkdocs and add material theme

[laceyp99]

Summary

• Update the AGENTS.md to best prompt agents on how to work within this repo.
• Restructure repository documentation from a monolithic README.md into an organized MkDocs site located in docs/ (index.md, getting-started.md, usage.md, audio-and-data.md, development.md).
• Add MkDocs Material configuration (mkdocs.yml) with light/dark palettes, navigation tabs, sticky headers, and theme assets (docs/assets/icon.png).
• Add the docs extra (mkdocs-material>=9.6,<10) to pyproject.toml and update uv.lock.
• Keep README.md focused on quick start, high-level features, and pointers to the MkDocs documentation.
• Add site/ to .gitignore.

Testing

• uv run --locked --extra dev --extra docs ruff format --check . (passed)
• uv run --locked --extra dev --extra docs ruff check . (passed)
• uv run --extra docs mkdocs build (built site successfully)
• uv run --locked --extra dev pytest -q (42 passed, 1 skipped)
• uv build (built sdist and wheel successfully)

[laceyp99]

Update summary

• Add Mermaid flowcharts for loop generation, Stop Waiting behavior, and data-directory precedence.
• Enable Mermaid rendering in the MkDocs Material site through SuperFences.

Testing

• uv run --locked --extra dev ruff format --check . - passed
• uv run --locked --extra dev ruff check . - passed
• uv run --locked --extra dev pytest -q - passed (42 passed, 1 skipped)
• uv build - passed
• uv run --locked --extra docs mkdocs build --strict - passed

[laceyp99]

Looks good to merge! This follows the same structure as conductor-core documentation. Hopefully now this documentation best reflects human and agent use across the repo.