# ProfileClaw public discovery surface

## Localized entrypoints
- /zh
- /en

## Human-facing docs surfaces
- /docs
- /docs/quickstart
- /docs/api
- /docs/agents
- /docs/guides
- /docs/integrations
- /reference

## Machine-facing contract surfaces
- /.well-known/openapi.json
- /llms.txt

## Guidance for agents and tools
- Start with `/docs` for routing and mental models.
- Use `/docs/quickstart` for the first successful integration path.
- Use `/docs/api` to browse endpoints by job.
- Use `/reference` for precise contract inspection.
- Use `/.well-known/openapi.json` for code generation, schema inspection, and automated tooling.
- Treat `/api/v1/context` as the default public API entrypoint unless the task clearly requires a narrower endpoint.