今年度は、校舎の引っ越しを控えており、毎年2月に開催されている進級制作展と卒業研究発表会は1ヶ月ほど前倒しで、1月15日(木)と17日(土)に開催予定です。
今回も、Webデザイン学科1年生の進級制作展は、Webサイトを用意し、広く学生作品をご覧いただけるようにと考えています。
しかし、前述したように今年度はスケジュールに余裕がありませんので、昨年度のWebサイトの仕様そのままで、作品を入れ替える方法を考えていました。
Eleventyのバージョンも上がった上、少し修正したい部分もありましたので、どうしたものかと考えていたところ、話題になっていたKiroを使ったバイブコーディングを試してみることにしました。
Kiroとは
Kiroは、最近話題になっているAI統合開発環境(IDE)です。
Kiroの最大の特徴は、システム開発における要求定義から設計、タスク化に至るまでのプロセス全体を、AIパートナーとして支援してくれる点にあります。

従来の「Vibe Coding」と呼ばれる対話形式で直感的に開発を進めるスタイルとは異なり、Kiroは「スペック駆動開発(Spec-Driven Development)」を提唱しています。これは、開発の初期段階から仕様を明確化し、体系的に開発を進めるアプローチです。
Kiroを活用することで、開発者は要件の整理から実装まで、一貫したワークフローの中でAIの支援を受けながら効率的に開発を進めることができます。
Specで要件定義書作成
Kiroを起動して、プロジェクトを作成するとチャットエリアに「Vibe」と「Spec」が表示されます。

今回、制作する「進級制作展作品紹介サイト」の簡単な概要を下記のようにマークダウンで記述します。
仕様は、前年のままですので、そこまで考えて明記していません。
進級制作作品のオンラインWebサイトを制作したいです。
## ページ構成
- TOPページ(作品一覧)
- 作品詳細ページ
- アーカイブ(作品名、制作者名、作品URL)
- 進級制作展について
## 使用技術
- Eleventy
- bootstrap
- github
- vercelすると、自動的にrequirements.mdが作成され、要件定義がマークダウンで作成されます。
この段階で、ここまでのドキュメントがでてくるとは思っていなったので、驚きです。
詳細部分を微調整したり、忘れていた仕様を追加したりして修正していきます。

