# REQ-003: Commands Reference Documentation

## Metadata
- **Status:** implemented
- **Priority:** medium
- **Dependencies:** REQ-001, REQ-002
- **Created:** 2026-03-03
- **Implemented:** 2026-03-03

## Context

`docs/commands.md` is the user-facing command reference. After the TUI-first redesign (REQ-001) and command deprecation (REQ-002), the documentation must reflect the new model accurately. Users reading the docs should immediately understand:

1. Which commands are active and recommended.
2. Which commands are deprecated, and what to use instead.

**New structure for `docs/commands.md`:**

```
## Active Commands
  - `ievo` — TUI dashboard (primary entry point, includes auto-init)
  - `ievo config set/get/list/delete` — manage settings and credentials

## Deprecated Commands
  (block with warning note that they still work but will be removed)
  - `ievo init` → use `ievo`
  - `ievo add` → HR agent
  - `ievo remove` → HR agent
  - `ievo update` → HR agent
  - `ievo list` → TUI dashboard
  - `ievo run` → TUI dashboard
  - `ievo orchestrate` → internal
  - `ievo learn *` → TUI Evolution tab
  - `ievo deps *` → automatic
  - `ievo dev *` → removed
  - `ievo team` → removed
```

## Acceptance Criteria

- [x] `docs/commands.md` has a top-level `## Active Commands` section
- [x] `docs/commands.md` has a top-level `## Deprecated Commands` section
- [x] Active section documents `ievo` (no args) — describes startup flow: auth check, telemetry, auto-init confirmation, TUI launch
- [x] Active section documents `ievo config set/get/list/delete` with usage examples
- [x] Deprecated section includes a visible callout/note that deprecated commands still work but will be removed in a future release
- [x] Each deprecated command entry names the replacement (or "removed" if no replacement)
- [x] `ievo init` deprecated entry explains the auto-init behavior from `ievo` without args

## Negative Acceptance Criteria

- Does NOT remove documentation for deprecated commands entirely — they still work and users may have scripts using them
- Does NOT include implementation details (file paths, function names) — this is user-facing docs
- Does NOT document commands that were removed without any replacement as if they had a replacement

## Technical Notes

File: `docs/commands.md`

No code changes — documentation only. Blocked by REQ-001 (auto-init) and REQ-002 (deprecation) being agreed upon, as the docs describe the behavior introduced by those two requirements.
