Governance layers¶
AI Teams は、他の project に配布する Skill と同じ governance の分離を、AI Teams 自身にも適用します。
Portable AI Teams Skill
↓
AI Teams project-local policy
↓
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 |
PROJECT-LOCAL | AI Teams の GitHub Issue/PR/worktree path、exact hosted validate、local cleanup mode、advisory 500 LOC signal、quality command を要求します。 |
Documentation governance と docs/en / docs/ja |
PROJECT-LOCAL | English canonical、official Japanese translation、paired navigation、MkDocs/GitHub 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 を意図的に適用する¶
AI Teams では、durable local guidance は既存 owner に置きます。repository の operating constraint は
AGENTS.md、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 を記録します。