# OneSpace / Gia — agent entry (vibe coding)

Prefer these URLs over browsing the SPA docs tree.

## Start here
- https://gia.hub8.ai/vibe-coding/AGENTS.md
- https://gia.hub8.ai/vibe-coding/entities-only.md
- https://gia.hub8.ai/docs/apps/vibe-coding

## Machine contracts (entities)
- https://gia.hub8.ai/vibe-coding/entity-designer-catalog.json
- https://gia.hub8.ai/vibe-coding/entity-designer-doc.md
- https://gia.hub8.ai/vibe-coding/apply-contract.md
- https://gia.hub8.ai/vibe-coding/golden-mini.seed.json

## Machine contracts (workflows)
- https://gia.hub8.ai/vibe-coding/workflows.md
- https://gia.hub8.ai/docs/workflows/toolkit-catalog
- https://gia.hub8.ai/docs/api/workflows
- https://gia.hub8.ai/docs/api/tools
- https://gia.hub8.ai/docs/workflows/walkthrough

## Human / product docs (optional)
- https://gia.hub8.ai/docs/apps/entity-designer-doc
- https://gia.hub8.ai/docs/apps/seed-packages
- https://gia.hub8.ai/docs/workflows/overview
- https://gia.hub8.ai/docs/ai/tools
- https://gia.hub8.ai/docs/ai/agents
- https://gia.hub8.ai/docs/api

## Search / SEO
- https://gia.hub8.ai/sitemap.xml
- https://gia.hub8.ai/robots.txt

## Enterprise / trust (hub8.ai)
- https://hub8.ai/trust
- https://hub8.ai/security
- https://gia.hub8.ai/docs/enterprise/trust-and-compliance
- https://gia.hub8.ai/docs/enterprise/deployment

## API
- Cloud GIA_ENDPOINT: https://gia.hub8.ai/api   (NOT https://gia.hub8.ai)
- Local GIA_ENDPOINT: http://127.0.0.1:4000
- Auth: Authorization: Bearer pk_… or JWT (tenant admin for seeds)
- Health: GET {GIA_ENDPOINT}/v1/seeds/health
- Apply:  POST {GIA_ENDPOINT}/v1/seeds/apply
- Workflows: GET {GIA_ENDPOINT}/v1/workflows/configs
- Tools:  GET {GIA_ENDPOINT}/v1/tools/configs?view=minimal
- Swagger: https://gia.hub8.ai/gia/swagger

## Flow (entities)
1. GET /v1/seeds/health
2. GET /v1/entities/metadata (+ search)
3. GET /v1/entities/metadata/relation-graph   (required; expose live links)
4. Start from golden-mini.seed.json (do not invent first schema)
5. --dry-run = local package only (not server validation)
6. POST /v1/seeds/apply only after the human asked (sandbox/dev key)
7. Verify by-name + relation-graph again

## Flow (workflows)
1. GET /v1/seeds/health
2. GET /v1/tools/configs?view=minimal (discover tool configs)
3. GET /v1/entities/metadata (entity names for Spaces calls)
4. Build BPMN XML (see vibe-coding/workflows.md)
5. POST /v1/workflows/configs (upload .bpmn + scripts)
6. POST /v1/workflows/{id}/start
7. GET /v1/workflows/{id}/instances (monitor)