SPECC.SH — Spec Driven AIフルスタックテンプレート
luckyyyyy/specc.sh
★ 62
概要
specc.shは「Spec Coding beats Vibe Coding」を掲げる、仕様（Spec）主導でAIにコードを書かせるフルスタックテンプレートです。リポジトリはTypeScriptで構成され、デモサイト（https://specc.sh）や中国語ドキュメントを備え、MITライセンスで公開されています。目的は「手でコードを書く時間を減らし、AIが生成したコードをベースに開発を進める」ことで、プロダクション品質を目指したテンプレート・ワークフローを提供します。テンプレートはローカル開発からデプロイまでの一連の流れを想定しており、仕様の記述、AIによる生成、手動レビュー、テスト・CIへの組み込みまでを見据えた設計が特徴です。
リポジトリの統計情報
- スター数: 16
- フォーク数: 1
- ウォッチャー数: 16
- コミット数: 12
- ファイル数: 15
- メインの言語: TypeScript
主な特徴
- 仕様（Spec）を起点にAIでコードを生成する「Spec-First」アプローチ
- フルスタック向けのTypeScriptテンプレート（デモサイトあり）
- 開発運用を想定した環境定義（.env.example、Makefile 等）とMITライセンス
- 言語別ドキュメント（README.zh.md など）やデモによる導入ハードルの低さ
技術的なポイント
specc.shの核は「仕様を書き、AIにその仕様に沿った実装を生成させる」ワークフローにあります。これにより、従来の手作業で詳細実装を詰める工程（いわゆるvibe coding）を減らし、仕様の明確化・再利用性・ドキュメント化を同時に実現します。技術的にはTypeScriptを中心にフルスタック構成を想定しており、環境変数管理のための .env.example、ビルドやデプロイのためのMakefile、CI/CD設定を置く .github ディレクトリなど、開発から運用までの流れをサポートするファイルが揃っています。
LLM（大規模言語モデル）との連携は設計上の主要要素で、仕様→プロンプト→生成コードというパイプラインをプロンプトテンプレートやプロンプト設計（Prompt Engineering）によって安定化させることが重要です。実運用を意識する場合、生成物の品質管理としてユニットテストや型チェック（TypeScriptの利点）、フォーマッタ・リンタ、静的解析を組み合わせ、AI生成コードの信頼性を高めます。また、生成の再現性やトレーサビリティ確保のために、仕様（Spec）自体をバージョン管理し、生成時のプロンプトやモデルパラメータをログとして残す運用が推奨されます。
さらに、人間のレビュープロセスを前提に、AI出力をそのまま本番に流すのではなくレビュー→修正→自動テストのサイクルを確立する設計思想が反映されています。.env.exampleやMakefileは開発者がローカルで同一の環境を素早く再現するために有用で、.github 配下のワークフローを利用して生成・テスト・デプロイを自動化することで、AI生成コードを継続的に安全に運用することが可能です。総じて、specc.shは「仕様を中心としたAI活用」を実践するためのテンプレートとワークフローのベースを提供します。
プロジェクトの構成
主要なファイルとディレクトリ：
- .env.example: file
- .github: dir
- .gitignore: file
- LICENSE: file
- Makefile: file
…他 10 ファイル
まとめ
仕様主導のAI開発を始めるための実用的なTypeScriptベースのテンプレートです（約50字）。
リポジトリ情報：
- 名前: specc.sh
- 説明: Spec Coding beats Vibe Coding. A full-stack AI template for production-grade code.
- スター数: 16
- 言語: TypeScript
- URL: https://github.com/luckyyyyy/specc.sh
- オーナー: luckyyyyy
- アバター: https://avatars.githubusercontent.com/u/9210430?v=4
READMEの抜粋：
Why Is Vibe Coding So Hard to Get Right?
Everyone’s tried it. You open Claude Code or Cursor, describe what you want, …
