stdd
careerchain-ys/stdd
STDD (Spec and Test Driven Development) methodology, skills, and templates for Claude Code
Instalação
npx convez-ai careerchain-ys/stdd1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
STDD (Spec and Test Driven Development)
STDD は、AI エージェントと人間の開発者が協働して仕様駆動・テスト駆動でソフトウェアを開発するための 方法論・テンプレート・skill / agent 群 を提供する OSS プロジェクトです。
npx @careerchain/stdd init # 既存・新規どちらのプロジェクトにも STDD を導入
「Spec → Test → Implementation」を一方向に流す開発フローを軸に、Spec / Plan / Test / Code の整合性を AI エージェントが継続的に検証することで、プロジェクトの規模が拡大し、開発が長期にわたり継続しても、一貫したドキュメントとプロジェクトが両立できる開発体験を目指しています。
STDD の始め方
新規・既存のどちらでも手順は同じです。STDD を導入して Claude Code に「導入して」と伝えるだけ。
新規 / 既存の判定はルータースキル (setup-stdd) が自動で行い、適切な駆動スキルへ振り分けます。
cd my-project # 既存プロジェクト、または新規の空ディレクトリ
npx @careerchain/stdd init # ① STDD 一式を現在のディレクトリに導入
claude # ② Claude Code を起動
# ③ 「STDD を導入して」と伝える
3 ステップの内訳:
npx @careerchain/stdd init—.claude/(skill / agent / hook)・.stdd.config.yml・docs/を現在のディレクトリに配置します。.claude/はファイル単位で非破壊マージ(既存の Claude 設定やユーザー自作 skill を汚染しない/settings.jsonは deep-merge)。導入物は.claude/.stdd/manifest.jsonと各ファイルのsource: stddマーカーで STDD 由来と判別できます。claude— Claude Code を起動します。- 「STDD を導入して」 —
setup-stddルーターがコードの有無を調べ、確認のうえ次へ委譲します。
| 判定 | 委譲先スキル | 駆動するフロー | 手順ガイド |
|---|---|---|---|
| 新規(コードなし) | starting-new-with-stdd | アプリ骨組み → common 設計 → 最初の feature → フォーマット策定 → feature ループ | guide-for-new-project.md |
| 既存(コードあり) | introducing-stdd | 共通spec 逆生成 → 機能インベントリ → 代表機能リバース → フォーマット策定 → 機能ループ → 順行運用 | guide-for-existing-project.md |
進捗は docs/common/plans/(新規=stdd-bootstrap.md / 既存=stdd-introduction.md)に保持され、セッションを跨いで再開できます。
新規 / 既存が明確な場合は、ルーターを介さず starting-new-with-stdd / introducing-stdd を直接指名しても構いません。
ディレクトリ構成
stdd/
├── README.md # 本ファイル
├── AGENTS.md # AI エージェント設定(agents.md 標準準拠)
├── LICENSE # Apache License 2.0
├── NOTICE # 著作権表記
├── packages/
│ ├── core/ # 方法論ドキュメント / JSON Schema
│ │ ├── docs/ # methodology / 各導入ガイド / workflow-diagram
│ │ └── schema/
│ └── stdd/ # 導入 CLI(npm パッケージ `@careerchain/stdd`)
├── templates/ # 参照用プロジェクトテンプレート
│ ├── minimal/ # 最小構成テンプレート
│ └── nextjs-supabase-starter/ # Next.js + Supabase スターター(プラグイン同梱)
├── plugins/ # 技術スタック別プラグイン
│ ├── nextjs-supabase/ # Next.js + Supabase 向け skill
│ ├── playwright/ # Playwright E2E 向け skill
│ └── worktree/ # git worktree + devcontainer 向け skill
├── .claude/ # Claude Code 用ファイル群
│ ├── agents/ # エージェント定義
│ └── skills/ # core skill 群(spec / PLAN テンプレート同梱)
└── docs/ # 方針・オーサリング規約ドキュメント
各プラグインディレクトリには plugin.json(プラグインメタデータ)と skills/ が含まれます。プラグインの分離方針は docs/plugin-separation-policy.md を参照してください。
関連ドキュメント
導入ガイド(ユースケース別)
packages/core/docs/guide-for-new-project.md— 新規プロジェクトの立ち上げ(最初から順行)packages/core/docs/guide-for-existing-project.md— 既存プロジェクトへの導入(遡行ブートストラップ → 順行)
方法論
packages/core/docs/stdd-methodology.md— STDD 方法論(Spec の 2 階層構造・テスト戦略・開発フロー)packages/core/docs/workflow-diagram.md— 開発フロー図
開発・運用の参考
AGENTS.md— AI エージェント向けのプロジェクト情報packages/core/README.md— core パッケージ・.stdd.config.ymlの詳細docs/plugin-separation-policy.md— プラグイン分離方針・core skill 一覧docs/config-driven-authoring.md— skill / agent / hook の設定駆動オーサリング規約SECURITY.md— セキュリティ脆弱性の報告経路
現状の制約(v0.1.4 時点)
- 対象は「ブラウザで操作する Web アプリ」に限定しています。方法論・テンプレート自体は技術スタック非依存で、任意の Web フレームワーク(Next.js / Rails / Django / Laravel など)で立ち上げられますが、QA フローのブラウザ動作確認(Playwright MCP)やワイヤーフレーム / UI キャプチャがブラウザ UI を前提とするため、ネイティブモバイルアプリ(React Native 等)や UI を持たない CLI / バックエンド専用サービスは現状の主対象外です。
- 公式に対応している AI エージェントは Claude Code のみです(
.claude/agents/および.claude/skills/配下のファイルがそのまま動作)。他エージェントは agents.md 標準に準拠したAGENTS.mdを提供しているため随時対応を検討中です。
コントリビューションについて
本リポジトリは read-only 配布 です。外部からの Issue / Pull Request / コミュニティ貢献は受け付けていません(Apache License 2.0 の範囲で自由に fork・利用できます)。
例外として、セキュリティ脆弱性の報告のみ SECURITY.md に記載の GitHub Private Vulnerability Reporting 経由で受け付けます。
ライセンス
著作権表記は NOTICE を参照してください。