Skip to content
プロジェクト

shinpr/ai-coding-project-boilerplate

GitHubで見る

shinpr/ai-coding-project-boilerplate has 239 GitHub stars and 28 forks. GitHot measured 0 stars in 24 hours, +3 in 7 days, and +3 in 15 days. Last checked 2026-11-16 23:44 UTC. Last push 2026-11-13.

この数値の測り方

できること

  • Develop with TypeScript, Biome formatting and linting, and Vitest already configured
  • Record project context and quality standards for later sessions and other contributors
  • Turn team knowledge into skills Claude can use when the work calls for them

計測したスター増加

24時間
0
7日間
+3
15日間
+3
1か月
更新が遅れています

期間ごとの純増数です。期間は重複しており、日別の値ではありません。未計測の値は空欄です。スター数は注目度の指標であり、品質の保証ではありません。

概要

Agentic coding TypeScript boilerplate for Claude Code: sub-agent workflows with built-in quality checks and context engineering.

生産性

README.ja.md

オリジナル

AI Coding Project Boilerplate:Claude Codeスターターキット

他の言語で読む: English | 简体中文

TypeScript Node.js Claude Code License: MIT

TypeScriptリポジトリに、Claude Codeを使った開発環境を組み込むスターターキットです。プロジェクト共通のCLAUDE.md、すぐに使えるコマンド、専門エージェント、スキルを導入し、リポジトリ内のルールに沿って開発を進められるようにします。

新しいプロジェクトを作成し、導入したClaude Code環境を継続して更新できます。プロンプトやエージェント定義を一から用意することなく、リポジトリ内でチームと共有・バージョン管理しながら、プロジェクトに合わせて育てられます。

このキットで始められること

  • TypeScript、Biomeによるフォーマット・lint、Vitestによるテストが設定済みの環境で開発を始める
  • プロジェクトの前提や品質基準を記録し、別のセッションや担当者でも使う
  • チームの知識をスキルとして追加し、必要な作業で参照する

クイックスタート

Node.js 26.12.1以上、pnpm、Claude Codeを事前にインストールしてください。

新しいプロジェクトを作成する

npx create-ai-project my-project --lang=ja
cd my-project
pnpm install
claude

英語や簡体字中国語のワークフローを使う場合は、作成時に--lang=enまたは--lang=zh-CNを指定します。

最初の変更を進める

Claude Codeを起動したら、次のコマンドを実行します。

/project-inject
/implement APIにレート制限を追加

初回に/project-injectでプロジェクトの前提情報を記録します。

/implementは、依頼内容を整理し、既存のコードを調べます。単純な変更は設計書を作らずに進められます。設計上の判断が必要な場合は、設計と計画を作成し、承認を待ってから実装します。その後、該当するチェックを実行し、中・大規模の変更では実装のレビューも行います。

導入手順と初回実行の詳しい流れはクイックスタートを参照してください。

用途に合うコマンドを選ぶ

やりたいこと コマンド
依頼内容の整理から実装、検証まで進める /implement
範囲が明確な変更に取り組む /task
実装前に変更内容を設計する /design, /front-design
承認済みの設計から実行可能な計画を作る /plan, /front-plan
承認済みの計画に沿って実装を進める /build, /front-build
完了した実装が合意した成果とリポジトリの基準を満たしているか確認する /review, /front-review
コードを変更せず、修正方法を決める前に問題を調査する /diagnose

先に設計し、後から実装する

/design APIにレート制限を追加
/plan
/build

設計コマンドは承認を待って停止します。承認済みのドキュメントを使い、後から別のセッションや担当者が計画と実装を続けられます。計画には、各タスクで実現する内容と検証方法が記録されるため、それまでの会話をたどり直さずに引き継げます。

フロントエンドでは、次のコマンドを使います。

/front-design ユーザープロフィールのダッシュボードを追加
/front-plan
/front-build

使用例とすべてのコマンドはユースケースとコマンドを参照してください。

ワークフローモード

既定はNormalモードです。独立したチェックやエージェントの呼び出し回数を減らしたい場合は、Liteモードを選べます。設計書とコードの照合、設計書間の整合性検証、独立したセキュリティレビューを省略します。計画に沿って進める実装では、Normalモードはタスクごとにlintやテストなどの品質チェックを行います。Liteモードは実装の最後にまとめて行ってから、コードレビューへ進みます。

Claudeによる実装内容の確認、必要なテストのレビュー、コードレビューは引き続き行います。承認も同じタイミングで求めます。小さな変更や、レビュー後の修正にも通常の品質チェックを行います。

Liteモードをプロジェクトの既定値にするには、プロジェクトルートで実行します。

node scripts/set-workflow-mode.js lite

設定はCLAUDE.mdに保存されるため、次回からは依頼のたびにモードを指定する必要がありません。Normalモードに戻すには、node scripts/set-workflow-mode.js normalを実行します。会話の中で明示したモードはプロジェクトの既定値より優先され、変更を伝えるまでそのセッションで有効です。

プロジェクトに合わせて育てる

/project-injectで、プロジェクトの目的、制約、品質基準、開発上の規約、外部資料の参照先を記録します。前提が変わったら再実行してください。

特定の作業でだけ使うチームの知識や判断基準は、/create-skillや/refine-skillで追加・改善できます。情報を置く場所の判断や、利用前のレビューもこれらのコマンドで行います。具体例はスキル編集ガイドを参照してください。

Claude Code環境を更新する

このスターターキットで作成したプロジェクトのルートで、更新内容を確認してから適用します。

npx create-ai-project update --dry-run
npx create-ai-project update
claude

管理対象のClaude Codeのルール、コマンド、エージェント、スキルを置き換えます。更新対象のファイルに加えた編集も上書きされます。ソースコードと既存のpackage.json設定、保存したワークフローモードは保持します。

更新前に、プロジェクト独自のルールとスキルの変更をコミットしてください。/project-inject、/create-skill、/refine-skillで加えた変更も含みます。更新後は差分を確認し、残したい独自設定を手動で再適用します。更新手順の詳細はクイックスタートを参照してください。

ガイド

ライセンス

MIT