"Build Your First Agent" getting started tutorial

[artugro]

Context

There's no guided tutorial for new users. The README gives an overview but doesn't walk someone through the full experience. A step-by-step tutorial is the most effective onboarding tool for open source projects.

Proposed: docs/GETTING_STARTED.md

Tutorial Flow

1. Start Intuno locally — docker-compose up + make dev
2. Create an account — register via auth API, get JWT token
3. Build a simple agent — minimal FastAPI app with a /invoke endpoint
4. Register it with Intuno — POST /registry/agents with name, description, endpoint, input schema
5. Discover it — POST /registry/discover with a natural language query, verify semantic search finds it
6. Invoke it through the broker — POST /broker/invoke and see the response + audit log
7. Try MCP — connect Claude Desktop or Cursor to Intuno's MCP endpoint, discover and invoke the agent
8. Create a multi-agent task — POST /tasks with a goal, watch the orchestrator plan and execute
9. Next steps — links to API docs, example agents, deployment guide

Requirements

• Should be completable in under 30 minutes
• All commands should be copy-pasteable
• Include expected output/responses at each step