initlisted
Install: claude install-skill kompiro/hane
# Host Repo Init Skill
hane の各 skill(`start-dev` / `design-doc` / `acceptance-test` / `test-perspective` /
`qa` など)は、host repo が一定のディレクトリ・ドキュメント慣習を採用していることを
前提に動く。このスキルは、その初期セットアップを対話で行う。
このスキルの価値は「固定のファイルを置くこと」ではなく、**repo ごとに異なる選択を
対話で決め、hane が前提とする慣習の単一の出所になること**にある。選択肢を持たず
固定構造を吐くだけならテンプレート repo やシェルスクリプトで足りる。
## 手順
### 1. 前提確認
- カレントが git repo であることを確認する(でなければ `git init` を提案する)。
- `.gitignore` に `.claude/worktrees/` が含まれているか確認する。無ければ追記を
提案する(`start-dev` / `ship` / `design-doc` がここに worktree を作るため)。
### 2. 既存状態のスキャン
`docs/{design,adr,acceptance,test-perspectives}/`、`docs/process.md`、`.claude/rules/`、
`status: *` ラベルの有無を調べる。**このスキルは冪等**で、既に存在するものは
上書きせず skip する。スキャン結果を踏まえて次の質問を出す。
### 3. 4 つの選択をユーザーに確認
以下を対話で確認する(既に存在するものは「採用済み」として扱い、質問から除いてよい)。
1. **採用するドキュメントディレクトリ** — `docs/design/`(Design Doc)/
`docs/adr/`(ADR)/ `docs/acceptance/`(受け入れテスト)/
`docs/test-perspectives/`(TPL)のうちどれを採用するか。複数選択可。
2. **ADR のファイル名規約** — GitHub 番号ベース(`<番号>-slug.md`、hane の既定。
ADR-8 参照)か、日付ベース(`YYYYMMDD-NN-slug.md`)か。
`docs/adr/` を採用する場合のみ訊く。
3. **`status: *` ラベル運用** — `start-dev` / `ship` が Issue の進捗を
`status: ready / blocked / on-hold / implementing / designing / designed / in-review`
ラベルで追跡する運用を採用するか。
4. **`.claude/rules/` ディレクトリ** — repo 固有の authoring ルール(ADR の言語など)
を置くディレクトリを作るか。
### 4. scaffold する
回答に基づき、以下を生成する。**既存ファイルは上書きしない**(skip して記録する)。
| 選択 | 生成物 |
|---|---|
| `docs/design/` を採用 | `docs/design/TEMPLATE.md` |
| `docs/adr/` を採用 | `docs/adr/TEMPLATE.md`