zenforge-init

zenforge-init — リポジトリのスキャフォールディングエンジン

運用上の不変条件

• 変更前ゲート：不足しているアセットのみをChangesetで厳密にステージし、人間の承認を得るまでターンを停止します。有効な既存設定を上書きしてはいけません。
• プライバシーの基本方針：.agents/scratch/、.agents/dev-environment.md、および旧式の.agents/host-toolchain.mdは、常に.gitignoreで除外します。一時的なスクラッチファイル、マシン固有の環境プロファイル、シークレットのコミットを禁止します。

ドメイン別ルーブリック

1. タスクトラッカーの判定表（.agents/task-tracker.md）

• リモートがGitHubで、gh auth statusが有効 ──> GitHub Issues（gh）（テンプレートreferences/issue-tracker-github.md）またはローカルMarkdownを提案します。
• リモートがGitLabで、glab auth statusが有効 ──> GitLab Issues（glab）（テンプレートreferences/issue-tracker-gitlab.md）またはローカルMarkdownを提案します。
• CLIが未認証／その他のリモート／オフライン ──> ローカルMarkdown（.agents/tasks/、テンプレートreferences/issue-tracker-local.md）を提案します。ユーザーが認証するかローカルで続けるかを選べるよう、CLIの認証状態を報告します。

2. ハーネスアンカー（.agents/harness-anchor.md）

テンプレートreferences/harness-anchor.mdを使用して、ハーネスアンカーを提案します。

• SSOTの検出：既存のテストガイド（test/AGENTS.md、tests/AGENTS.md、docs/**/testing*.md、<subsystem>/test/AGENTS.md）をスキャンします。内容を転記せずに、検出したすべてのSSOTパスを、相対パスとして「Governing Testing SSOTs」に記録します。これにより、古いコピーを防ぎ、エージェントを信頼できる情報源へ直接誘導できます。
• エルメティックプリミティブの検出：テストヘルパーディレクトリ（test/helpers/、test/fixtures/）をスキャンし、既存の基盤ヘルパーをHermetic Primitives Registryに登録します。

3. 開発環境とホストプロファイル（.agents/dev-environment.md）

テンプレートreferences/dev-environment.mdを使用して、開発環境プロファイルを提案します。scripts/discover-toolchain.shを使用して、## 1. Toolchain & Environmentセクションを作成または置換します（--fileのデフォルトは.agents/dev-environment.mdで、存在する場合は.agents/host-toolchain.mdにフォールバックし、対象が.gitignoreに含まれるようにします）。有効なランタイムラッパー、標準のテスト／解析コマンド、インストール済みのホストCLIを記録します。該当しないセクション（サービス、データストア）は省略できます。

4. Gitのプライバシー設定（.gitignore）

• .agents/scratch/：プライベートなスクラッチパッド（変更不可）。
• .agents/dev-environment.md / .agents/host-toolchain.md：マシン固有の環境およびツールチェーンのプロファイル（変更不可）。
• .agents/tasks/：ローカルMarkdownを使用する場合のデフォルトはローカル限定とします。ユーザーがチーム共有のトラッキングを希望する場合は除外します。

5. ドキュメント配置の判定表（docs/README.md）

# Documentation Index & Placement Matrix

| Topic / Scope | Authoritative SSOT | Responsibility |
| :--- | :--- | :--- |
| **Tasks & Execution** | Defined in `.agents/task-tracker.md` | Decomposed task units and progress tracking |
| **Testing Governance** | Defined in `.agents/harness-anchor.md` | Test harness infrastructure and invariant testing |
| **Documentation Governance** | `docs/` | Governed via `/ssot` |

6. エージェント憲章フック（AGENTS.mdまたはCLAUDE.md）

CLAUDE.mdが存在する場合はそれを対象とし、そうでなければAGENTS.mdを対象とします（存在しない場合は作成します）。対象ファイルが存在する場合は、上書きせずに次のブロックを追記します。

## Agent Workflow
- **Dev Environment**: Governed by `.agents/dev-environment.md` (local runners, zero-touch for `.env*` secrets).
- **Task Tracker**: Governed by `.agents/task-tracker.md`.
- **Harness Anchor**: Governed by `.agents/harness-anchor.md` (via `/harness-audit`).
- **Documentation**: Governed by `docs/README.md` (via `/ssot`).

ルーティング

• 呼び出し元がセットアップ後の設計検討を求めている → （/clarify経由）。
• 呼び出し元がハーネスの健全性検査を求めている → （/harness-audit経由）。
• 呼び出し元がドキュメントの権威性レビューを求めている → （/ssot経由）。

実行プロトコル

フェーズ 1：読み取り専用の調査

1. リモートとトポロジー：git remote -v を実行し、ホストとリポジトリのパス（owner/repo）を特定します。

2. ツールチェーンの事前確認：bash scripts/discover-toolchain.sh <path_to_repository> --dry-run を実行し、トラッカー CLI の認証（gh / glab）、推定されるランタイムラッパー、テスト／分析コマンド、およびインストール済みのホストツールを、ディスクを変更せずに確認します。

3. ワークスペースの状況：

   • AGENTS.md と CLAUDE.md を確認します（既存のものは維持し、重複作成は禁止します）。
   • .gitignore、.agents/dev-environment.md（または .agents/host-toolchain.md）、.agents/task-tracker.md、.agents/harness-anchor.md、.agents/tasks/ を確認します。
   • 既存のドキュメント（docs/README.md または README.md）を調べます。

4. クリーンパスの短絡処理：すべての足場アセット（.agents/dev-environment.md / .agents/host-toolchain.md、.agents/task-tracker.md、.agents/harness-anchor.md、.gitignore のプライバシールール、docs/README.md、および constitution hook）がすでに設定済みで有効な場合、次のように報告します。

   Repository ecosystem is already initialized and up-to-date.
   
   

   冗長な変更をステージングせず、直ちにターンを終了します。

フェーズ 2：ステージングと承認ゲート

1. 不足している、または未設定の足場アセットを Changeset 形式でステージングします。

   # Changeset: Repository Initialization
   
   |-- .agents/
   |   |-- dev-environment.md
   |   |   `-- [CREATE] Record machine-local environment, toolchains, and service contracts.
   |   |-- task-tracker.md
   |   |   `-- [CREATE] Configure task tracking mode and execution protocols.
   |   `-- harness-anchor.md
   |       `-- [CREATE] Establish test SSOT routing and hermetic primitives registry.
   |-- docs/README.md
   |   `-- [<ACTION>] Establish documentation Placement Matrix.
   |-- .gitignore
   |   `-- [<ACTION>] Add .agents/scratch/, .agents/dev-environment.md, and .agents/tasks/ privacy rules.
   `-- <AGENTS.md | CLAUDE.md>
       `-- [<ACTION>] Add agent workflow, secret privacy rules, and documentation pointers.
   
   Summary: <N> files affected (<C> created, <U> updated).
   

2. Changeset の概要、推奨するトラッカーの選択肢、ツールチェーンの状態を提示します（CLI が未認証の場合は認証状態を報告します）。ファイルの生の内容をチャットに出力することは禁止します。

3. 人間の承認を求めて直ちにターンを終了します。明示的な承認なしに、ディスク上のワークスペースファイルを変更することは禁止します。

フェーズ 3：一括適用と引き継ぎ

1. 承認を受けたら、ステージングしたファイルをディスクに書き込み、bash scripts/discover-toolchain.sh <path_to_repository> [--file <path.md>] を実行して .agents/dev-environment.md を作成または更新し、.gitignore に登録します。
2. セットアップの完了と、呼び出し元に関係する未対応事項を報告します。