# [Project name]

[One paragraph: what this project does, for whom, and what it explicitly does not do.]

## Status

[Current project maturity and which capabilities actually work; label planned work.]

## Quick start

Prerequisites: [runtime/tool versions, without secrets]

Supported development mode: [native / native source with container dependencies / full container, with the actual setup guide when useful]. State required configuration and local data initialization without exposing credentials.

```bash
# Insert commands that have been verified in this repository.
```

## Development

- Run: `[command]`
- Tests: `[command]`
- Lint/typecheck: `[command]`
- Build: `[command]`
- Environment config: `[.env.example or config docs]`

## Repository map

[For a multi-repository product, state this repository's role and link to the actual coordination/project map. Do not duplicate the whole product design here.]

| Path | Owns |
|---|---|
| `src/` | [responsibility] |
| `docs/` | [documentation, if present] |

## Operations and compatibility

[Deployment, supported versions or links as relevant; remove if not applicable.]

## Documentation

[Link to docs/index.md if it exists; otherwise link to the most useful document.]

## Contributing

[How a change is proposed, checked and reviewed; link to AGENTS.md for agents.]