# Architecture

## Code Layout

```
main.go              — entrypoint, calls cmd.Execute()
cmd/                  — cobra commands (root + subcommands)
internal/             — private application packages
docs/                 — project documentation
```

## Packages

| Package | Purpose | Status |
|---------|---------|--------|
| `cmd` | CLI command definitions | ✅ skeleton |
| `internal/config` | Configuration loading and parsing | ⬜ planned |
| `internal/controllers` | HTTP request handlers | ⬜ planned |
| `internal/auth` | Authentication (JWT) | ⬜ planned |
| `internal/storage` | File storage abstraction | ⬜ planned |

Add new rows as packages are created.