wehub-resource-sync
3.1 KiB
3.1 KiB
AI Agent Maturity Playbook
Guide Origin: Community | ArcKit Version: [VERSION]
/arckit:agent-maturity assesses an AI agent programme across design, governance, security, integration, and operations. It produces a current-state maturity view, target maturity, improvement roadmap, benchmarks, and traceability.
Inputs
| Artefact | Purpose |
|---|---|
Agent inventory (ARC-<id>-AAGI-v1.0.md) |
Agent baseline, ownership, lifecycle, capability context |
Agent design (ARC-<id>-AAGR-v1.0.md) |
Design patterns, tool contracts, guardrails, orchestration |
Agent governance (ARC-<id>-AAOV-v1.0.md) |
Oversight, audit, monitoring, approval process |
Agent security (ARC-<id>-AASE-v1.0.md) |
Security controls, threat model, validation pipeline |
Agent integration (ARC-<id>-AAIN-v1.0.md) |
Integration patterns and interoperability evidence |
Risk register (ARC-<id>-RISK-v1.0.md) |
Operational, compliance, and AI risk context |
| Enterprise maturity model | Wider maturity baseline and benchmark context |
Command
/arckit:agent-maturity <project ID or agent programme>
Output: projects/<id>/ARC-<id>-AAMT-v1.0.md
Maturity Dimensions
| Dimension | Evidence |
|---|---|
| Design | Reusable patterns, tool contracts, design reviews, ADRs |
| Governance | Oversight model, audit coverage, approval records, compliance mapping |
| Security | Threat model, sandboxing, permission controls, security testing |
| Integration | Standard APIs, contracts, observability, failure isolation |
| Operations | Monitoring, incident response, SLAs, support model, continuous improvement |
Maturity Levels
| Level | Meaning |
|---|---|
| L1 Ad-hoc | Reactive, informal, undocumented |
| L2 Reactive | Some process after issues occur |
| L3 Defined | Standard process documented and repeatable |
| L4 Managed | Metrics-driven and actively governed |
| L5 Optimized | Predictive, continuously improved, evidence-led |
Deliverable Snapshot
| Section | Contents |
|---|---|
| Maturity Model Framework | Dimensions, levels, and evidence criteria |
| Current State Assessment | Level, evidence, gaps, and risk per dimension |
| Target State | Target level and rationale per dimension |
| Improvement Roadmap | Initiatives, owners, timeline, dependencies, success criteria |
| Benchmarks | Industry, regulatory, and peer comparisons |
| Traceability | Links to inventory, design, governance, security, integration, and roadmap artefacts |
Review Checklist
- Ratings cite evidence rather than relying on opinion.
- Target levels are realistic for the investment and timeline.
- Each improvement initiative has owner, success criteria, and dependency notes.
- Security and governance maturity are not averaged away by strong design maturity.
- Roadmap actions feed back into
/arckit:agent-design,/arckit:agent-governance, and/arckit:agent-security.
Related Commands
/arckit:maturity-model- Assess wider enterprise architecture maturity./arckit:agent-design- Address design maturity gaps./arckit:agent-governance- Address governance maturity gaps.