architecture: governance・Actions・agent memoryの所有境界を確定する

[kazukinakai]

Problem / outcome

Organization policy、reusable GitHub Actions、Ruleset更新、agent共通workflow、memory/runtime stateの所有境界が複数repoと二重checkoutにまたがり、何を統合し何を分離するかが明文化されていない。現行consumerと権限境界を監査し、移行可能なtarget topologyと単一責務Issueを確定する。

Evidence and current behavior

• /Users/kazuki/github/agiletec-inc/.github と org-governance は同じremote commitを持つ独立checkoutで、前者の旧 .github.git URLは org-governance へredirectされる。
• github-actions はreusable workflow実装を所有し、org-governance はpolicy、starter workflow、Ruleset運用文書を所有する。
• Ruleset workflow pin更新の未追跡テストが org-governance/tests/test_ruleset_workflow_pin.py にあり、github-actions 側には関連PRが存在する。
• agent-harness はClaude/Codex/Geminiのworktree作成を <repo>/.worktrees/<slug> に機械強制済みだが、workspace直下に旧standalone cloneが残る。
• MindBaseはmemory storage、agent-harnessはSessionEnd収集hook、AIRIS MCP GatewayはMCP集約を所有し、cross-provider memoryのauthorityが未決定。

Reproduction or baseline

各repoのremote、consumer workflow、Ruleset API、install target、runtime stateを列挙すると、同名・類似機能でもrelease unitとcredential authorityが異なる。現在は全体のowner mapと削除条件がない。

Expected behavior

policy/authority、reusable execution artifact、agent runtime distribution、memory data、MCP transportのownerを明示し、統合は同じlifecycleとauthorityを持つものだけに限定する。二重checkoutと旧runtime pathには安全なretirement手順を用意する。

Scope

org-governance、github-actions、agent-harness、mindbase、airis-mcp-gatewayのread-only consumer/authority監査、policies/配下の設計書、後続Issue分割。

Non-goals

このIssueだけでrepo rename/archive、Ruleset変更、credential移動、memory本番データ移行を実行しない。AIRIS製品仕様をgovernance repoへ移さない。

Acceptance criteria

• AC-1: 各capabilityのpurpose、authority、consumer、release unit、credential、failure boundaryをpath/API証拠付きで記録する。
• AC-2: 最大2案のtarget topologyを比較し、統合・分離・retireの決定と却下理由を記録する。
• AC-3: .github二重checkout、workspace直下の旧worktree、Ruleset pin writerについて未コミット保全を含む移行順序を定義する。
• AC-4: cross-provider memoryはsource data、index、収集adapter、検索API、MCP transportを分け、MindBase／direct client／Gatewayの採否条件を定義する。
• AC-5: 決定後の実装をrepo別・単一PR粒度のchild Issueへ分割し、negative boundary/drift gateを各Issueに含める。

Verification plan

Criterion	Verification	Expected
AC-1, AC-2	design review against live remotes/API and consumer grep	owner不明・循環依存なし
AC-3	git worktree list --porcelain と全checkout git status --short	削除対象と保全対象を区別
AC-4	provider別capture/search fixture plan	Gateway停止時もmemory authorityを失わない
AC-5	GitHub native sub-issue graph	各leafが1 repo・1 outcome・検証可能

Risks, dependencies, rollout

Ruleset writerはorganization権限を持つため、CI workflow repoへgeneric credentialを置かない。memoryには会話・PIIが含まれ得るため、Git管理・org-wide SaaS送信を既定にしない。repo統合はconsumer pinを段階移行し、旧契約削除を最後にする。

Clarifications and assumptions

現時点の推奨仮説は org-governance と github-actions を分離維持し、旧 .github checkoutのみ解消すること。memory transportはAIRIS MCP Gatewayの存続と独立に設計する。