nwiizo CLI UX Review
CLI ツール出力のユーザビリティレビュー。
Checklist
Output
- Box-drawing tables 禁止 — bullet points を使う
- Strict mode デフォルト —
--allで全表示 - Progressive disclosure — summary →
--verbose→--json
Language
- English default
-
--japanese/--jpfor localized output
Hierarchy
- Grade/Score を最上部に
- Critical issues 優先表示
- 各 issue に actionable suggestion 付き
- File paths with line numbers
Exit Codes
- 0: success / 1: errors found
Anti-Patterns
BAD: Box-drawing tables → GOOD: Bullet points
BAD: 60 low-priority warnings → GOOD: 3 critical (--all for more)
BAD: Japanese only → GOOD: English default, --jp option
Review Questions
- 5秒で出力を理解できるか？
- 最重要 issue が最初に見えるか？
- どのターミナルでも動作するか？
- Machine-readable format があるか？