{
  "markdown": "# practical-application-design\n\n## 概要\n\n### 目的\n\n### 前提\n\n| ソフトウェア | バージョン | 備考 |\n| :----------- | :--------- | :--- |\n| nodejs       | 22.x       |      |\n\n## 構成\n\n- [構築](#構築)\n- [配置](#配置)\n- [運用](#運用)\n- [開発](#開発)\n\n## 詳細\n\n### Quick Start\n\n```bash\nnpm install\nnpm start\n```\n\n### 構築\n\n```bash\nclaude mcp add -s project memory -- npx @modelcontextprotocol/server-memory\nclaude mcp add -s project codex -- npx @openai/codex mcp-server\n```\n\n#### ralph-loopの導入\n\n- Claude Code 起動後、/plugin を実行\n\n- 検索ボックスで ralph-loop を探して選択\n\n- インストールするスコープを選ぶ（ユーザー / プロジェクト / ローカル）\n\n- Claude Code を再起動\n\n- コマンドで実行\n\n```powershell\n/ralph-loop \"<プロンプト>\" --max-iterations <数値> --completion-promise \"<完了テキスト>\"\n```\n\n#### AI アシスタント（Skills）\n\n`.claude/skills/` ディレクトリに定義された Skills により、AI アシスタントがタスクに応じた専門的な指示を自動的に読み込みます。Progressive Disclosure（段階的開示）により、必要なスキルのみがコンテキストに展開されます。\n\nSkills 一覧は [CLAUDE.md の Skills 体系](CLAUDE.md#skills-体系) を参照してください。\n\n新しいスキルの追加・改善には `/skill-creator` プラグインを使用します。テスト・評価・最適化を含むスキル作成ワークフローが自動化されます。\n\n**[⬆ back to top](#構成)**\n\n### 配置\n\n#### GitHub Pages セットアップ\n\n1. **GitHub リポジトリの Settings を開く**\n    - リポジトリページで `Settings` タブをクリック\n\n2. **Pages 設定を開く**\n    - 左サイドバーの `Pages` をクリック\n\n3. **Source を設定**\n    - `Source` で `Deploy from a branch` を選択\n    - `Branch` で `gh-pages` を選択し、フォルダは `/ (root)` を選択\n    - `Save` をクリック\n\n4. **初回デプロイ**\n    - main ブランチにプッシュすると GitHub Actions が自動実行\n    - Actions タブでデプロイ状況を確認\n\n**[⬆ back to top](#構成)**\n\n### 運用\n\n#### ドキュメントの編集\n\n1. ローカル環境でMkDocsサーバーを起動\n   ```\n   docker-compose up mkdocs\n   ```\n   または、Gulpタスクを使用:\n   ```\n   npm run docs:serve\n   ```\n\n2. ブラウザで http://localhost:8000 にアクセスして編集結果をプレビュー\n\n3. `docs/`ディレクトリ内のMarkdownファイルを編集\n\n4. 変更をコミットしてプッシュ\n   ```\n   git add .\n   git commit -m \"ドキュメントの更新\"\n   git push\n   ```\n\n#### Gulpタスクの使用\n\nプロジェクトには以下のGulpタスクが用意されています：\n\n##### MkDocsタスク\n\n- MkDocsサーバーの起動:\n  ```\n  npm run docs:serve\n  ```\n  または\n  ```\n  npx gulp mkdocs:serve\n  ```\n\n- MkDocsサーバーの停止:\n  ```\n  npm run docs:stop\n  ```\n  または\n  ```\n  npx gulp mkdocs:stop\n  ```\n\n- MkDocsドキュメントのビルド:\n  ```\n  npm run docs:build\n  ```\n  または\n  ```\n  npx gulp mkdocs:build\n  ```\n\n##### ユーザーマニュアルタスク\n\n- ユーザーマニュアル（`docs/manual/`）を HTML へ変換:\n  ```\n  npm run manual:build\n  ```\n  または\n  ```\n  npx gulp manual:build\n  ```\n\n生成された HTML は `apps/manual/` に出力されます。サイトタイトル・著作権表示・ポータルへの戻りリンクは `.env` の `MANUAL_TITLE` / `MANUAL_COPYRIGHT` / `MANUAL_PORTAL_URL` で設定できます。\n\n##### 作業履歴（ジャーナル）タスク\n\n- すべてのコミット日付の作業履歴を生成:\n  ```\n  npm run journal\n  ```\n  または\n  ```\n  npx gulp journal:generate\n  ```\n\n- 特定の日付の作業履歴を生成:\n  ```\n  npx gulp journal:generate:date --date=YYYY-MM-DD\n  ```\n  (例: `npx gulp journal:generate:date --date=2023-04-01`)\n\n生成された作業履歴は `docs/journal/` ディレクトリに保存され、各ファイルには指定された日付のコミット情報が含まれます。\n\n#### GitHub Container Registry\n\nこのプロジェクトでは、GitHub Container Registry（GHCR）を使用して開発コンテナイメージを管理しています。\n\n##### 自動ビルド・プッシュ\n\nタグをプッシュすると、GitHub Actions が自動的にコンテナイメージをビルドし、GHCR にプッシュします。\n\n```bash\n# タグを作成してプッシュ\ngit tag 0.0.1\ngit push origin 0.0.1\n```\n\n##### イメージの取得・実行\n\nGHCR からイメージを取得して実行するには：\n\n```bash\n# イメージをプル\ndocker pull ghcr.io/k2works/practical-application-design:latest\n\n# または特定バージョン\ndocker pull ghcr.io/k2works/practical-application-design:0.0.1\n\n# コンテナを実行\ndocker run -it -v $(pwd):/srv ghcr.io/k2works/practical-application-design:latest\n```\n\nまたは、docker-compose を使用してローカルでビルド・実行することもできます：\n\n```bash\n# 開発環境を起動して中に入る\ndocker-compose run --rm dev bash\n```\n\n認証が必要な場合は、以下のコマンドでログインします：\n\n```bash\n# GitHub Personal Access Token でログイン\necho $GITHUB_TOKEN | docker login ghcr.io -u <username> --password-stdin\n```\n\n##### 権限設定\n\n- リポジトリの Settings → Actions → General で `Read and write permissions` を設定\n- `GITHUB_TOKEN` に `packages: write` 権限が付与されています\n\n##### Dev Container の使用\n\nVS Code で Dev Container を使用する場合：\n\n1. VS Code で「Dev Containers: Reopen in Container」を実行\n2. または「Dev Containers: Rebuild and Reopen in Container」で再ビルド\n\n**[⬆ back to top](#構成)**\n\n### 開発\n\n#### Nix による開発環境\n\nNix を使用して、再現可能な開発環境を構築できます。\n\n##### 準備\n\n1. [Nix をインストール](https://nixos.org/download.html)します。\n2. Flakes を有効にします（`~/.config/nix/nix.conf` に `experimental-features = nix-command flakes` を追加）。\n\n##### 環境の利用\n\n- **デフォルト環境（共通ツール）に入る:**\n  ```bash\n  nix develop\n  ```\n\n- **Node.js 環境に入る:**\n  ```bash\n  nix develop .#node\n  ```\n\n- **Python/MkDocs 環境に入る:**\n  ```bash\n  nix develop .#python\n  ```\n\n環境から抜けるには `exit` を入力します。\n\n##### 依存関係の更新\n\n```bash\nnix flake update\n```\n\n#### GitHub Codespaces に SSH 接続\n\n外部ターミナルアプリから GitHub Codespaces に SSH 接続することで、VS Code のエディタスペースを広く使いながら別ウィンドウのターミナルで作業できます。\n\n##### 前提条件\n\n- [GitHub CLI](https://cli.github.com/) がインストール済みであること\n\n##### 手順\n\n1. **Codespace を作成する**\n\n   https://github.com/codespaces から Codespace を作成します。\n\n2. **Codespace 名を確認する**\n\n   ブラウザに表示される Codespace の URL から名前を取得します。\n\n   例: URL が `https://upgraded-cod-rpxpjr97jrwcxxw7.github.dev/` の場合、Codespace 名は `upgraded-cod-rpxpjr97jrwcxxw7` です。\n\n3. **SSH 接続する**\n\n   ```bash\n   gh codespace ssh -c <codespace名>\n   ```\n\n   例:\n   ```bash\n   gh codespace ssh -c upgraded-cod-rpxpjr97jrwcxxw7\n   ```\n\n接続後は `npm run build` や `git log` など通常のターミナル操作が可能です。\n\n##### 参考\n\n- [GitHub Codespaces に SSH 接続する](https://zenn.dev/hirokisakabe/articles/fdd7eb730423c0)\n\n**[⬆ back to top](#構成)**\n\n## 参照\n",
  "bytes": 5098,
  "sha": "605bdd57d13dab5acc0a2dc699b1a1de28c4ee7ece54eb14666ed0e5b83fcf6c",
  "repo_slug": "k2works/practical-application-design",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_k2works_practical_application_design_age_93fac923/readme"
}