ディレクトリ構成案: Modern Docker Infrastructure (2026)

本プロジェクトにおいて、単なる課題提出（Docker構成）を超え、「AIエージェント（Antigravity）との共創」「ドキュメント駆動開発（VitePress）」「GitHub Issue/Projects連携」を統合した、2026年基準のモダンなディレクトリ構成を提案します。

1. 提案するディレクトリ構成 プロジェクトのルートを「コード」「ドキュメント」「管理」の3軸で整理します。

.
├── Makefile                # プロジェクト全体のビルド・管理
├── .clinerules             # AIエージェント（Antigravity）への指示・GitHub連携ルール
├── .gitignore              # secrets/ や .env を除外
├── docs/                   # VitePressによるナレッジベース・Webサイト (SSG)
│   ├── .vitepress/         # VitePress設定（ナビゲーション、テーマ設定）
│   ├── index.md            # トップページ（プロジェクト概要）
│   ├── guide/              # 初学者・レビュワー向け解説（Docker Infrastructureの仕組み）
│   ├── dev/                # 自分専用ナレッジベース（コマンドメモ、トラブルシューティング）
│   ├── management/         # プロジェクト進行管理（仕様書、実行計画書）
│   └── resume/             # レジュメ作成課題用Webページ
├── management/             # AI連携・タスク管理用スクリプト/テンプレート
│   ├── issues/             # Issueの雛形（AIがここを読み取ってGitHubへ投稿）
│   └── templates/          # 実装計画(Implementation Plan)のMarkdownテンプレート
├── secrets/                # 秘匿情報（Git管理外。Makefile経由でsrcsへ提供）
│   └── credentials.txt
└── srcs/                   # 本プロジェクト本体（Docker関連資産）
    ├── .env                # secretsからコピー/生成される環境変数
    ├── docker-compose.yml
    └── requirements/
        ├── mariadb/
        ├── nginx/
        ├── wordpress/
        ├── tools/
        └── bonus/

2. 進め方のプロセス：AI駆動型双方向同期 この構成を活かして、GitHubとローカルを同期させる具体的な手順です。 ① 計画フェーズ：VitePress ↔ GitHub Issue 要件定義: docs/management/ に要件を書き出します。 AI連携: Antigravityに「docs/management/ の内容を読み取って、GitHubのIssueを作成して」と指示します。 Issue作成: gh issue create により、Webサイト上の計画がGitHubのタスクとして同期されます。 ② 実装フェーズ：Antigravity ↔ srcs/ ↔ GitHub Projects コンテキスト読み込み: Antigravityが .clinerules を読み、srcs/ のDocker構成とIssueの要件を照らし合わせます。 進捗同期: AIがコードを修正するたびに、gh project item-edit でプロジェクトボードのカードを移動させます。 ナレッジ蓄積: 実装中に発生したエラーの解決策を、AIに docs/dev/ (VitePress) へ追記させます。 ③ プレゼンテーション：VitePressによる可視化 レビュワー向け: docs/guide/ に、Dockerのネットワーク構成やTLSの仕組みを「図解（Mermaid.jsなど）」を用いて作成します。 公開: VitePressをGitHub Pagesにデプロイすれば、レビュー時にURLを見せるだけで、非常に高いプレゼンスキルを証明できます。

3. この構成のメリット AIが迷わない: srcs/（技術）と docs/（論理）が分かれているため、AIが「今何をすべきか」をコンテキストごとに切り替えやすくなります。 レビュワーへの訴求: Docker Infrastructureは「理解度」が問われる課題です。VitePressでナレッジベースを公開していることは、圧倒的な加点要素になります。 自己成長の記録: 単なる課題完了ではなく、「どのように考え、AIをどう使いこなしたか」が docs/ に資産として残ります。

4. 運用のコツ：Makefileの強化 プロジェクトを円滑に進めるため、Makefile にGitHub操作のショートカットを作っておくと便利です。

# Makefile の例
doc-dev: ## VitePressのローカルプレビュー
	npm run docs:dev

sync-issue: ## ローカルの計画をGitHub Issueに反映（AIが使いやすいように）
	gh issue list --json number,title,body

setup-env: ## secretsからsrcs/.envを作成
	cp secrets/credentials.txt srcs/.env

まずは、docs/ ディレクトリを作成して npm add -D vitepress でドキュメント環境を立ち上げ、そこに現在の「実現したいこと」を書き出すことからスタートするのが、最も成功確率の高い進め方です。