# TinyFlags — Hex (Elixir)

The Hex port of TinyFlags. Built with `mix`; ExUnit covers defaults, rollout
boundaries, and variant validation. Behavior, validation, and test-coverage
requirements are shared across every ecosystem — see [`../lib-spec.md`](../lib-spec.md).

## Package-native AXM recommendation

Hex packages recommend extensions via an `axm.json` sidecar at the package
root, included in the published tarball through `:package` `:files` in
`mix.exs`:

```json
{
  "$schema": "https://axm.sh/schemas/axm-package-meta.schema.json",
  "recommendedExtensions": ["@examples/packs/elixir-hex-tinyflags@^0.1.0"]
}
```

`axm discover` reads this from `deps/agentxm_example_tinyflags/axm.json` in any
consumer project after `mix deps.get`.

## Commands

```bash
mix deps.get
mix compile
mix test
```

## Companion extensions

Sources live under [`.axm/extensions/@examples/`](.axm/extensions/@examples/)
and are marked authored in `.axm/settings.json`. The pack bundles the three
skills and the maintainer subagent.

| Type     | FQN                                                    | Homepage                                                                |
| -------- | ------------------------------------------------------ | ----------------------------------------------------------------------- |
| Skill    | `@examples/skills/elixir-hex-tinyflags-add-flag`       | https://agentxm.ai/@examples/skills/elixir-hex-tinyflags-add-flag       |
| Skill    | `@examples/skills/elixir-hex-tinyflags-rollout-review` | https://agentxm.ai/@examples/skills/elixir-hex-tinyflags-rollout-review |
| Skill    | `@examples/skills/elixir-hex-tinyflags-cleanup-flag`   | https://agentxm.ai/@examples/skills/elixir-hex-tinyflags-cleanup-flag   |
| Subagent | `@examples/subagents/elixir-hex-tinyflags-maintainer`  | https://agentxm.ai/@examples/subagents/elixir-hex-tinyflags-maintainer  |
| Pack     | `@examples/packs/elixir-hex-tinyflags`                 | https://agentxm.ai/@examples/packs/elixir-hex-tinyflags                 |

Each manifest declares `pkg:hex/agentxm_example_tinyflags` as a companion
package.

## Paired consumer

[`../elixir-hex-app/`](../elixir-hex-app/) — the `pawmatch` CLI that consumes
this library through realistic flag seams.