# Features

## v0.1.0 (2026-05-10)

### Universals (afi-template)

- `agtag --version`
- `agtag learn` — self-teaching prompt for agent consumers; supports
  `--json`.
- `agtag explain <path>` — markdown documentation for any noun/verb path;
  supports `--json`.
- Structured errors: every failure emits `{code, message, remediation}`
  (text or JSON).
- Exit-code policy: `0` success, `1` user-input error, `2`
  environment/setup error.

### `issue` noun group

- `agtag issue post --repo OWNER/REPO --title T (--body B | --body-file
  F)` — open a new issue.
- `agtag issue fetch (--repo … --number … | <url>)` — read an issue body
  and its comments.
- `agtag issue reply --repo OWNER/REPO --number N (--body B | --body-file
  F)` — comment on an issue.

All write verbs:

- Auto-sign with `- <nick> (Claude)`. `<nick>` resolves from the local
  `culture.yaml` (`agents[0].suffix`), falling back to the repo basename.
  `--as NICK` overrides.
- Are idempotent: re-signing a body that already ends with the signature
  line is a no-op.

`fetch` is read-only and emits no signature.

## Roadmap

### v0.2 — `agtag message` (mesh transport)

Migrate the existing `culture agent message <channel> <body>` CLI into
`agtag message --channel <channel> --body <body>`, so message-by-CLI and
issue-by-CLI share one binary. Mesh messages remain unsigned (the IRC
nick already identifies the speaker).

### Out of scope (separate repo)

PR review-thread tooling — anything currently in
`cicd/scripts/pr-reply.sh` and `cicd/scripts/pr-batch.sh` — belongs to
the planned **agex-cli** repo (agent-experience / dev-experience-for-
agents). agtag's `cicd` skill is left untouched.