要件定義書※抜粋
# 要件ドキュメント
## はじめに
進級制作作品のオンラインWebサイトは、学生の制作作品を展示・アーカイブするためのプラットフォームです。訪問者は作品一覧を閲覧し、個別の作品詳細を確認でき、過去の作品アーカイブにもアクセスできます。また、進級制作展に関する情報も提供します。
## 用語集
- **Webサイト**: 進級制作作品オンラインWebサイトシステム
- **訪問者**: Webサイトを閲覧するユーザー
- **作品**: 学生が制作した作品
- **アーカイブ**: 進級制作展当日のプレゼンテーション動画と学生作品を表形式でまとめたページ
- **展示情報ページ**: 進級制作展についての情報ページ
## 要件
### 要件1
**ユーザーストーリー:** 訪問者として、TOPページで全ての進級制作作品の一覧を見たい。そうすることで学生プロジェクトを閲覧できる。
#### 受入基準
1. 訪問者がTOPページにアクセスしたとき、Webサイトは利用可能な全ての作品のリストを表示しなければならない
2. Webサイトは、TOPページで各作品のタイトルと制作者名を表示しなければならない
3. 訪問者がリスト内の作品をクリックしたとき、Webサイトは対応する作品詳細ページに遷移しなければならない
4. WebサイトはEleventyスタティックサイトジェネレーターを使用してTOPページをレンダリングしなければならない
5. WebサイトはBootstrapフレームワークを使用してTOPページをスタイリングしなければならない
### 要件2
**ユーザーストーリー:** 訪問者として、特定の作品の詳細情報を見たい。そうすることでプロジェクトについてより詳しく知ることができる。
#### 受入基準
1. 訪問者が作品詳細ページにアクセスしたとき、Webサイトはその作品の完全な情報を表示しなければならない
2. Webサイトは、詳細ページで作品タイトル、制作者名、説明を表示しなければならない
3. Webサイトは、詳細ページで作品に関連する画像またはメディアを表示しなければならない
4. 訪問者がナビゲーション要素をクリックしたとき、WebサイトはTOPページに戻らなければならない
### 要件3
**ユーザーストーリー:** 訪問者として、進級制作展のアーカイブにアクセスしたい。そうすることでプレゼンテーション動画を視聴し、全作品の情報を一覧で確認できる。
#### 受入基準
1. 訪問者がアーカイブページにアクセスしたとき、Webサイトは進級制作展当日のプレゼンテーション動画を表示しなければならない
2. Webサイトは、作品名、制作者名、作品URLを含む表形式で全学生作品の情報を表示しなければならない
3. 訪問者が表内の作品URLをクリックしたとき、Webサイトは新しいブラウザタブで作品を開かなければならない
4. Webサイトは、プレゼンテーション動画を埋め込みまたはリンク形式で提供しなければならない
5. Webサイトは、表形式のデータを読みやすく整理して表示しなければならない
### 要件4
**ユーザーストーリー:** 訪問者として、進級制作展についての情報を読みたい。そうすることで作品の背景と目的を理解できる。
#### 受入基準
1. 訪問者が展示情報ページにアクセスしたとき、Webサイトは進級制作展の詳細を表示しなければならない
2. Webサイトは、展示の目的、スケジュール、会場情報を表示しなければならない
3. Webサイトは、展示情報ページから他のページに戻るためのナビゲーションを提供しなければならない
### 要件5
**ユーザーストーリー:** 開発者として、Webサイトが自動的にデプロイされることを望む。そうすることで更新を効率的に公開できる。
#### 受入基準
1. GitHubリポジトリにコードがプッシュされたとき、Webサイトは自動デプロイプロセスをトリガーしなければならない
2. WebサイトはVercelホスティングプラットフォームにデプロイしなければならない
3. デプロイが完了したとき、Webサイトは公開URLを通じてアクセス可能でなければならない
4. Webサイトは、バージョン管理とソースコード管理にGitHubを使用しなければならない
### 要件6
**ユーザーストーリー:** 開発者として、作品データをMarkdownファイルで管理したい。そうすることでコンテンツの編集とバージョン管理が容易になる。
#### 受入基準
1. Webサイトは、各作品の情報を個別のMarkdownファイルとして保存しなければならない
2. Webサイトは、Markdownファイルのフロントマターで作品のメタデータ(タイトル、制作者名、URL等)を定義しなければならない
3. Webサイトは、Markdownファイルの本文で作品の説明を記述できなければならない
4. Webサイトは、Eleventyを使用してMarkdownファイルから自動的にHTMLページを生成しなければならない
5. Webサイトは、作品用Markdownファイルを特定のディレクトリ構造で整理しなければならない
### 要件6.1
**ユーザーストーリー:** 開発者として、作品ページを統一されたテンプレートで表示したい。そうすることで一貫性のあるデザインを維持できる。
#### 受入基準
1. Webサイトは、Nunjucksテンプレートエンジンを使用して作品ページをレンダリングしなければならない
2. Webサイトは、全ての作品詳細ページに適用される共通のNunjucksレイアウトテンプレートを定義しなければならない
3. Webサイトは、Markdownファイルのフロントマターで指定されたレイアウトテンプレートを使用しなければならない
4. Webサイトは、テンプレート内で作品のメタデータと本文コンテンツを動的に表示しなければならない
### 要件7
**ユーザーストーリー:** 開発者として、アーカイブの表データを構造化されたデータファイルで管理したい。そうすることで作品情報の一括更新が容易になる。
#### 受入基準
1. Webサイトは、アーカイブページの表データをJSONまたはYAMLファイルで管理しなければならない
2. Webサイトは、データファイルに作品名、制作者名、作品URLのフィールドを含めなければならない
3. Webサイトは、Eleventyのデータファイル機能を使用してテンプレートからデータにアクセスしなければならない
4. Webサイトは、データファイルの更新時に自動的にアーカイブページを再生成しなければならない
### 要件8
**ユーザーストーリー:** 開発者として、サイト全体の設定を一元管理したい。そうすることでサイト情報の更新が簡単になる。
#### 受入基準
1. Webサイトは、サイトタイトル、説明、URLなどの共通情報を設定ファイルで管理しなければならない
2. Webサイトは、Eleventyの設定ファイル(.eleventy.js)でサイト構成を定義しなければならない
3. Webサイトは、全てのテンプレートから設定データにアクセスできなければならない
4. Webサイトは、ナビゲーションメニューの項目を設定ファイルで管理しなければならない
### 要件9
**ユーザーストーリー:** 開発者として、画像を効率的に管理したい。そうすることでサイトのパフォーマンスを維持できる。
#### 受入基準
1. Webサイトは、作品画像を専用のディレクトリに整理して保存しなければならない
2. Webサイトは、画像ファイルを静的アセットとしてビルド出力に含めなければならない
3. Webサイトは、Markdownまたはテンプレートから相対パスで画像を参照できなければならない
4. Webサイトは、画像の代替テキスト(alt属性)を設定できなければならない
### 要件10
**ユーザーストーリー:** 訪問者として、Webサイトがレスポンシブであることを望む。そうすることで異なるデバイスで閲覧できる。
#### 受入基準
1. 訪問者がモバイルデバイスでWebサイトにアクセスしたとき、Webサイトはモバイル最適化されたレイアウトでコンテンツを表示しなければならない
2. 訪問者がタブレットデバイスでWebサイトにアクセスしたとき、Webサイトはタブレット最適化されたレイアウトでコンテンツを表示しなければならない
3. 訪問者がデスクトップデバイスでWebサイトにアクセスしたとき、Webサイトはデスクトップ最適化されたレイアウトでコンテンツを表示しなければならない
4. Webサイトは、レイアウト適応のためにBootstrapレスポンシブグリッドシステムを使用しなければならない
### 要件11
**ユーザーストーリー:** 訪問者として、左側のサイドバーから各ページと全作品に素早くアクセスしたい。そうすることでサイト内を効率的にナビゲートできる。
#### 受入基準
1. 訪問者がデスクトップでWebサイトにアクセスしたとき、Webサイトは画面左側に固定サイドバーを表示しなければならない
2. Webサイトは、サイドバーに主要ページ(作品一覧、アーカイブ、進級制作展について)へのリンクを表示しなければならない
3. Webサイトは、サイドバーに全作品のリストを学生ID順で表示しなければならない
4. 訪問者が現在閲覧中のページまたは作品に対応するサイドバーリンクは、Webサイトがアクティブ状態として視覚的に強調表示しなければならない
5. 訪問者がモバイルデバイスでアクセスしたとき、Webサイトはサイドバーを非表示にし、トップナビゲーションのみを表示しなければならない
6. Webサイトは、サイドバーをスクロール可能にし、多数の作品リストを表示できなければならない次のステップに進んでも、戻ることができるので大まかに仕様ができたら、次のステップ「設計書の作成」に進みます。
設計書作成
ものの数秒で、概要、アーキテクチャ、技術スタック、ディレクトリ構造、各ページごとのテンプレートを書き出してくれます。さらに、考慮機能として検索機能や多言語化などを提案してくれます。

