# Copilot Instructions for [PROJECT_NAME]

Loaded automatically by GitHub Copilot Chat on every request in this repository.
Keep this file under 150 lines. Detailed guidance belongs in `docs/`.

## What This Project Is

<!-- 3-5 sentences. WHY the project exists, WHAT it does at a high level, key constraints. -->

## Tech Stack

- Language:
- Framework:
- Database:
- Testing:
- CI/CD:

## Build & Test Commands

```bash
# Install
# Dev
# Test (all)
# Test (single)
# Lint
# Type-check
# Build
```

## Architecture

```
project-root/
  src/        # …
  tests/      # …
  docs/       # …
```

See `ARCHITECTURE.md` for the full diagram.

### Key Data Flow

1.
2.
3.

### Domain Concepts

- **Term** — definition
- **Term** — definition

## Conventions

- Naming:
- Error handling:
- Imports:
- State management:

## Testing Conventions

- Location:
- Naming:
- Structure: Arrange-Act-Assert
- Mock strategy:

## Verification Checklist

Before suggesting a change is complete, ensure:

- All affected tests pass.
- Lint reports no new violations.
- Type-check passes.
- New behavior has a corresponding test.

## Common Pitfalls

-
-
-

## When You Need More Context

- `ARCHITECTURE.md` — system layout
- `docs/style.md` — style guide
- `docs/specs/` — feature specs
- `AGENTS.md` — universal agent config