touchstone

Touchstoneは、GitHubプロジェクト群で複数のAIエージェントを指揮するソロ開発者のための基準を確立します。コアコンポーネントは2つ：ワークフロースタンダード（ブランチ作成優先、単一関心コミット、必須ファインディング解決、ゲートコンプライアンス）をエージェントに指示するガイドランスプロンプト、および正しいGitHub使用パターンを強制するプッシュツール（CLI）。このシステムは設定後放置可能な採用により開発フローを標準化し、リポジトリは追加介入なしに正しい状態を維持します。 CLIは宣言されたプロジェクトチェックを検証し、トラッカー主張を確認し、GitHubポリシーを適用し、4つの制約付きPR操作（open, status, merge, answer）を提供します。コードのステージング・コミット・プッシュは行わず、GitHubのマージ決定を置き換えることもありません。すべての操作には文書化されたraw git/ghリカバリ経路が含まれます。Touchstoneは3つの原則で動作します：GitHubルールによるデフォルトブランチへの制約（直接/強制/未レビューのプッシュを拒否）、ネイティブGitHubインターフェース（git, PR, issues）を通じた状態の可視化、全プロジェクト・エージェントにわたる一貫したルールの維持。 主要な運用ルールとして、実際の強制が可能なレイヤーで実施する必要があります（GitHubがルールセット/必須チェックを処理し、スクリプトは観察とシーケンスのみを担当）。マージゲートはexact-head判定システムを実装：レビューゲートワークフローは、現在のPRヘッドにバインドされた信頼できるクリーンな判定の場合にのみ成功します。インストールはHomebrew（macOS）またはプラットフォーム非依存のリリーススクリプトで実施。採用にはプロジェクト事実の宣言と、文書化されたコマンドによる監査済みGitHubポリシーの適用が必要です。