設計書※抜粋
# 設計ドキュメント
## 概要
進級制作作品オンラインWebサイトは、Eleventyスタティックサイトジェネレーターを使用して構築されます。Markdownファイルでコンテンツを管理し、Nunjucksテンプレートでレイアウトを定義し、Bootstrapでスタイリングを行います。GitHubでバージョン管理を行い、Vercelで自動デプロイします。
## アーキテクチャ
### 技術スタック
- **スタティックサイトジェネレーター**: Eleventy (11ty)
- **テンプレートエンジン**: Nunjucks
- **CSSフレームワーク**: Bootstrap 5
- **バージョン管理**: GitHub
- **ホスティング**: Vercel
- **コンテンツ形式**: Markdown + Front Matter
- **データ形式**: JSON/YAML
### ディレクトリ構造
```
graduation-exhibition-website/
├── src/
│ ├── _data/ # グローバルデータファイル
│ │ ├── site.json # サイト全体の設定
│ │ └── archive.json # アーカイブ表データ
│ ├── _includes/ # テンプレートとレイアウト
│ │ ├── layouts/
│ │ │ ├── base.njk # ベースレイアウト
│ │ │ ├── work.njk # 作品詳細レイアウト
│ │ │ └── page.njk # 一般ページレイアウト
│ │ └── components/
│ │ ├── header.njk # ヘッダーコンポーネント
│ │ ├── footer.njk # フッターコンポーネント
│ │ └── nav.njk # ナビゲーション
│ ├── works/ # 作品Markdownファイル
│ │ ├── work-1.md
│ │ ├── work-2.md
│ │ └── ...
│ ├── pages/ # 静的ページ
│ │ ├── archive.njk # アーカイブページ
│ │ └── about.md # 進級制作展について
│ ├── assets/ # 静的アセット
│ │ ├── css/
│ │ │ └── custom.css # カスタムスタイル
│ │ ├── js/
│ │ │ └── main.js # カスタムスクリプト
│ │ └── images/ # 画像ファイル
│ │ └── works/ # 作品画像
│ └── index.njk # TOPページ
├── .eleventy.js # Eleventy設定ファイル
├── package.json
└── README.md
```
## コンポーネントとインターフェース
### 1. TOPページ(作品一覧)
**ファイル**: `src/index.njk`
**機能**:
- 全作品のコレクションを取得
- グリッドレイアウトで作品カードを表示
- 各カードに作品タイトル、制作者名、サムネイル画像を表示
- 作品詳細ページへのリンク
**テンプレート構造**:
```nunjucks
---
layout: layouts/base.njk
title: 進級制作作品一覧
---などなどここでも、提案された機能を追加するのかなど、Kiroと会話しながら進めていきます。
前のステップの「要件定義書」とこの「設計書」でしっかり作り込めば、次は実装となります。
実装計画(タスクリスト)の作成
次のステップに進むと、実装をステップごとにタスク化してくれます。

各タスクごとに小さく「Start task」と明記されており、クリックするとKiroが実装してくれます。
package.jsonを作成し、node.jsでプロジェクト、npmでパッケージのダウンロードまで、すべてお任せです。

実装計画(タスクリスト)
# ???? 進級制作展サイト:実装ロードマップ
## Phase 1: 基礎構築と共通設計
- [ ] **1. プロジェクトのセットアップ**
- [ ] Eleventy プロジェクトの初期化 (`package.json`, `.eleventy.js`)
- [ ] 必要な依存関係のインストール (`Eleventy`, `Bootstrap`)
- [ ] ディレクトリ構造の作成 (`src/_includes`, `src/works`, `src/css`, `src/images`)
- [ ] 基本的な `.eleventy.js` 設定ファイルの作成
- *要件: 6.1, 6.2*
- [ ] **2. ベースレイアウトの実装**
- [ ] `2.1 base.njk`: HTML5構造、Bootstrap CDN、レスポンシブタグ、カスタムCSS読み込み
- [ ] `2.2 navigation.njk`: ナビバー(TOP、アーカイブ、展示会詳細)、ハンバーガーメニュー
- [ ] `2.3 footer.njk`: フッター情報の表示
- [ ] `2.4 PBT`: ナビゲーションの一貫性検証(要件 8.1, 8.2)
- [ ] `2.5 PBT`: ナビゲーションリンクの正確性検証(要件 8.4)
## Phase 2: データモデルとコンテンツ
- [ ] **3. 作品データ設計とサンプル作成**
- [ ] `3.1` スキーマ定義 (必須: `title`, `author`, `thumbnail`, `description`, `url` / 任意: `images`, `year`, `tags`)
- [ ] `3.2` データ検証関数の実装 (必須フィールドチェック、URL形式検証)
- [ ] `3.3` サンプル作品データ作成 (`src/works/` に 3〜5個の Markdown)
- [ ] `3.4` ユニットテスト: データ検証関数(要件 7.3)
- [ ] `3.5 PBT`: ビルドエラーハンドリング(要件 7.3)
- [ ] **7. 進級制作展についてページの実装**
- [ ] `7.1 about.njk`: 展示会情報用のテンプレート作成
- [ ] `7.2` コンテンツ作成(日時、場所、コンセプト、参加方法)
## Phase 3: 主要画面の実装
- [ ] **4. TOP ページ(作品一覧)**
- [ ] `4.1 index.njk`: 作品コレクション取得、Bootstrap グリッドレイアウト
- [ ] `4.2` 作品カード実装: サムネイル、作品名、制作者名、詳細リンク
- [ ] `4.3 PBT`: 作品カード表示の完全性検証(要件 1.2)
- [ ] `4.4 PBT`: 作品詳細リンクの正確性検証(要件 1.3)
- [ ] **5. 作品詳細ページ**
- [ ] `5.1 work.njk`: 構造化表示レイアウト(`base.njk` を継承)
- [ ] `5.2` コンテンツ実装: 画像ギャラリー、外部URL(`target="_blank"`)、戻るリンク
- [ ] `5.3 PBT`: 作品詳細ページの完全性検証(要件 2.1, 2.2)
- [ ] `5.4 PBT`: 外部リンクの新規タブ属性検証(要件 2.3, 3.4)
- [ ] **6. アーカイブページ**
- [ ] `6.1 archive.njk`: リスト/テーブル形式での作品一覧
- [ ] `6.2` 項目実装: 作品名、制作者名、作品URL、詳細リンク
- [ ] `6.3 PBT`: アーカイブ表示の完全性検証(要件 3.2)
- [ ] `6.4 PBT`: アーカイブリンクの正確性検証(要件 3.3)
## Phase 4: デザイン最適化と品質保証
- [ ] **8. スタイリングとレスポンシブ対応**
- [ ] `8.1 style.css`: Bootstrapのカスタマイズ、カードのスタイリング、レスポンシブ調整
- [ ] `8.2` 画像最適化: `loading="lazy"` の付与、`alt` 属性の設定
- [ ] **9. ビルドプロセスと最終テスト**
- [ ] `9.1 PBT`: データ変更のビルド反映検証(要件 6.1〜6.4)
- [ ] `9.2` 統合テスト: ビルド成功確認、生成HTMLの構造チェック
- [ ] **10. チェックポイント**: 全テストパスの最終確認
## Phase 5: デプロイと公開
- [ ] **11. GitHub リポジトリ設定**
- [ ] `11.1 .gitignore`: `node_modules`, `_site`, `.env` などの除外
- [ ] `11.2 README.md`: 概要、セットアップ、ビルドコマンドの記載
- [ ] `11.3` リポジトリ初期化とプッシュ(要件 7.1)
- [ ] **12. Vercel デプロイ**
- [ ] `12.1 vercel.json`: 必要に応じたビルド設定
- [ ] `12.2` Vercel プロジェクト作成と接続
- [ ] `12.3` 初回デプロイの実行と本番URL確認(要件 7.2, 7.4)
- [ ] **13. 最終チェックポイント**: 全機能の動作確認しかし、Kiroでは1ステップずつの実装時間が結構掛かるので、20ステップあると1時間ほどかかります。
そこで、巷では設計部分をKiroに書かせて、実装はClaude Codeで書かせるなど複数のAIを駆使して、制作しているようです。
今回は、実装も全てKiroにおまかせしました。ダミーで作品の文章や画像も準備してもらいます。
すべての実装を終え、npm run devでビルドしてみると、進級制作展作品Webサイトができあがっていました。

驚くべきことに、ここまで1行もコードを書いていません。
後は、ビジュアルデザインを整えるために、BootstrapとCSSを記述し、学生作品をダミーと入れ替えるだけです。
まとめ
正直、ここまで手がかからずに構築できるとは思っていませんでした。
今回のように、以前のWebサイトと仕様が変わらなかったり、フォーマットとして決まっているWebサイトであれば、仕様定義書や設計書作成に苦労しないかと思います。
また、AIが書き出す仕様定義書を確認できたことで、AIに的確に指示を出すためのプロンプトの勉強にもなりました。
現在、1年生は進級制作作品制作に取り組んでいます。
Webサイトも土台ができましたので、進級制作展の時期が近づきましたら、また告知したいと思います。





コメントを残す