**Class:** incorrect · **Severity:** material **Flow:** arch-90c90751344f · **Step:** docir agent install --agent **Question:** issue-bdb7330441e6 · **Frequency:** any typo in --agent ## Finding An unrecognised agent target name is silently ignored: no error, exit 0, nothing written. ## What happens today OBSERVED. `docir agent install --agent claud` printed `[]`, exited 0, created no files. Two files away, `docir init --profiles bogus` correctly raises and lists the valid names. ## Impact A once-per-repo onboarding command that reports success while doing nothing; the user proceeds believing their agent knows how to drive docir. ## Proposed default Raise AgentSetupError naming the valid targets, matching --profiles. ## Resolution FIXED 2026-07-28, as proposed. `_resolve` rejects any name not in `AGENT_TARGETS` and lists the valid ones, matching the `--profiles` message two files away. PROBE-13 replayed: `agent install --agent claud` now exits 2 with "unknown agent target(s): claud; available: claude, agents" where it printed `[]` and exited 0. `update` resolves through the same function, so a typo there is rejected too — it would otherwise have refreshed nothing and reported success, which is the same defect in the command people run more often. FIFTH instance of the encoded-defect trap, and the most explicit yet: the existing test was *named* `test_unknown_agent_is_ignored` and asserted the empty result. The behaviour was not merely unpinned, it was documented as intended in the suite. After issue-9cb85759076d, issue-40d1792bc9f9, issue-87a27629f6a6 and issue-0ff355fa21dd, the pattern is reliable enough to act on: when a gap describes behaviour that "silently does nothing", grep the tests for a case asserting that nothing happens before assuming the tests are on your side. ## Actors affected - repository maintainer ## Evidence - `src/docir/modules/agents/application/service.py:91-105` - `src/docir/entry_points/composition.py:177-180` - `ref-1509d5dbb4c3 (discovery probe log)` --- Migrated from the discovery gap register (GAP-024); the register itself now lives in this store.