@careerchain/stdd

STDD (Spec and Test Driven Development) を既存・新規どちらのプロジェクトにも 1 コマンドで導入する CLI です。

選んだエージェントのビュー（Claude=.claude/、Codex=.agents/skills・.codex/・AGENTS.md）と .stdd.config.yml・docs/ を現在のディレクトリに配置します。各ビューは stdd 本体の単一 SSoT（packages/core）から生成されたものです。

使い方

cd my-project        # 既存プロジェクト、または新規の空ディレクトリ
npx @careerchain/stdd init   # STDD 一式を導入（既定 both。--agent claude|codex|both）
claude               # Claude Code（または codex）を起動

起動後、Claude Code / Codex に「STDD を導入して」と伝えると、setup-stdd スキルが新規 / 既存を自動判定し、 適切な駆動スキル（新規=starting-new-with-stdd / 既存=introducing-stdd）へ委譲します。

コマンド

npx @careerchain/stdd init [options]

グローバルにインストール（npm i -g @careerchain/stdd）した場合は stdd init として実行できます。

| option | 説明 | | --- | --- | | --agent <claude\|codex\|both> | 導入するエージェントビュー（既定: both） | | --name <name> | .stdd.config.yml の project.name（既定: ディレクトリ名） | | --force | tailoring 済み（編集された）STDD ファイルも最新へ上書きする | | --yes, -y | 対話プロンプトをスキップし既定値で進める | | --help, -h | ヘルプを表示 | | --version, -v | バージョンを表示 |

挙動

各エージェントのビューをディレクトリ単位ではなくファイル単位で非破壊マージします。既存設定や ユーザー自作ファイルを汚染しません。

Claude ビュー（--agent claude|both）:

• .claude/（skill / agent / hook / rules）: STDD が配布するファイルだけを作成・更新します。
  • ユーザー自作ファイル（STDD パスと衝突しない）はそのまま保持。
  • STDD パスにユーザーが置いた同名ファイルは上書きせず skip（手動確認を促す）。
  • ユーザーが編集（tailoring）した STDD ファイルは保持（最新化したい場合のみ --force）。
  • 配布から外れた旧 STDD ファイル（未編集）は掃除します。
• .claude/settings.json: deep-merge。permissions.allow / enabledMcpjsonServers / hooks は union、スカラー競合はユーザー値を優先し、STDD の不足設定のみ追記します。
• .mcp.json: 無ければ生成、既存は保持。

Codex ビュー（--agent codex|both）:

• .agents/skills（同一 SKILL.md 標準）・.codex/agents（TOML）・.codex/hooks + .codex/hooks.json: Claude ビューと同じ非破壊マージ（衝突 skip・tailoring 保持・orphan 掃除）。
• AGENTS.md: spec-first ルールをマーカーブロック（STDD:BEGIN/END）で非破壊注入。既存本文は保持し、ブロックのみ更新（冪等）。
• .codex/config.toml（MCP）: 無ければ生成、既存は保持。

共通:

• .stdd.config.yml: 無ければ生成、既存は保持。
• docs/: 無ければ作成。

STDD 由来の明示

導入物は以下で「STDD 由来」と判別できます。

• manifest: Claude=.claude/.stdd/manifest.json、Codex=.stdd/codex-manifest.json。導入した全ファイルの相対パス・sha256・source: "stdd" を記録（更新時の差分・編集検出・将来のアンインストールに利用）。
• frontmatter マーカー: Claude ビューの各 skill / agent 先頭に source: stdd を付与。

ライセンス

Apache License 2.0