convez.ai
InicialPluginScore · de 0 a 100

STDD (Spec and Test Driven Development) methodology, skills, and templates for Claude Code

Instalação

$npx convez-ai careerchain-ys/stdd

1 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

Estrelas
2
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 1 semana
Versão
v2.0.0
Issues abertas
1
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

STDD (Spec and Test Driven Development)

npm version npm downloads license

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 ステップの内訳:

  1. 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 由来と判別できます。
  2. claude — Claude Code を起動します。
  3. 「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 を参照してください。


関連ドキュメント

導入ガイド(ユースケース別)

方法論

開発・運用の参考


現状の制約(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 経由で受け付けます。


ライセンス

Apache License 2.0

著作権表記は NOTICE を参照してください。

Ver o original no GitHub

Bom para

Relacionados