起動契約
端末インターフェース（パネル、レール、ステータスバー、カード、プロンプト）、特にGentle Shellの設計、レビュー、または改良に使用します。目指す感触は、端末内のIDE（統合開発環境）です。つまり、高密度で落ち着いており、開発者ファーストであり、決してレトロなTUIの仮装ではありません。Webページには使用しないでください（代わりに gentle-design を使用）。
ハードルール
- コードや記憶だけで端末UIを判断しないでください。必ずキャプチャし (
references/visual-loop.md)、変更の前後でPNGを確認してください。 - UIを編集する前に
references/terminal-craft.mdを読んでください。これは提案ではなく、基本ルールです。 - 操作方法: 親しみやすさが表現に勝ります。IDEの語彙（ペイン、ツリー、タブ、ステータスバー、コマンドパレット）を使用します。ブランドは、カラーパレット、密度、そして1つの特徴的な動きに宿ります。
- 各行にはコストがかかります。階層は、色の役割、太さ、配置から生まれます。空行やネストされたボックスからは生まれません。
- 画面ごとに各情報は1回だけ表示します。ヘッダーに表示されたデータは、パネルで繰り返さないでください。
- 1つのコマンドで1つのターゲット。改良はシステムを維持し、再設計はシステムを置き換えます。捨てられる見た目を磨かないでください。
- レンダリングは軽量に保ちます。レンダリングパスでのI/Oや再計算は行わず、出力（スタイル、幅、テーマ）を変更するすべての要素をキーにしたキャッシュを使用します。
- モックアップ（
gentle-design経由）は、端末で表現可能でなければなりません。つまり、ch単位の等幅セルグリッド、前景色/背景色のみ、bold/dim/italic/underline/strikethrough、罫線記号とグリフを使用します。
決定ゲート
| 状況 | コマンド | 読み込むもの |
|---|---|---|
| プロダクト/デザインのコンテキストがない | document | references/design-doc.md |
| 新しい画面または再設計 | shape → モックアップ → 実装 | references/commands.md |
| 「見た目はどうか / 何が問題か」 | critique | references/critique.md |
| ごちゃごちゃしている、スペースの無駄、冗長 | distill / layout / quieter | references/commands.md |
| フラットで階層がない、読みにくい | typeset / colorize / bolder | references/commands.md |
| エッジケース、狭い端末、長いテキスト | harden / adapt | references/commands.md |
| コミット前の最終確認 | polish | references/commands.md |
実行手順
- プロジェクトに
DESIGN.mdのコンテキストがあれば読み込みます。なければ、まずdocumentを提案します。 - 出荷時のサイズ（ワイド 180x50、ブレークポイント 140、ナロー 80x24）でビジュアルループを使い、現在の状態をキャプチャします。
- 選択したコマンドを1つの名前付きターゲットに対して実行します。コードを変更する前に、所見を書き留めます。
- 変更、再キャプチャ、以前のPNGと簡単な指示と比較します。最大3ラウンド繰り返し、その後報告します。
- すべてのリファインコマンドは、
polishチェックとリポジトリの集中テスト（レンダリングカウント、オーバーフロー）で終了します。
出力契約
返却内容: ターゲット、実行されたコマンド、変更前後のPNGパス、P0～P3タグで修正された所見、未解決の所見、実行されたチェック。
参考文献
references/terminal-craft.md: 基本ルールと端末のアンチパターン。references/commands.md: 端末に適応したコマンドのプレイブック。references/critique.md: 採点された批評と重大度のルーブリック。references/design-doc.md: 端末プロダクトのDESIGN.mdの形式。references/visual-loop.md: スクリーンショットのハーネスと比較ループ。NOTICE.md: 帰属表示。