feat(docs): add mkdocs and ci (#114)

docs/index.md

@@ -0,0 +1,31 @@
+# Takopi
+
+Takopi connects agent CLIs to Telegram so you can run, monitor, and reply to long-running tasks from chat.
+It supports multiple runner backends and a pluggable transport layer, with a stable public API for extensions.
+
+## What this site covers
+
+- How to get Takopi running end-to-end
+- Project aliases and worktree-aware workflows
+- The plugin system and stable public API surface
+- Architectural details and behavioral guarantees
+
+## Quick start
+
+```bash
+uv run takopi --help
+```
+
+## Documentation map
+
+- Start here: [User guide](user-guide.md)
+- Projects and worktrees: [Projects](projects.md)
+- Plugin development: [Plugins](plugins.md) and [Public API](public-api.md)
+- System behavior: [Architecture](architecture.md) and [Specification](specification.md)
+- Transport details: [Telegram](transports/telegram.md)
+- Contributor notes: [Developing](developing.md)
+
+## LLM entrypoints
+
+- `/llms.txt` lists the key pages and links to their Markdown mirrors.
+- `/llms-full.txt` contains the full expanded content of those pages.