Documentation Index
Each topic has one owning document. Other files link here instead of repeating the content.
Understand the System
| Document | Covers |
| architecture.md | Principles, modules (current vs. target), execution pipeline, AI integration, planned protocol |
| roadmap.md | Delivery status by phase and next priorities |
| benchmarks/flow_format.md | Benchmark: local AI models writing flows in flow.md vs YAML, and why Kinenix keeps flow.md |
| design/phase-2.md | Phase 2 design: On Error and Finally, subflow context, run records for AI questions, Hub tables and views, redaction (proposal) |
Build Flows
Run and Operate
| Document | Covers |
| quickstart.md | Install, create a project with kinenix init, run it, and connect a worker to the Hub in about ten minutes |
| cli_guide.md | kinenix commands and options |
| hub.md | Running the Hub, environment variables, worker authentication, querying runs (kinenix hub query), user views |
| hub_data.md | Hub data dictionary: tables, views, run reports, and example queries, for people and AI |
| logging.md | Execution log layout and JSON format |
| ask_router.md | Natural-language questions to the Hub (work in progress) |
| ../kinenix-worker/README.md | Worker CLI and Raspberry Pi setup |
| ../CHANGELOG.md | Changes and upgrade notes of each release |
| releasing.md | Publishing kinenix, kinenix-hub, and kinenix-worker to PyPI with Trusted Publishing |
| ../kinenix-studio/README.md | Studio design and layout |
Contribute
| Document | Covers |
| ../AGENTS.md | Entry point for AI assistants: commands, rules index, current vs. target state |
| ../.agents/rules/ | Engineering rules: coding, testing, security, errors, logging, git |
Machine-readable schemas: ../schemas/flow.schema.json, ../schemas/execution_log.schema.json.