npm - @careerchain/stdd - Versions diffs - 0.1.0 - Mend

@careerchain/stdd 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (53) hide show

package/assets/.claude/skills/generating-wireframes/templates/screen.html ADDED Viewed

@@ -0,0 +1,480 @@
+<!--
+  screen.html — 1 画面ぶんのワイヤーフレーム ひな型
+  使い方:
+    - このファイルを docs/<app>/<feature_path>/wireframes/<screen>.html としてコピーする。
+    - <head> の <style> がデザインシステム本体。CSS 単体ファイルは作らず、この <style> ごと自己完結させる。
+    - <title> と .wf-screen-label に「画面名 / 状態名」を実値で入れる。
+    - 不要なブロックは削除し、必要なコンポーネント（wf-*）を組み合わせる。
+    - タイトル・ボタン文言・項目ラベルは必ず実値（プレースホルダではなく合意済みの文言）を入れる。
+-->
+<!DOCTYPE html>
+<html lang="ja">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>[画面名] - ワイヤーフレーム</title>
+  <style>
+/*
+ * wireframe.css — STDD 汎用ワイヤーフレーム デザインシステム
+ *
+ * 目的:
+ *   低忠実度（low-fidelity）のワイヤーフレームを、技術スタック非依存の
+ *   素の HTML + CSS で表現するための共通スタイル。
+ *
+ * 方針:
+ *   - グレースケール基調。ブランドカラー・装飾は持たない（実装の自由度を縛らない）。
+ *   - レイアウト・情報設計・主要文言（タイトル / ボタン / 項目ラベル）の合意形成に用いる。
+ *   - モバイルファースト。768px 以上でデスクトップレイアウトに展開する。
+ *   - 各画面 HTML の <head> 内に <style> として直接埋め込む（CSS 単体ファイルは作らない / 自己完結 HTML）。
+ *
+ * 使い方:
+ *   components の各クラス（wf-*）を組み合わせて画面を組む。
+ *   クラス一覧は同ディレクトリの SKILL.md / templates/screen.html を参照。
+ */
+/* ===== Reset / Base ===== */
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+:root {
+  --wf-ink: #2b2b2b;        /* 主要テキスト */
+  --wf-muted: #777;         /* 補助テキスト・プレースホルダ */
+  --wf-line: #c9c9c9;       /* 枠線 */
+  --wf-fill: #f2f2f2;       /* 面（薄） */
+  --wf-fill-2: #e4e4e4;     /* 面（中） */
+  --wf-fill-3: #d2d2d2;     /* 面（濃）/ primary ボタン */
+  --wf-bg: #ffffff;
+  --wf-radius: 4px;
+  --wf-gap: 12px;
+  --wf-pad: 16px;
+}
+body {
+  font-family: -apple-system, "Segoe UI", "Noto Sans JP", "Hiragino Sans", sans-serif;
+  color: var(--wf-ink);
+  background: #eaeaea;
+  line-height: 1.5;
+  font-size: 14px;
+}
+/* ===== ラベル（画面名・状態名の注記） ===== */
+.wf-screen-label {
+  max-width: 1100px;
+  margin: 16px auto 0;
+  padding: 0 16px;
+  font-size: 12px;
+  color: var(--wf-muted);
+  letter-spacing: 0.04em;
+}
+.wf-screen-label strong {
+  color: var(--wf-ink);
+  font-size: 13px;
+}
+/* ===== Page shell ===== */
+.wf-page {
+  max-width: 1100px;
+  margin: 8px auto 32px;
+  background: var(--wf-bg);
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  overflow: hidden;
+}
+/* モバイル枠（幅 390px 固定）でプレビューしたい場合に付与 */
+.wf-page--mobile {
+  max-width: 390px;
+}
+/* ===== Header（グローバルヘッダー） ===== */
+.wf-header {
+  display: flex;
+  align-items: center;
+  gap: var(--wf-gap);
+  padding: 12px var(--wf-pad);
+  border-bottom: 1px solid var(--wf-line);
+  background: var(--wf-fill);
+}
+.wf-header__logo {
+  font-weight: 700;
+  padding: 6px 10px;
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  background: var(--wf-bg);
+}
+.wf-header__nav {
+  display: flex;
+  gap: 16px;
+  flex-wrap: wrap;
+  color: var(--wf-muted);
+}
+.wf-header__spacer { flex: 1; }
+/* ===== Body layout（サイドバー + メイン） ===== */
+.wf-body {
+  display: flex;
+  min-height: 360px;
+}
+.wf-sidebar {
+  width: 200px;
+  flex-shrink: 0;
+  border-right: 1px solid var(--wf-line);
+  background: var(--wf-fill);
+  padding: var(--wf-pad);
+}
+.wf-sidebar__item {
+  padding: 8px 10px;
+  border-radius: var(--wf-radius);
+  color: var(--wf-muted);
+}
+.wf-sidebar__item--active {
+  background: var(--wf-fill-2);
+  color: var(--wf-ink);
+  font-weight: 600;
+}
+.wf-main {
+  flex: 1;
+  padding: var(--wf-pad);
+  min-width: 0;
+}
+/* モバイル: サイドバーは隠してハンバーガー前提（注記用ダミー） */
+@media (max-width: 767px) {
+  .wf-sidebar { display: none; }
+}
+/* ===== 見出し / パンくず / タブ ===== */
+.wf-breadcrumb {
+  color: var(--wf-muted);
+  font-size: 12px;
+  margin-bottom: 8px;
+}
+.wf-title {
+  font-size: 20px;
+  font-weight: 700;
+  margin-bottom: 4px;
+}
+.wf-subtitle {
+  color: var(--wf-muted);
+  margin-bottom: var(--wf-pad);
+}
+.wf-tabs {
+  display: flex;
+  gap: 4px;
+  border-bottom: 1px solid var(--wf-line);
+  margin-bottom: var(--wf-pad);
+}
+.wf-tabs__item {
+  padding: 8px 14px;
+  color: var(--wf-muted);
+  border: 1px solid transparent;
+  border-bottom: none;
+}
+.wf-tabs__item--active {
+  color: var(--wf-ink);
+  font-weight: 600;
+  border-color: var(--wf-line);
+  border-radius: var(--wf-radius) var(--wf-radius) 0 0;
+  background: var(--wf-fill);
+  margin-bottom: -1px;
+}
+/* ===== ツールバー（件数 + アクション） ===== */
+.wf-toolbar {
+  display: flex;
+  align-items: center;
+  gap: var(--wf-gap);
+  flex-wrap: wrap;
+  margin-bottom: var(--wf-pad);
+}
+.wf-toolbar__spacer { flex: 1; }
+.wf-count { color: var(--wf-muted); }
+/* ===== 検索 / フィルタ ===== */
+.wf-search {
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  margin-bottom: var(--wf-pad);
+  overflow: hidden;
+}
+.wf-search__head {
+  padding: 8px var(--wf-pad);
+  background: var(--wf-fill-2);
+  font-weight: 600;
+}
+.wf-search__body {
+  padding: var(--wf-pad);
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: var(--wf-gap);
+}
+@media (min-width: 768px) {
+  .wf-search__body { grid-template-columns: 1fr 1fr; }
+}
+.wf-search__actions {
+  grid-column: 1 / -1;
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+}
+/* ===== Form / Field ===== */
+.wf-form {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: var(--wf-gap);
+}
+@media (min-width: 768px) {
+  .wf-form--2col { grid-template-columns: 1fr 1fr; }
+}
+.wf-field { display: flex; flex-direction: column; gap: 4px; }
+.wf-field--full { grid-column: 1 / -1; }
+.wf-label { font-size: 12px; color: var(--wf-ink); font-weight: 600; }
+.wf-label--required::after { content: " *"; color: var(--wf-muted); }
+.wf-input,
+.wf-select,
+.wf-textarea {
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  background: var(--wf-bg);
+  padding: 8px 10px;
+  color: var(--wf-muted);
+  min-height: 36px;
+}
+.wf-textarea { min-height: 88px; }
+/* セレクトのプルダウン矢印は HTML 側に「▾」を明示的に書く（例: <span class="wf-select">すべて ▾</span>） */
+.wf-help { font-size: 11px; color: var(--wf-muted); }
+.wf-error { font-size: 11px; color: var(--wf-ink); font-weight: 600; }
+/* ===== Buttons ===== */
+.wf-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  min-height: 36px;
+  padding: 8px 16px;
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  background: var(--wf-bg);
+  color: var(--wf-ink);
+  font: inherit;
+  cursor: default;
+}
+.wf-button--primary { background: var(--wf-fill-3); font-weight: 600; }
+.wf-button--ghost { border-color: transparent; color: var(--wf-muted); }
+.wf-button--sm { min-height: 28px; padding: 4px 10px; font-size: 12px; }
+/* ===== Table ===== */
+.wf-table-wrap {
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  overflow-x: auto;
+}
+.wf-table {
+  width: 100%;
+  border-collapse: collapse;
+  min-width: 640px;
+}
+.wf-table th,
+.wf-table td {
+  text-align: left;
+  padding: 10px 12px;
+  border-bottom: 1px solid var(--wf-line);
+  white-space: nowrap;
+}
+.wf-table thead th {
+  background: var(--wf-fill-2);
+  font-weight: 600;
+}
+.wf-table tbody tr:last-child td { border-bottom: none; }
+.wf-table td.wf-td--muted { color: var(--wf-muted); }
+/* ===== Cards / Grid ===== */
+.wf-grid {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: var(--wf-gap);
+}
+@media (min-width: 768px)  { .wf-grid--2 { grid-template-columns: repeat(2, 1fr); } }
+@media (min-width: 1024px) { .wf-grid--3 { grid-template-columns: repeat(3, 1fr); } }
+.wf-card {
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  padding: var(--wf-pad);
+  background: var(--wf-bg);
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.wf-card__title { font-weight: 600; }
+.wf-card__meta { color: var(--wf-muted); font-size: 12px; }
+/* ===== Kanban ===== */
+.wf-kanban {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: var(--wf-gap);
+}
+@media (min-width: 768px) {
+  .wf-kanban--3 { grid-template-columns: repeat(3, 1fr); }
+}
+.wf-kanban__col {
+  background: var(--wf-fill);
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  padding: 10px;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.wf-kanban__head { font-weight: 600; }
+/* ===== Tag / Badge ===== */
+.wf-tag {
+  display: inline-block;
+  padding: 2px 8px;
+  border: 1px solid var(--wf-line);
+  border-radius: 999px;
+  font-size: 11px;
+  color: var(--wf-muted);
+  background: var(--wf-fill);
+}
+/* ===== Placeholder（画像 / アバター） ===== */
+.wf-img {
+  position: relative;
+  background: var(--wf-fill);
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  min-height: 96px;
+}
+.wf-img::after {
+  content: "";
+  position: absolute;
+  inset: 0;
+  background:
+    linear-gradient(to top right, transparent calc(50% - 1px), var(--wf-line), transparent calc(50% + 1px)),
+    linear-gradient(to top left, transparent calc(50% - 1px), var(--wf-line), transparent calc(50% + 1px));
+}
+.wf-avatar {
+  width: 40px;
+  height: 40px;
+  border-radius: 999px;
+  background: var(--wf-fill-2);
+  border: 1px solid var(--wf-line);
+  flex-shrink: 0;
+}
+/* ===== Pagination ===== */
+.wf-pagination {
+  display: flex;
+  justify-content: center;
+  gap: 4px;
+  margin-top: var(--wf-pad);
+}
+.wf-pagination__item {
+  min-width: 32px;
+  min-height: 32px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  color: var(--wf-muted);
+}
+.wf-pagination__item--active {
+  background: var(--wf-fill-2);
+  color: var(--wf-ink);
+  font-weight: 600;
+}
+/* ===== 空状態 / エラー状態 ===== */
+.wf-empty {
+  border: 1px dashed var(--wf-line);
+  border-radius: var(--wf-radius);
+  padding: 40px var(--wf-pad);
+  text-align: center;
+  color: var(--wf-muted);
+}
+/* ===== Modal / Dialog（重ね表示はせず、注記付きで並置） ===== */
+.wf-modal {
+  max-width: 480px;
+  margin: 0 auto;
+  border: 1px solid var(--wf-line);
+  border-radius: var(--wf-radius);
+  background: var(--wf-bg);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
+}
+.wf-modal__head {
+  padding: 12px var(--wf-pad);
+  border-bottom: 1px solid var(--wf-line);
+  font-weight: 600;
+  display: flex;
+  align-items: center;
+}
+.wf-modal__head .wf-toolbar__spacer { flex: 1; }
+.wf-modal__body { padding: var(--wf-pad); display: grid; gap: var(--wf-gap); }
+.wf-modal__foot {
+  padding: 12px var(--wf-pad);
+  border-top: 1px solid var(--wf-line);
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+}
+/* ===== 注記（インタラクション説明など） ===== */
+.wf-note {
+  font-size: 11px;
+  color: var(--wf-muted);
+  border-left: 3px solid var(--wf-line);
+  padding: 2px 8px;
+  margin-top: 6px;
+}
+/* ===== ユーティリティ ===== */
+.wf-row { display: flex; align-items: center; gap: var(--wf-gap); flex-wrap: wrap; }
+.wf-stack { display: flex; flex-direction: column; gap: 8px; }
+.wf-mt { margin-top: var(--wf-pad); }
+.wf-muted { color: var(--wf-muted); }
+  </style>
+</head>
+<body>
+  <p class="wf-screen-label"><strong>[画面名]</strong> ／ 状態: [通常 / 空 / エラー など]</p>
+  <div class="wf-page">
+    <!-- グローバルヘッダー -->
+    <header class="wf-header">
+      <span class="wf-header__logo">[サービス名]</span>
+      <nav class="wf-header__nav">
+        <span>[ナビ1]</span>
+        <span>[ナビ2]</span>
+      </nav>
+      <span class="wf-header__spacer"></span>
+      <span class="wf-button wf-button--sm">[ユーザーメニュー]</span>
+    </header>
+    <div class="wf-body">
+      <!-- 管理画面などはサイドバー、toC で不要なら削除 -->
+      <aside class="wf-sidebar">
+        <div class="wf-sidebar__item wf-sidebar__item--active">[メニュー1]</div>
+        <div class="wf-sidebar__item">[メニュー2]</div>
+        <div class="wf-sidebar__item">[メニュー3]</div>
+      </aside>
+      <main class="wf-main">
+        <div class="wf-breadcrumb">[親] / [現在の画面]</div>
+        <h1 class="wf-title">[画面タイトル]</h1>
+        <p class="wf-subtitle">[画面の説明文（任意）]</p>
+        <!-- ここに wf-search / wf-table / wf-form / wf-grid / wf-kanban などを組む -->
+      </main>
+    </div>
+  </div>
+</body>
+</html>

package/assets/.claude/skills/introducing-stdd/SKILL.md ADDED Viewed

@@ -0,0 +1,185 @@
+---
+name: introducing-stdd
+description: |-
+  既存（稼働中）プロジェクトへの STDD 導入を、Claude セッションで段階的に駆動する。導入ガイドに従い、共通spec生成→機能インベントリ→代表機能リバース→フォーマット策定→機能ループ→順行運用への移行までを、既存スキル（reverse-engineering-common-spec / reverse-engineering-feature-spec / auto-implement / verifying-consistency）を順に呼びながら進める。進捗は導入PLANで保持し、セッションを跨いで再開できる。単一機能のリバースのみなら reverse-engineering-feature-spec を直接使う。
+when_to_use: |-
+  既存（稼働中）プロジェクトへの STDD 導入を進める／再開するとき。「既存プロジェクトにstddを入れる」「導入の続き」「導入ブートストラップ」など、既存フローと確定している場合。新規/既存が未確定の最初の入口は setup-stdd（ルーター）が判定して本スキルへ委譲する。
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+# STDD 導入ドライバー（既存プロジェクト）
+既存プロジェクトへの STDD 導入を、セッションで 1 ステップずつ進めるための**薄い駆動役**。
+自前の実装ロジックは持たず、各ステップで**既存スキルを順に呼び**、人間判断ポイントで停止し、進捗を**導入PLAN**に記録する。
+> 「なぜ」「各ステップで何を判断するか」は [`guide-for-existing-project.md`](../../../packages/core/docs/guide-for-existing-project.md) を参照。
+> 本スキルはその operational な実行役。
+## 設計方針（重要）
+- **agent オーケストレーションはしない**。Claude がメインセッションで手順を進める軽量ドライバー。
+- 導入は一度きり・判断主体のため、**人間を常にループに入れる**（フォーマット策定・優先順・粒度は必ず確認）。
+- 状態は導入PLAN（`docs/common/plans/stdd-introduction.md`）にのみ持つ。本スキルはステートレス。
+---
+## 起動時の動作
+### 1. 導入PLAN の有無を確認
+```
+docs/common/plans/stdd-introduction.md
+```
+- **無い場合 → 初回**: 下記「初回フロー」を実行し、導入PLAN を作成する。
+- **ある場合 → 再開**: 導入PLAN を読み、最初の未チェック項目（`- [ ]`）を「次にやること」として提示し、該当ステップを実行する。
+### 2. 設定確認
+`.stdd.config.yml` を読み、`apps[]` / `docs.layout`（`common_requirements` / `common_architecture` 含む）を把握する。無ければ **step 0（対話的セットアップ）** を実行する（下記「step 0」詳細）。
+---
+## ステップ実行表
+各ステップは「呼ぶスキル」と「停止して人間に確認すること」を持つ。
+| step | 実行内容 | 呼ぶスキル | ★停止して確認 |
+| ---- | -------- | ---------- | ------------- |
+| 0 | `.stdd.config.yml` を対話的に作成（下記「step 0」詳細）/ テンプレ・skill 配置 | — | 構成（単一/複数アプリ・パス規約） |
+| 1 | common ティア生成 | `reverse-engineering-common-spec` | 生成後の `<!-- 要確認 -->` 一覧 |
+| 1.5 | 機能インベントリ + 優先順 → 導入PLAN へ記載 | — | ★ 機能一覧と優先順（P0 から） |
+| 2 | 代表機能 1 つをリバース | `reverse-engineering-feature-spec` | ★ Spec 粒度・スコープ |
+| 3-4 | フォーマット策定 → テンプレ特化 | `tailoring-spec-format` | ★★ フォーマット決定（テーラリング） |
+| 5 | 残り機能を優先順でループ | `reverse-engineering-feature-spec` | ★ 機能ごとの粒度 |
+| 6 | 順行運用へ移行 | `auto-implement`（以降） | 導入完了の確認 |
+各機能リバース後は `verifying-consistency` で spec ⇔ test ⇔ 実装 の整合を確認する。
+---
+## 初回フロー（導入PLAN が無いとき）
+1. **プロジェクト点検**: ディレクトリ構成・`package.json`・ルーティングをざっと把握。
+2. **step 0（対話的セットアップ）**: `.stdd.config.yml` が無ければ、下記「step 0」手順で 点検 → 草案 → 確認 → 書き込み を対話的に行う。
+3. **step 1 実行**: `reverse-engineering-common-spec` を呼び、common ティアを生成。`<!-- 要確認 -->` を一覧化して人間に提示。
+4. **step 1.5（★人間判断）**: ルーティング・主要ドメインから機能を洗い出し、**優先順をユーザーと合意**。
+5. **導入PLAN 生成**: `templates/introduction-plan.md` を雛形に `docs/common/plans/stdd-introduction.md` を作成し、機能を優先順で並べる。
+6. 「次は step 2（代表機能のリバース）」を提示して停止。
+---
+## 再開フロー（導入PLAN があるとき）
+1. 導入PLAN を読み、完了済み（`- [x]`）と未着手（`- [ ]`）を把握。
+2. 最初の未着手項目を「次にやること」として 1 つ提示。
+3. ユーザーの了承後、該当ステップのスキルを呼んで実行。
+4. 完了したら導入PLAN の該当項目を `- [x]` に更新し、フォーマット決定があれば「決定ログ」に追記。
+5. 次の未着手を提示して停止（**一度に 1 ステップ**。バッチ全自動にしない）。
+---
+## step 0: 対話的セットアップ（詳細）
+`.stdd.config.yml` が無いときは、skill 自身が **点検 → 草案 → 確認 → 書き込み** を対話的に行う（サブスキルは呼ばない）。
+### 0-1. リポジトリ点検（自動）
+読み取って構成を推定する:
+```
+□ トップレベル構成 / package.json の workspaces → apps[] 候補（id・path）
+   - monorepo: workspaces 各エントリ、apps/* や packages/* 配下のアプリ
+   - 単一アプリ: ルート構成（id は project 名 または "web" 等）
+□ package.json の scripts → commands（test / typecheck(tsc) / lint / format）
+□ DB 型生成コマンド（例: supabase gen types）→ commands.db_types 候補
+□ git のデフォルトブランチ → project.primary_branch
+□ framework（next / remix / vite / sveltekit 等）→ apps[].framework
+□ 既存 docs/ 構成 → docs.layout のパターン推定
+```
+### 0-2. 草案を提示
+点検結果から `.stdd.config.yml` の草案を生成して提示する。先頭に `yaml-language-server` の schema ディレクティブを付ける。**推定できなかった項目は「要確認」として明示し、ユーザーに尋ねる**。
+```yaml
+# yaml-language-server: $schema=<schema の URL または相対パス>
+project:
+  name: <推定>
+  primary_branch: <git のデフォルトブランチ>
+apps:
+  - id: <推定>          # ^[a-z][a-z0-9_-]*$
+    path: <推定>
+commands:
+  typecheck: <推定>
+  test: <推定>
+docs:
+  layout:
+    common_requirements: docs/common/REQUIREMENTS.md    # common ティアを使う場合のみ
+    common_architecture: docs/common/ARCHITECTURE.md
+    requirements: docs/{{app.id}}/{{feature_path}}/REQUIREMENTS.md
+    tech_design: docs/{{app.id}}/{{feature_path}}/TECH_DESIGN.md
+    plan: docs/{{app.id}}/{{feature_path}}/plans/{{date}}.md
+```
+### 0-3. ★確認（停止）
+書き込み前に、特に次をユーザーに確認する:
+```
+□ 単一 / 複数アプリ、各アプリの id・path
+□ docs.layout のパス規約（単一アプリなら {{app.id}} を省く等の調整）
+□ test / typecheck コマンドが実際に動くか
+□ common ティアを使うか（使うなら common_requirements / common_architecture を含める）
+□ worktree / devcontainer を使うか（workflow セクションを足すか）
+```
+### 0-4. 書き込み & 検証
+- 合意後 `.stdd.config.yml` をリポジトリルートに書き込む。
+- スキーマ検証（`packages/core/README.md`「JSON Schema のローカル検証」の手順）:
+  ```
+  npx -y js-yaml .stdd.config.yml > /tmp/stdd.json
+  npx -y ajv-cli validate -s packages/core/schema/.stdd.config.schema.json -d /tmp/stdd.json
+  ```
+- skill / agent / テンプレの配置（vendoring または参照）が未了なら案内する。
+- 検証が通ったら step 1 へ進む。
+### 完了条件
+```
+□ .stdd.config.yml が存在し schema 検証を通る
+□ 後続ステップが参照する apps / commands / docs.layout が揃っている
+```
+> 配置は `npx @careerchain/stdd init`（カレントディレクトリに `.claude/` と `.stdd.config.yml` を導入）に委譲してよい。未導入なら step 0 はそれを案内する。
+---
+## 守ること
+- **一度に 1 ステップ**。複数機能を無確認で連続処理しない。
+- **★ポイントでは必ず停止**してユーザーに聞く（優先順・粒度・フォーマット）。
+- 遡行フェーズでは「実装が真実」。推測で spec を書かない。
+- 導入PLAN 以外に進捗・履歴を持たない（SSOT 原則。spec 本体に「今回」「変更前」等を書かない）。
+---
+## When NOT to Use This Skill
+- **単一機能のリバースだけ**したい: `reverse-engineering-feature-spec` を直接使う
+- **common ティアだけ**作りたい: `reverse-engineering-common-spec` を直接使う
+- **新規機能を実装**したい（導入済みプロジェクト）: `auto-implement` を使う
+- **新規プロジェクト**（コードがまだ無い）の立ち上げ: `starting-new-with-stdd` を使う
+---
+## 参照ファイル
+- **導入ガイド（なぜ/判断基準）**: [guide-for-existing-project.md](../../../packages/core/docs/guide-for-existing-project.md)
+- **導入PLAN テンプレート**: [templates/introduction-plan.md](templates/introduction-plan.md)
+- **common ティアのリバース**: [reverse-engineering-common-spec skill](../reverse-engineering-common-spec/SKILL.md)
+- **機能単位のリバース**: [reverse-engineering-feature-spec skill](../reverse-engineering-feature-spec/SKILL.md)
+- **フォーマット策定・テーラリング（step 3-4 / 7）**: [tailoring-spec-format skill](../tailoring-spec-format/SKILL.md)
+- **整合性チェック**: [verifying-consistency skill](../verifying-consistency/SKILL.md)
+- **順行運用（新機能実装）**: [auto-implement skill](../auto-implement/SKILL.md)