terminal-quest 1.1.2 → 1.2.0

package/dist/data/stories/01-first-server.js

@@ -288,14 +288,18 @@ export const story01 = {
                 },
                 {
                     id: 'obj-01-02-03',
-                    description: 'config.json の内容を表示する',
-                    checks: [{ type: 'output_contains', pattern: 'port' }],
+                    description: '/etc/app/config.json の内容を表示する',
+                    checks: [
+                        { type: 'command_executed', command: 'cat' },
+                        { type: 'output_contains', pattern: 'port' },
+                    ],
                     hints: [
                         { level: 1, text: 'ファイルの内容を表示するコマンドがあります。' },
                         { level: 2, text: '猫の鳴き声に似た3文字のコマンドです。パスを指定しましょう。' },
                         { level: 3, text: '「cat app/config.json」と入力してください。' },
                     ],
                     feedbacks: [
+                        { pattern: 'cat.*nginx', message: 'nginx.conf はWebサーバーの設定ファイルです。今回確認したいのはアプリの設定ファイル config.json です。app/ ディレクトリの中にあります。' },
                         { pattern: 'pwd', message: 'pwd は現在の場所を表示するコマンドです。ファイルの内容を読むには、別のコマンドを使います。' },
                         { pattern: 'ls', message: 'ls はファイル一覧を表示するコマンドです。ファイルの中身を読むには、別のコマンドを使います。' },
                         { pattern: 'cd', message: 'cd はディレクトリ移動のコマンドです。ファイルの内容を読むには、別のコマンドを使います。' },
@@ -373,7 +377,7 @@ export const story01 = {
             objectives: [
                 {
                     id: 'obj-01-04-01',
-                    description: 'config.json のバックアップを作成する',
+                    description: 'config.json のバックアップを作成する（.bak 拡張子をつける）',
                     checks: [
                         {
                             type: 'file_exists',
@@ -420,7 +424,7 @@ export const story01 = {
                         },
                     ],
                     hints: [
-                        { level: 1, text: 'echo コマンドとリダイレクト（>）を使ってファイルに書き込めます。' },
+                        { level: 1, text: 'echo コマンドとリダイレクト（>）を使うと、ファイルの内容を丸ごと上書きできます。JSON形式で全体を書き直す必要があります。' },
                         { level: 2, text: 'echo "内容" > ファイル名 の形式で、ファイルの内容を上書きできます。' },
                         {
                             level: 3,
@@ -428,7 +432,9 @@ export const story01 = {
                         },
                     ],
                     feedbacks: [
-                        { pattern: 'cat', message: 'cat はファイルの内容を表示するコマンドです。ファイルに書き込むには、別のコマンドとリダイレクト（>）を使います。' },
+                        { pattern: 'debug.*=.*true', message: 'JSON形式で書き込む必要があります。{"port": 3000, "debug": true} のような形式にしましょう。' },
+                        { pattern: '>>', message: '>>（追記）ではなく >（上書き）を使いましょう。ファイルの内容を新しい内容に置き換えます。' },
+                        { pattern: 'cat', message: 'cat はファイルの内容を表示するコマンドです。ファイルに書き込むには、echo コマンドとリダイレクト（>）を使います。' },
                         { pattern: 'cp', message: 'cp はファイルをコピーするコマンドです。ファイルの内容を書き換えるには、echo とリダイレクト（>）を使いましょう。' },
                     ],
                 },

package/dist/data/stories/02-messy-project.js

@@ -176,7 +176,7 @@ const appJsContent = [
     '});',
     '',
     '// End of file',
-].join('\n');
+].join('\n') + '\n';
 const readmeContent = [
     '# My Project',
     '',
@@ -332,8 +332,9 @@ export const story02 = {
                         { level: 3, text: '「mv app.js src/」と入力してEnterを押してください。' },
                     ],
                     feedbacks: [
-                        { pattern: 'cp', message: 'cp はファイルをコピーするコマンドです。元のファイルを残さず移動するには、別のコマンドを使います。' },
-                        { pattern: 'rm', message: 'rm はファイルを削除するコマンドです。ファイルを別の場所に移動するには、別のコマンドを使います。' },
+                        { pattern: 'cp.*src', message: 'cp はファイルをコピーするコマンドです。コピーだと元の場所にもファイルが残ります。元のファイルを残さず移動するには mv を使いましょう。' },
+                        { pattern: 'cp', message: 'cp はファイルをコピーするコマンドです。元のファイルを残さず移動するには、mv コマンドを使います。' },
+                        { pattern: 'rm', message: 'rm はファイルを削除するコマンドです。ファイルを別の場所に移動するには、mv コマンドを使います。' },
                     ],
                 },
                 {
@@ -345,6 +346,9 @@ export const story02 = {
                         { level: 2, text: 'mv コマンドで readme.md を docs/ に移動します。' },
                         { level: 3, text: '「mv readme.md docs/」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'cp.*docs', message: 'cp だと元の場所にもファイルが残ります。mv を使って移動しましょう。' },
+                    ],
                 },
                 {
                     id: 'obj-02-02-03',
@@ -355,29 +359,32 @@ export const story02 = {
                         { level: 2, text: 'mv コマンドで test.js を tests/ に移動します。' },
                         { level: 3, text: '「mv test.js tests/」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'cp.*tests', message: 'cp だと元の場所にもファイルが残ります。mv を使って移動しましょう。' },
+                    ],
                 },
             ],
         },
         {
             id: 'mission-02-03',
             title: '不要なファイルを削除',
-            description: '.tmp ファイルや .bak ファイルを見つけて削除しよう。',
+            description: '.tmp ファイルを見つけて削除しよう。',
             goal: 'find で不要ファイルを検索し、rm で安全に削除できるようになる',
-            narrative: 'プロジェクト内に .tmp ファイルや .bak ファイルが大量にある。不要ファイルを見つけて削除しよう。',
+            narrative: 'プロジェクト内に不要な .tmp ファイルが散らばっている。find コマンドで見つけ出して、rm で削除しよう。',
             initialCwd: '/home/dev/project',
             newCommands: ['rm', 'find'],
             initialFS: mission3FS,
             objectives: [
                 {
                     id: 'obj-02-03-01',
-                    description: '.tmp ファイルを見つける',
+                    description: 'find コマンドで .tmp ファイルをすべて見つける',
                     checks: [
                         { type: 'command_executed', command: 'find' },
                         { type: 'output_contains', pattern: '.tmp' },
                     ],
                     hints: [
                         { level: 1, text: 'ファイルを検索するコマンドがあります。' },
-                        { level: 2, text: 'find コマンドで名前パターンを指定して検索できます。' },
+                        { level: 2, text: 'find コマンドは現在のディレクトリとサブディレクトリをすべて検索します。-name オプションで名前パターンを指定します。' },
                         { level: 3, text: '「find . -name "*.tmp"」と入力してEnterを押してください。' },
                     ],
                     feedbacks: [

package/dist/data/stories/03-log-detective.js

@@ -219,16 +219,26 @@ export const story03 = {
                         { level: 2, text: 'grep コマンドに検索パターンとファイル名を指定します。' },
                         { level: 3, text: '「grep 500 access.log」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'cat', message: 'cat はファイル全体を表示します。特定の文字列を含む行だけを抽出するには grep を使いましょう。' },
+                        { pattern: 'grep.*error', message: 'ログ内のステータスコードは数字（500）で記録されています。「error」ではなく「500」で検索してみましょう。' },
+                    ],
                 },
                 {
                     id: 'obj-03-02-02',
-                    description: 'エラーの件数を数える（5件）',
-                    checks: [{ type: 'output_contains', pattern: '5' }],
+                    description: '500 エラーが何件あるか数えて表示する',
+                    checks: [
+                        { type: 'command_executed', command: 'wc' },
+                        { type: 'output_contains', pattern: '5' },
+                    ],
                     hints: [
-                        { level: 1, text: '行数を数えるコマンドとパイプを組み合わせましょう。' },
+                        { level: 1, text: 'grep の結果をさらに別のコマンドに渡して行数を数えられます。| （パイプ）という記号でコマンドをつなぎます。' },
                         { level: 2, text: 'grep の結果を wc -l にパイプで渡すと行数を数えられます。' },
                         { level: 3, text: '「grep 500 access.log | wc -l」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'wc.*access', message: 'wc -l をファイルに直接使うと全行数が出ます。500 エラーの行だけを数えるには、まず grep で抽出してからパイプ（|）で wc -l に渡しましょう。' },
+                    ],
                 },
             ],
         },
@@ -248,19 +258,25 @@ export const story03 = {
                     checks: [{ type: 'command_executed', command: 'sort' }],
                     hints: [
                         { level: 1, text: 'データを並び替えるコマンドがあります。' },
-                        { level: 2, text: 'sort コマンドで行を並び替えることができます。' },
+                        { level: 2, text: 'sort コマンドで行をアルファベット順に並び替えることができます。' },
                         { level: 3, text: '「sort ip-list.txt」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'uniq', message: 'uniq の前に、まず sort でデータを並べ替えましょう。sort → uniq の順番が大切です。' },
+                    ],
                 },
                 {
                     id: 'obj-03-03-02',
-                    description: 'ユニークなIPアドレスの一覧を出す',
+                    description: 'IPアドレスの出現回数つき一覧を表示する（sort | uniq -c）',
                     checks: [{ type: 'command_executed', command: 'uniq' }],
                     hints: [
-                        { level: 1, text: '重複を除去するコマンドがあります。sort と組み合わせましょう。' },
+                        { level: 1, text: '重複する行を1つにまとめるコマンドがあります。ただし、隣り合った行しか比較しないため、先にデータを並べ替えておく必要があります。' },
                         { level: 2, text: 'sort の結果をパイプで uniq に渡します。uniq -c で件数も表示できます。' },
                         { level: 3, text: '「sort ip-list.txt | uniq -c」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'uniq.*ip-list', message: 'uniq は隣り合った重複行しか除去しません。先に sort でデータを並べ替えてからパイプで uniq に渡しましょう。' },
+                    ],
                 },
             ],
         },

package/dist/data/stories/04-deploy-day.js

@@ -240,15 +240,26 @@ export const story04 = {
                 },
                 {
                     id: 'obj-04-01-02',
-                    description: 'source の内容をデプロイ先にコピーする',
+                    description: 'source/README.md を /var/www/app/ にコピーする',
                     checks: [{ type: 'file_exists', path: '/var/www/app/README.md' }],
                     hints: [
-                        { level: 1, text: 'ディレクトリごとコピーするオプションがあります。' },
-                        { level: 2, text: 'cp に -r オプションをつけると、ディレクトリを再帰的にコピーできます。' },
-                        { level: 3, text: '「cp -r source/* /var/www/app/」と入力してEnterを押してください。' },
+                        { level: 1, text: 'ファイルをコピーするコマンドがあります。' },
+                        { level: 2, text: 'cp コマンドで source 内のファイルをデプロイ先にコピーできます。' },
+                        { level: 3, text: '「cp source/README.md /var/www/app/」と入力してEnterを押してください。' },
                     ],
                 },
             ],
+            review: {
+                question: 'mkdir -p オプションの効果は何ですか？',
+                choices: [
+                    '空のディレクトリだけを作成する',
+                    '親ディレクトリも含めて一度に作成する',
+                    'ディレクトリの権限を変更する',
+                    '既存ディレクトリを上書きする',
+                ],
+                correctIndex: 1,
+                explanation: 'mkdir -p は親ディレクトリが存在しなくても、必要な階層をすべて一度に作成できます。例えば /var/www/app なら、/var と /var/www も同時に作られます。',
+            },
         },
         {
             id: 'mission-04-02',
@@ -262,15 +273,30 @@ export const story04 = {
             objectives: [
                 {
                     id: 'obj-04-02-01',
-                    description: 'start.sh に実行権限を付与する',
+                    description: 'chmod +x で start.sh に実行権限を付与する',
                     checks: [{ type: 'command_executed', command: 'chmod' }],
                     hints: [
-                        { level: 1, text: 'ファイルの権限を変更するコマンドがあります。' },
+                        { level: 1, text: 'スクリプトを実行するには、実行権限を付与する必要があります。権限を変更するコマンドを使いましょう。' },
                         { level: 2, text: 'chmod コマンドで権限を変更します。+x で実行権限を追加できます。' },
                         { level: 3, text: '「chmod +x start.sh」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'chmod x ', message: '「+x」の + を忘れていませんか？権限を追加するには + が必要です。' },
+                        { pattern: 'chmod 755', message: '数値指定でもOKですが、このミッションでは +x の書き方を練習しましょう。' },
+                    ],
                 },
             ],
+            review: {
+                question: 'chmod +x の「+x」は何を意味しますか？',
+                choices: [
+                    'ファイルを削除する許可を追加する',
+                    'ファイルの実行権限を追加する',
+                    'ファイルの書き込み権限を追加する',
+                    'ファイルの読み取り権限を追加する',
+                ],
+                correctIndex: 1,
+                explanation: '+x は実行（eXecute）権限を追加します。シェルスクリプトを動かすには実行権限が必要です。+r は読み取り、+w は書き込みを表します。',
+            },
         },
         {
             id: 'mission-04-03',
@@ -283,13 +309,16 @@ export const story04 = {
             objectives: [
                 {
                     id: 'obj-04-03-01',
-                    description: '古いバックアップ（backup-old）を削除する',
+                    description: 'rm -rf で古いバックアップ（backup-old）をまるごと削除する',
                     checks: [{ type: 'file_not_exists', path: '/var/www/backup-old' }],
                     hints: [
-                        { level: 1, text: 'ディレクトリを削除するにはオプションが必要です。' },
+                        { level: 1, text: '中身の入ったディレクトリをまるごと削除するには、rm に特別なオプションが必要です。' },
                         { level: 2, text: 'rm に -rf オプションをつけると、ディレクトリを中身ごと削除できます。' },
                         { level: 3, text: '「rm -rf backup-old」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: '^rm backup-old$', message: 'ディレクトリを削除するには -rf オプションが必要です。rm -rf backup-old としましょう。' },
+                    ],
                 },
                 {
                     id: 'obj-04-03-02',
@@ -302,6 +331,17 @@ export const story04 = {
                     ],
                 },
             ],
+            review: {
+                question: 'rm -rf の -r と -f はそれぞれ何を意味しますか？',
+                choices: [
+                    '-r は読み取り、-f はファイル指定',
+                    '-r は再帰（中身ごと削除）、-f は強制（確認なし）',
+                    '-r はリネーム、-f はフォルダ指定',
+                    '-r は復元、-f は高速モード',
+                ],
+                correctIndex: 1,
+                explanation: '-r（recursive）はディレクトリを中身ごと再帰的に削除します。-f（force）は確認メッセージなしで強制的に削除します。非常に強力なので、対象を間違えないよう注意が必要です。',
+            },
         },
         {
             id: 'mission-04-04',
@@ -324,8 +364,11 @@ export const story04 = {
                 },
                 {
                     id: 'obj-04-04-02',
-                    description: '設定ファイルの内容を確認して production であることを確かめる',
-                    checks: [{ type: 'output_contains', pattern: 'production' }],
+                    description: 'cat config.json で設定を表示し、production であることを確かめる',
+                    checks: [
+                        { type: 'command_executed', command: 'cat' },
+                        { type: 'output_contains', pattern: 'production' },
+                    ],
                     hints: [
                         { level: 1, text: 'ファイルの内容を表示するコマンドで設定を確認しましょう。' },
                         { level: 2, text: 'cat コマンドで config.json の内容を表示できます。' },
@@ -333,6 +376,17 @@ export const story04 = {
                     ],
                 },
             ],
+            review: {
+                question: 'デプロイ後の最終確認として適切なのはどれですか？',
+                choices: [
+                    'すぐにサーバーを再起動する',
+                    'find と cat で必要なファイルが揃っているか確認する',
+                    'rm -rf で不要ファイルを全て削除する',
+                    '何もせずにデプロイ完了とする',
+                ],
+                correctIndex: 1,
+                explanation: 'デプロイ後は find でファイル一覧を確認し、cat で設定ファイルの内容が正しいか確かめることが重要です。思い込みで確認を飛ばすと、本番障害の原因になりかねません。',
+            },
         },
     ],
     unlockRequires: ['story-02', 'story-03'],

package/dist/data/stories/05-git-incident.js

@@ -76,13 +76,13 @@ const mission1FS = {
                                         },
                                         branches: {
                                             type: 'file',
-                                            content: '* main\n  feature/login\n  feature/api',
+                                            content: 'main\nfeature/login\nfeature/api',
                                         },
                                         log: {
                                             type: 'file',
                                             content: gitLogContent,
                                         },
-                                        'status-output': {
+                                        status: {
                                             type: 'file',
                                             content: gitStatusOutput,
                                         },
@@ -141,20 +141,16 @@ const mission2FS = {
                                         },
                                         branches: {
                                             type: 'file',
-                                            content: '* main\n  feature/login\n  feature/api',
+                                            content: 'main\nfeature/login\nfeature/api',
                                         },
                                         log: {
                                             type: 'file',
                                             content: gitLogContent,
                                         },
-                                        'status-output': {
+                                        status: {
                                             type: 'file',
                                             content: gitStatusOutput,
                                         },
-                                        stash: {
-                                            type: 'file',
-                                            content: '',
-                                        },
                                     },
                                 },
                                 src: {
@@ -210,7 +206,7 @@ const mission3FS = {
                                         },
                                         branches: {
                                             type: 'file',
-                                            content: '* main\n  feature/login\n  feature/api',
+                                            content: 'main\nfeature/login\nfeature/api',
                                         },
                                         log: {
                                             type: 'file',
@@ -260,13 +256,13 @@ const mission4FS = {
                                         },
                                         branches: {
                                             type: 'file',
-                                            content: '  main\n  feature/login\n  feature/api\n* hotfix',
+                                            content: 'main\nfeature/login\nfeature/api\nhotfix',
                                         },
                                         log: {
                                             type: 'file',
                                             content: gitLogContent,
                                         },
-                                        'diff-output': {
+                                        diff: {
                                             type: 'file',
                                             content: gitDiffOutput,
                                         },
@@ -325,7 +321,7 @@ const mission5FS = {
                                         },
                                         branches: {
                                             type: 'file',
-                                            content: '  main\n  feature/login\n  feature/api\n* hotfix',
+                                            content: 'main\nfeature/login\nfeature/api\nhotfix',
                                         },
                                         log: {
                                             type: 'file',
@@ -387,13 +383,13 @@ export const story05 = {
             objectives: [
                 {
                     id: 'obj-05-01-01',
-                    description: '現在の状態を確認する（変更されたファイルを発見する）',
+                    description: 'git status で変更されたファイルを確認する',
                     checks: [
                         { type: 'command_executed', command: 'git' },
                         { type: 'output_contains', pattern: 'modified' },
                     ],
                     hints: [
-                        { level: 1, text: 'リポジトリの状態を確認するGitコマンドがあります。' },
+                        { level: 1, text: '変更されたファイルや現在の状態を一覧表示するGitコマンドがあります。' },
                         { level: 2, text: 'git status コマンドで変更されたファイルを確認できます。' },
                         { level: 3, text: '「git status」と入力してEnterを押してください。' },
                     ],
@@ -403,7 +399,7 @@ export const story05 = {
                     description: 'コミット履歴を確認する',
                     checks: [
                         { type: 'command_executed', command: 'git' },
-                        { type: 'output_contains', pattern: 'commit' },
+                        { type: 'output_contains', pattern: 'Author' },
                     ],
                     hints: [
                         { level: 1, text: 'コミットの履歴を表示するGitコマンドがあります。' },
@@ -412,6 +408,17 @@ export const story05 = {
                     ],
                 },
             ],
+            review: {
+                question: 'git status と git log の違いは何ですか？',
+                choices: [
+                    'どちらも同じ情報を表示する',
+                    'status は現在の変更状態、log は過去のコミット履歴を表示する',
+                    'status はブランチ一覧、log はファイル一覧を表示する',
+                    'status は削除専用、log は作成専用のコマンド',
+                ],
+                correctIndex: 1,
+                explanation: 'git status は「今どのファイルが変更されているか」を表示します。git log は「過去にどんなコミットがあったか」の履歴を表示します。どちらも状況把握に重要です。',
+            },
         },
         {
             id: 'mission-05-02',
@@ -424,18 +431,29 @@ export const story05 = {
             objectives: [
                 {
                     id: 'obj-05-02-01',
-                    description: '変更を stash に退避する',
+                    description: 'git stash で作業中の変更を一時退避する',
                     checks: [
                         { type: 'command_executed', command: 'git' },
                         { type: 'output_contains', pattern: 'stash' },
                     ],
                     hints: [
                         { level: 1, text: '変更を一時的に退避するGitコマンドがあります。' },
-                        { level: 2, text: 'git stash コマンドで変更を退避できます。後で git stash pop で戻せます。' },
+                        { level: 2, text: 'git stash コマンドで変更を一時保存し、作業ツリーをクリーンな状態にできます。' },
                         { level: 3, text: '「git stash」と入力してEnterを押してください。' },
                     ],
                 },
             ],
+            review: {
+                question: 'git stash はどんな時に使いますか？',
+                choices: [
+                    '変更を完全に削除したい時',
+                    '作業中の変更を一時的に退避して、後で戻したい時',
+                    '新しいブランチを作成する時',
+                    'ファイルの名前を変更する時',
+                ],
+                correctIndex: 1,
+                explanation: 'git stash は「今の作業を一旦棚に上げる」イメージです。別の作業をした後、git stash pop で棚から戻せます。変更を失わずに安全に退避できる便利なコマンドです。',
+            },
         },
         {
             id: 'mission-05-03',
@@ -471,8 +489,23 @@ export const story05 = {
                         { level: 2, text: 'git checkout に -b オプションをつけると、新しいブランチを作って切り替えられます。' },
                         { level: 3, text: '「git checkout -b hotfix」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'git branch hotfix$', message: 'git branch だけではブランチの作成のみで、切り替えはされません。git checkout -b hotfix で作成と切り替えを同時にできます。' },
+                        { pattern: 'git checkout hotfix$', message: '-b をつけないと既存ブランチへの切り替えになります。新規作成するには git checkout -b hotfix です。' },
+                    ],
                 },
             ],
+            review: {
+                question: '「git checkout -b hotfix」は何をしますか？',
+                choices: [
+                    'hotfix ブランチを削除する',
+                    'hotfix という名前の新しいブランチを作成し、そこに切り替える',
+                    '既存の hotfix ブランチに切り替える',
+                    'hotfix ブランチの変更をマージする',
+                ],
+                correctIndex: 1,
+                explanation: 'git checkout -b は「新しいブランチを作って同時に切り替える」コマンドです。-b なしの git checkout hotfix は「既にある hotfix ブランチに切り替える」だけです。',
+            },
         },
         {
             id: 'mission-05-04',
@@ -485,7 +518,7 @@ export const story05 = {
             objectives: [
                 {
                     id: 'obj-05-04-01',
-                    description: 'diff で変更内容を確認する',
+                    description: 'git diff でコードの変更差分を確認する',
                     checks: [
                         { type: 'command_executed', command: 'git' },
                         { type: 'output_contains', pattern: '@@' },
@@ -497,6 +530,17 @@ export const story05 = {
                     ],
                 },
             ],
+            review: {
+                question: 'git diff の出力で「+」と「-」は何を表しますか？',
+                choices: [
+                    '+ は追加された行、- は削除された行',
+                    '+ はファイル作成、- はファイル削除',
+                    '+ は正しいコード、- は間違ったコード',
+                    '+ はコミット済み、- は未コミット',
+                ],
+                correctIndex: 0,
+                explanation: 'git diff では + の行は新しく追加された行、- の行は削除された行を表します。変更前と変更後の差分がひと目でわかるので、レビューに欠かせないコマンドです。',
+            },
         },
         {
             id: 'mission-05-05',
@@ -510,7 +554,10 @@ export const story05 = {
                 {
                     id: 'obj-05-05-01',
                     description: 'main ブランチに切り替える',
-                    checks: [{ type: 'command_executed', command: 'git' }],
+                    checks: [
+                        { type: 'command_executed', command: 'git' },
+                        { type: 'output_contains', pattern: 'Switched' },
+                    ],
                     hints: [
                         { level: 1, text: 'ブランチを切り替えるGitコマンドがあります。' },
                         { level: 2, text: 'git checkout コマンドでブランチを切り替えられます。' },
@@ -529,8 +576,22 @@ export const story05 = {
                         { level: 2, text: 'git merge コマンドで指定したブランチの変更を現在のブランチに統合できます。' },
                         { level: 3, text: '「git merge hotfix」と入力してEnterを押してください。' },
                     ],
+                    feedbacks: [
+                        { pattern: 'git merge main$', message: '今 main ブランチにいるので、main をマージしても意味がありません。統合したいブランチ名（hotfix）を指定しましょう。' },
+                    ],
                 },
             ],
+            review: {
+                question: 'git merge hotfix を実行する前に必要なことは何ですか？',
+                choices: [
+                    'hotfix ブランチを削除する',
+                    '統合先のブランチ（main）に切り替えておく',
+                    'すべてのファイルを削除する',
+                    'git stash を実行する',
+                ],
+                correctIndex: 1,
+                explanation: 'git merge は「現在いるブランチに、指定したブランチの変更を取り込む」コマンドです。なので、先に統合先のブランチ（この場合は main）に切り替えておく必要があります。',
+            },
         },
     ],
     unlockRequires: ['story-02'],