概要

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, …