# 生成AIプログラミング入門 受講者配布プロジェクト

本研修のハンズオンで使うファイル一式です。VSCode でこの handson フォルダを開いて進めます。

## フォルダ構成

```
handson/
├── README.md                この案内
├── CLAUDE.md                Claude Code が自動で読み込む共有文脈
├── AGENTS.md                複数AIツール共通の指示
├── .claude/settings.json    Claude Code の設定
├── .github/ .cursor/ .codex/  他AIツール向けの指示（内容はAGENTS.mdと同じ要点）
├── kadaiA/                  課題A: CRUD業務アプリをゼロから作る
│   ├── README.md            進め方・OK基準・発展課題
│   ├── dummy_data.csv       備品データ50件
│   └── docs/お題シート.md   作るアプリの要件
├── kadaiB/                  課題B: Spring Boot バグ修正
│   ├── src/                 備品管理システム（不具合入り）
│   ├── issues/              Issueテンプレートと記入例
│   └── mvnw / mvnw.cmd      Maven Wrapper（Mavenのインストール不要）
├── docs/
│   ├── コーディング規約.md
│   ├── 生成物チェックリスト.md
│   └── セキュリティチェックリスト.md
└── hints/                   各ステップの参考プロンプトと詰まり対処
    ├── step01_first_prompt.md      課題A: 最初の1指示
    ├── step02_crud_build.md        課題A: CRUDアプリ構築
    ├── step03_warning_check.md     課題A: 危険性の指摘
    ├── step04_comment_insert.md    課題B: コメント挿入とソース理解
    └── step05_issue_driven.md      課題B: Issue駆動のバグ修正
```

## 進め方

研修の進行に合わせて、次の順で使います。

1. 課題A: kadaiA を開き、hints/step01 → step02 → step03 の順で進めます
2. 課題B: kadaiB を開き、hints/step04 → step05 の順で進めます

各ステップの詳細な手順は当日のハンズオンガイドに沿って案内します。hints は先回りして読んでも構いません。

## 事前に確認しておくこと

- VSCode でこのフォルダが開けること
- VSCode のターミナルで `claude` と入力すると Claude Code が起動すること
- 課題Bは Java 17 が必要です（`java -version` で 17 と表示されること）

うまく動かない場合は、事前セットアップガイドの手順を見直すか、当日冒頭の環境確認の時間にお知らせください。
