aqibmumtaz/portable-spec-kit

portable-spec-kit は何をしますか？

Portable Spec Kit — 軽量でインストール不要な仕様駆動開発フレームワーク。AI支援エンジニアリング向け。

概要

Portable Spec Kitは、AIエージェントを活用したソフトウェア開発において、仕様（スペック） を中心としたワークフローを提供します。

• インストール不要（プロジェクトにファイルを追加するだけ）
• 仕様をマークダウンで記述
• AIエージェント（Claude Code、Cursor、Codex、GitHub Copilotなど）と連携
• コード生成・修正を仕様に基づいて自動化

はじめ方

1. 本リポジトリをクローンするか、テンプレートとして使用します。
2. spec/ ディレクトリにプロジェクトの仕様をマークダウンで記述します。
3. AIエージェントにこの仕様を読み込ませ、コード生成を依頼します。

ディレクトリ構造

project-root/
├── spec/          # 仕様書（マークダウン）
├── design/        # 設計ドキュメント
├── tasks/         # タスクリスト
├── scripts/       # 自動化スクリプト
└── README.md

使用方法

1. spec/ に仕様を記述（例：spec/api-spec.md）
2. AIエージェントに以下のように指示します：

   @read spec/api-spec.md をもとに、実装を生成してください。
   

3. AIエージェントが仕様に従ってコードを生成します。

対応AIエージェント

• Claude Code
• Cursor
• Codex (OpenAI)
• GitHub Copilot
• その他、ファイルを読み取れるAIアシスタント

ライセンス

MIT