AI Navigate

AI に、いかなるコードを書き始める前にも質問させるフレームワークを作った

Dev.to / 2026/3/22

📰 ニュースDeveloper Stack & InfrastructureTools & Practical Usage

要点

  • この記事は、AI のコーディングツールが思慮深い設計よりも速度を優先すると主張し、90秒で40ファイルを作成し、理解もデバッグも不可能になった急ぎの認証プロジェクトを挙げている。
  • 核心的な問題を特定する:経験豊富な開発者は質問を投げ、選択肢を評価し、エッジケースを表面化し、コードを書く前にアーキテクチャを計画する一方、AIツールはこれらのステップを省くことが多い。
  • 著者は Spec-Kit-CoLearn というオープンソースのフレームワークを紹介しており、AIを最初にシニアアーキテクトとして動作させ、二番手としてコーディング作業を行う。
  • このフレームワークは2つのモードを提供する。 Senior Architect(デフォルト)では、AI が探索的な質問を投げかけ、トレードオフを含む設計オプションを提示し、エッジケースを表面化し、コードを書かずに成功基準を定義する。 Coding Worker は、タスク承認後に有効化され、コードを作成しテストを実行する。
  • Teaching Mode は、設計の選択肢(例: JWT とセッション)についてユーザーを教育し、直ちにコードを生成する代わりに設計を教える点を強調している。
これだけで数週間分の書き直しを節約します。

学習ログ

各機能ごとに、AI が学習ログを生成します:

## What You Learned:

| Term         | Definition                              |
|--------------|-----------------------------------------|
| JWT          | Stateless token for API authentication  |
| OAuth 2.0    | Third-party login protocol              |
| Sessions     | Server-side user state storage          |
| Bcrypt       | Password hashing with built-in salt     |
| httpOnly     | Cookie JavaScript cannot read (XSS safe)|

コードを公開するだけではなく、理解を届けます。

完全なワークフロー

1. pip install spec-kit-colearn
2. spec-kit-colearn init my-project
3. Open any AI coding tool
4. Paste activation prompt
5. Tell AI what you want (vague is fine!)
6. AI asks questions → teaches concepts
7. You choose from 3 options
8. Say "approved"
9. AI creates spec → plan → tasks
10. Say "tasks approved"
11. AI switches to Mode 2 → codes task by task
12. Learning log generated ✅

インストール

# Python
pip install spec-kit-colearn

# JavaScript / Node
npm install -g @muhammad-hamid-raza/spec-kit-colearn

# Initialize project
spec-kit-colearn init my-project

すべてのAIツールと連携

AI ツール サポート
Claude Code
Codex CLI
Gemini CLI
GitHub Copilot
Cursor
Windsurf
Qwen CLI

この製品は誰のためのものですか?

非開発者 — アイデアはあるがコードは書けない?
AI が一歩ずつ導き、道中で教えてくれます。

ジュニア開発者 — アーキテクチャを学ぶ、構文だけでなく。
HOW の前に WHY を理解する。

シニア開発者 — 構造化されたワークフロー、明確なドキュメント、もう「ただ書くだけ」の混乱はありません。

リンク

⭐ GitHub: https://github.com/MuhammadHamidRaza/spec-kit-colearn
PyPI: https://pypi.org/project/spec-kit-colearn
npm: https://npmjs.com/package/@muhammad-hamid-raza/spec-kit-colearn

MITライセンス。永久無料。ご寄稿を歓迎します。

最後の考え

AI はあなたの 思考パートナー であるべきです。
単なるコード生成ツールではありません。

明確さをもって構築する。
自信を持って公開する。
道中で学ぶ。

パキスタン産で
コメント欄でのフィードバックを歓迎します!