gr-sw-maker-examples

gr-sw-maker — ほぼ全自動ソフトウェア開発フレームワーク

English

AIコーディングエージェントのマルチエージェント機能を活用して、ソフトウェア開発プロセスをほぼ全自動化するフレームワークです。

ユーザーがやること: コンセプトを書く → 重要判断に答える → 受入テストする。それだけ。

---

クイックスタート

全体の流れはセットアップフローを参照。

1. 入手

# npm から（推奨）
npm init gr-sw-maker my-project
cd my-project

# または GitHub から
git clone https://github.com/GoodRelax/gr-sw-maker.git my-project
cd my-project

2. 言語を選ぶ

node setup.js

メニューから言語を選択してください。他の言語を使いたい場合は言語の選択を参照。

3. AIプラットフォームを選ぶ（Claude Code ならスキップ）

Claude Code 以外の AI を使う場合、移植ガイドを AI に読ませて自動変換を指示してください。

詳細はAIプラットフォームの切り替えを参照。

4. 作りたいものを書く

user-order.md に3つの質問に答えるだけ:

## 何を作りたい？
チームのタスクを管理できるWebアプリ。タスクの作成・担当者割当・期限設定ができて、
ダッシュボードで進捗が見えるようにしたい。

## それはどうして？
チームの作業が属人化しており、誰が何をしているかわからない。
Excelでの管理が限界。

## その他の希望
Webで使いたい。スマホからも確認できるとうれしい。

5. 起動

/full-auto-dev

AI がプロジェクト構成（CLAUDE.md）を自動生成し、あなたに確認を求めます。承認すれば、仕様書作成 → 設計 → 実装 → テスト → 納品まで自動で進行します。

---

開発の流れ

起動後、AI は以下の8フェーズを自動で進行します:

#	フェーズ	AI がやること	ユーザーがやること
1	setup	プロジェクト構成（CLAUDE.md）を生成	確認・承認
2	planning	仕様書を作成、構造化インタビュー	質問に答える、仕様書を承認
3	dependency-selection	外部依存（HW/AI/フレームワーク等）を提案	選定を承認
4	design	アーキテクチャ設計、API設計、セキュリティ設計	—
5	implementation	コード実装、単体テスト	—
6	testing	結合テスト、E2Eテスト、性能テスト	—
7	delivery	マニュアル作成、IaC適用	IaC承認、受入テスト
8	operation	インシデント対応（条件付き）	—

各フェーズの境界で品質ゲート（AI レビュー）を通過しないと次に進めません。問題があれば AI が自動修正します。

---

AIプラットフォーム対応

デフォルトは Claude Code 向けですが、他の AI コーディングエージェントにも移植可能です。

対応状況	プラットフォーム
そのまま使用可	Claude Code
移植ガイドあり	OpenAI Codex CLI, Gemini CLI, Cursor, Windsurf, Cline, Roo Code, Aider

AIプラットフォームの切り替え

対象 AI で process-rules/porting-guide-ja.md を読み込み、自動変換を指示してください。

• ファイルの約70%はポータブル — 変更不要
• 約15%は一括置換（ベンダー名・モデル名・パス）
• 約15%はフォーマット変換（YAML フロントマターのみ — プロンプト本文は流用可能）

この変換ができない AI に本フレームワークを使う能力はありません。

言語選択とプラットフォーム変換の両方が必要な場合は、言語選択 → プラットフォーム変換 の順で実行してください。

---

言語の選択

日本語 / 英語で使う場合

セットアップスクリプトを実行してメニューから選択するだけです:

node setup.js

エージェント定義とコマンドが自動でデプロイされます。

他の言語で使う場合

1. AI に翻訳を指示:

/translate-framework ja fr

1. 翻訳されたファイルをデプロイ:

node setup.js fr

翻訳ルール（何を翻訳し、何を英語のまま残すか）はコマンド内に定義済みです。

---

ドキュメント

文書	内容
プロセス規則	フェーズ定義、エージェント、品質ゲート
文書管理規則	命名、ブロック構造、バージョニング
エージェント一覧	全エージェントの名簿、オーナーシップ、データフロー
移植ガイド	他 AI プラットフォームへの変換仕様
用語集	フレームワーク用語の定義と選定理由
論文	ANMS / ANPS / ANGS 三段階仕様体系の設計根拠

---

セットアップフロー

flowchart TD
    Install["1. npm init gr-sw-maker my-project<br/>cd my-project"] -->|"Run"| Setup([node setup.js])
    Setup -->|"lang code<br/>specified?"| ArgCheck{lang code?}
    ArgCheck -->|"Yes<br/>e.g. node setup.js fr"| Deploy[Deploy files]
    ArgCheck -->|"No"| Menu["Select your environment:<br/>1 en Claude<br/>2 ja Claude<br/>3 Other lang Claude<br/>4 en Other AI<br/>5 ja Other AI<br/>6 Other lang Other AI"]
    Menu -->|"1"| Deploy
    Menu -->|"2"| Deploy
    Menu -->|"3"| ClaudeOther["1. /translate-framework<br/>en your-lang<br/>2. node setup.js your-lang"]
    Menu -->|"4"| Deploy4[Deploy files]
    Menu -->|"5"| Deploy5[Deploy files]
    Menu -->|"6"| OtherAIOther["1. AI reads porting-guide<br/>to convert framework<br/>2. AI translates files<br/>see README<br/>3. node setup.js your-lang"]
    Deploy4 -->|"Complete"| PortingMsg4["NOTE:<br/>Have your AI read<br/>porting-guide-en.md<br/>to convert framework"]
    Deploy5 -->|"Complete"| PortingMsg5["NOTE:<br/>Have your AI read<br/>porting-guide-ja.md<br/>to convert framework"]
    Deploy -->|"Complete"| WriteOrder["2. Write your concept<br/>in user-order.md"]
    PortingMsg4 -->|"Next"| WriteOrder
    PortingMsg5 -->|"Next"| WriteOrder
    WriteOrder -->|"Ready"| Launch["3. /full-auto-dev"]
    Launch -->|"Start"| Dev([Development begins])
    ClaudeOther -->|"Re-run"| Setup
    OtherAIOther -->|"Re-run"| Setup

---

ライセンス

© 2026 GoodRelax. MIT License. LICENSE を参照。

This site is open source. Improve this page.