# {{ name }}

{{ description }}

[![CI](https://github.com/{{ github_owner }}/{{ name }}/actions/workflows/ci.yml/badge.svg)](https://github.com/{{ github_owner }}/{{ name }}/actions/workflows/ci.yml)
[![License: {{ license }}](https://img.shields.io/badge/license-{{ license }}-blue.svg)](LICENSE)

## Why?

{% if why_bullets %}{% for b in why_bullets %}- {{ b }}
{% endfor %}{% else %}- _Add 3–5 concrete value propositions here._
- _Each bullet should describe a tangible benefit, not a feature._
- _Aim for the reader to know in 30 seconds whether this is for them._
{% endif %}

## Prerequisites

- _List runtime and dev dependencies with explicit version bounds._

## Install

```sh
# end-to-end install command goes here
```

## Quick start

```sh
# minimal runnable example
```

## Usage

_Reference surface — commands, flags, API entry points._

## Configuration

_Config file paths and key names._

## Examples

See [`examples/`](examples/) for runnable demos.

## Troubleshooting

_Common failure modes and fixes._

## Documentation

- [Getting started](docs/getting-started.md)
- [Configuration](docs/configuration.md)
- [Architecture](docs/architecture.md)
- [Troubleshooting](docs/troubleshooting.md)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

Licensed under [{{ license }}](LICENSE).
