docs: present AI strategy as a diagram-first story
Build and publish Eldorado documentation / build (pull_request) Successful in 40s

This commit is contained in:
jarvis-at-skic committed 2026-10-04 12:23:41 +00:00
1 parent 7f40de708c
commit 794f2aa2d6
30 files changed
+2496 -4

No files matched your search

+31
View File
@@ -2,11 +2,28 @@
id: skills-governance
title: Skills governance
description: Contract, lifecycle, decision rights, adapters, locking, exceptions.
hide_table_of_contents: true
---
import ArchifyDiagram from '@site/src/components/ArchifyDiagram';
<div className="strategy-content">
**TO-BE · Target operating model — not installed controls or company results.**
## Who can approve a skill for use?
The owning team authors the skill; independent reviewers assess it before exact-revision approval. Data &amp; AI maintains the catalog, while Platform &amp; IT verifies distribution and revocation.
<ArchifyDiagram name="strategy-governance" title="An owner proposes; independent review and canary evidence precede approval" story />
- **Separate duties:** the author cannot provide the only approval; higher risk involves Architecture &amp; Security.
- **Pin the whole bundle:** content, adapters and executable dependencies travel together.
- **Keep controls authoritative:** exceptions expire and cannot bypass protected release, payment or identity controls.
<details>
<summary>Ownership, client qualification, exceptions and rollback</summary>
**TO-BE · Target operating model.** Introduction depends on the [roadmap gates](./roadmap.mdx); these pages do not describe installed controls or measured company results.
### A contract that travels, controls that stay authoritative
@@ -33,6 +50,11 @@ A cached verified bundle may support explicitly permitted low-risk work if its m
Rollback restores the approved manifest and dependencies, invalidates affected sessions, revokes unsafe revisions, runs a smoke test and verifies effective state. It cannot undo data disclosure or commands already executed. Those require incident response.
</details>
<details>
<summary>Catalog contract — required fields</summary>
## Catalog contract
| Contract | Definition |
@@ -59,6 +81,11 @@ Rollback restores the approved manifest and dependencies, invalidates affected s
| procedure | Prerequisites, bounded steps, expected artifacts, verification, failure handling, escalation |
</details>
<details>
<summary>Lifecycle transitions and required evidence</summary>
## Promotion and retirement
| Transition | Required evidence |
@@ -70,4 +97,8 @@ Rollback restores the approved manifest and dependencies, invalidates affected s
| any active state → quarantined | Incident or unsafe/unknown provenance; central deny immediately |
| quarantined → experimental | Reviewed correction; new immutable revision; requalify, never auto-restore approval |
</details>
**Next:** [See the evidence needed to qualify a skill →](./skills-quality.mdx)
</div>