Governance layers¶
AI Teams は、他の project に配布する Skill と同じ governance の分離を、AI Teams 自身にも適用します。
Portable AI Teams Skill
↓
AI Teams canonical managed-project contract
↓
Project-specific rules / Issue または decision record
portable な原則は次のとおりです。AI Teams は cross-project invariant を持ち、各 project は durable な解釈を所有し、future work が継承する必要が生じるまで decision は local に保ちます。 installed Skill の repository stewardship contract は self-contained であり、この site への access を前提にしません。
Classification audit¶
| Governance surface | Classification | 理由 |
|---|---|---|
配布 core SKILL.md |
PORTABLE | 特定の tracker、language、layout を要求せず、Issue owner を source-of-truth preservation、authority、delivery、verification、durable-policy promotion へ route します。 |
配布 references/repository-stewardship.md |
PORTABLE | downstream repository 向けに、three layers、placement/promotion decision、explicit override、testing economics を定義します。 |
| 配布 operating、delivery、project-conventions、quality、testing reference | PORTABLE | cross-project coordination/verification invariant を定義し、target project が具体的な system、command、exception を供給します。 |
AGENTS.md 内の AI Teams routing block |
ROUTING | repository work 前に canonical AI Teams Skill をロードします。周囲の file と、他 Skill/Plugin の route や safety rule は repository が所有します。 |
.ai-teams/project-rules.md |
PROJECT-LOCAL | verified repository parameter、scoped extension、より厳しい constraint のみを保持し、Skill を weaken / contradict してはいけません。 |
Documentation governance と docs/en / docs/ja |
PROJECT-LOCAL | English canonical、official Japanese translation、paired navigation、MkDocs/Cloudflare Pages はこの repository の validated documentation projection です。 |
| Architecture documentation と Decision Issue | PROJECT-LOCAL | AI Teams は current accepted architecture をこの site、rationale/history を GitHub Decision Issue に置きます。他の repository は別の owner を使用できます。 |
Tests、verification_policy.py、quality profile、CI、self-hosted validation |
PROJECT-LOCAL | portable な artifact-led verification を継承しつつ、AI Teams の concrete test command、gate、workflow identity、acceptance evidence を定義します。 |
| Plugin release metadata、release-management contract、release artifact | PROJECT-LOCAL | この Plugin の versioning、tag、GitHub Release、publication verification procedure を定義します。 |
| Repository layout、capability location、generated capability reference、module-size advisory | PROJECT-LOCAL | downstream の directory や numeric requirement ではなく、AI Teams の placement/maintenance convention です。 |
| implementation selection、temporary workaround、migration sequence、one-off external condition | ISSUE/DECISION-LOCAL | future-work inheritance が promotion を要求するまで Issue または Decision record に残します。 |
この table は audit であり、second policy database ではありません。列挙した source は、それぞれの rule の authoritative owner のままです。
Local policy を意図的に適用する¶
managed project では、AI Teams 固有の durable local guidance は project-rules owner に置き、root AGENTS.md は
他の repository-owned instruction と共存する bounded AI Teams routing block を 1 個保持します。reader-facing documentation governance はこの policy、executable verification は script/CI、
architecture は architecture site、release procedure は release contract、rationale は Decision Issue が所有します。
これらを再記述する別 layer は作りません。
documented local rule は portable semantics を変更しません。たとえば AI Teams の English/Japanese surface、 GitHub Issues の使用、advisory module-size signal は、portable な language、system-of-record、cohesion principle の local implementation です。downstream migration requirement は生じません。
AI Teams が portable Skill invariant を変更する場合、release の semantic change manifest が policy identifier と downstream compatibility action を記録します。AI Teams-only policy change は downstream Skill requirement ではありません。 portable default を override する project は、追加 authority を得ることなく将来の manifest を評価できるよう、 relevant policy identifier、scope、reason、authority を記録します。
永続設定¶
AI Teams は account-owned の ~/.codex/ai-teams/settings.json と、repository-owned
の .ai-teams/project-policy.json をそれぞれ最大 1 個読み取れます。user file は review
済みの既定値だけを、project file は portable な repository convention と既存 release overlay
だけを保持します。current explicit instruction、project policy、user default、product default
の順で優先します。credential、provider availability、absolute project path、work state、effect
authority は保存しません。file がない場合は現在の default を維持し、malformed、unsafe、unknown
version、authority を広げる document は reject します。新しい file を削除すれば以前の default
へ戻り、security 専用 execution-policy file の意味は変わりません。
Adoption 後の delivery readiness¶
有効な managed-project manifest と完了済みの semantic adoption audit だけでは、Issue delivery を完遂できる証拠にはなりません。project-lifecycle route は、repository-owned の focused、required、pre-push CI、exact-head hosted validate、pull-request acceptance、language policy、repository protection、packaging/install surface を別に評価します。review 済みの既存機構は primary のままで、置換せずに mapping できます。
完全な readiness command を持つ対応済み GitHub repository で workflow または pull-request template だけが不足する場合、tool はその欠落した最大 2 path のみを preview できます。apply には preview の exact digest が必要で、各 write を read back します。未知の stack、collision、command 欠落、malformed mapping は provider/settings effect を一切起こさず delivery_not_ready のままとし、AI Teams source repository の tooling をコピーせず repository owner の判断へ handoff します。