arckit-cli 6.1.1__py3-none-any.whl

arckit_cli-6.1.1.data/data/share/arckit/docs/guides/roles/business-analyst.md

@@ -0,0 +1,70 @@
+# Business Analyst — ArcKit Command Guide
+
+> **Guide Origin**: Official | **ArcKit Version**: [VERSION]
+
+> **DDaT Role Family**: [Product and Delivery](https://ddat-capability-framework.service.gov.uk/role/business-analyst)
+> **Framework**: [UK Government DDaT Capability Framework](https://ddat-capability-framework.service.gov.uk/)
+
+## Overview
+
+The Business Analyst elicits, analyses, and documents requirements. You are the bridge between stakeholders and the technical team — owning the requirements specification and ensuring traceability from business needs through to design and test.
+
+## Primary Commands
+
+| Command | Purpose | Guide |
+|---------|---------|-------|
+| `/arckit:requirements` | Create comprehensive business and technical requirements (BR, FR, NFR, INT, DR) | [Guide](#docs/guides/requirements.md) |
+| `/arckit:stakeholders` | Analyse stakeholder drivers, goals, and measurable outcomes | [Guide](#docs/guides/stakeholder-analysis.md) |
+| `/arckit:data-model` | Model data entities, relationships, and governance (with Data Architect) | [Guide](#docs/guides/data-model.md) |
+| `/arckit:traceability` | Generate requirements traceability matrix — requirements to design to tests | [Guide](#docs/guides/traceability.md) |
+
+## Secondary Commands
+
+| Command | Your Involvement | Guide |
+|---------|-----------------|-------|
+| `/arckit:plan` | Contribute to project planning (requirements phase estimation) | [Guide](#docs/guides/plan.md) |
+| `/arckit:sobc` | Provide requirements analysis for business case | [Guide](#docs/guides/sobc.md) |
+| `/arckit:backlog` | Review backlog for requirements coverage | [Guide](#docs/guides/backlog.md) |
+| `/arckit:research` | Provide requirements context for technology research | [Guide](#docs/guides/research.md) |
+| `/arckit:risk` | Identify requirements-related risks (scope creep, ambiguity) | [Guide](#docs/guides/risk.md) |
+| `/arckit:story` | Review project story for requirements accuracy | [Guide](#docs/guides/story.md) |
+| `/arckit:analyze` | Review governance analysis for requirements gaps | [Guide](#docs/guides/analyze.md) |
+
+## Typical Workflow
+
+```text
+stakeholders → requirements → data-model → traceability
+```
+
+### Step-by-step
+
+1. **Map stakeholders**: Run `/arckit:stakeholders` to identify who needs what and why
+2. **Elicit requirements**: Run `/arckit:requirements` — categorise as BR-xxx, FR-xxx, NFR-xxx, INT-xxx, DR-xxx
+3. **Model data**: Run `/arckit:data-model` (with Data Architect) to define entities and relationships from DR-xxx
+4. **Verify traceability**: Run `/arckit:traceability` to ensure all requirements trace to design and test artifacts
+5. **Iterate**: As design progresses, re-run traceability to catch gaps
+
+## Requirements ID Prefixes
+
+As the requirements author, you'll use these ID prefixes:
+
+| Prefix | Category | Examples |
+|--------|----------|---------|
+| BR-xxx | Business Requirements | BR-001, BR-002 |
+| FR-xxx | Functional Requirements | FR-001, FR-002 |
+| NFR-xxx | Non-Functional Requirements | NFR-P-001 (Performance), NFR-SEC-001 (Security) |
+| INT-xxx | Integration Requirements | INT-001, INT-002 |
+| DR-xxx | Data Requirements | DR-001, DR-002 |
+
+## Key Artifacts You Own
+
+- `ARC-{PID}-REQ-v*.md` — Requirements specification (the most-consumed artifact in ArcKit)
+- `ARC-{PID}-STKE-v*.md` — Stakeholder analysis (co-owned with Business Architect)
+- `ARC-{PID}-TRAC-v*.md` — Traceability matrix (co-owned with Delivery Manager)
+
+## Related Roles
+
+- [Product Manager](product-manager.md) — prioritises the requirements you define
+- [Solution Architect](solution-architect.md) — designs solutions to meet your requirements
+- [Data Architect](data-architect.md) — models data from your DR-xxx requirements
+- [Business Architect](business-architect.md) — provides the strategic context for your analysis

arckit_cli-6.1.1.data/data/share/arckit/docs/guides/roles/business-architect.md

@@ -0,0 +1,70 @@
+# Business Architect — ArcKit Command Guide
+
+> **Guide Origin**: Official | **ArcKit Version**: [VERSION]
+
+> **DDaT Role Family**: [Architecture](https://ddat-capability-framework.service.gov.uk/role/business-architect)
+> **Framework**: [UK Government DDaT Capability Framework](https://ddat-capability-framework.service.gov.uk/)
+
+## Overview
+
+The Business Architect bridges business strategy and technology architecture. You own the strategic context phase — stakeholder analysis, business cases, and strategic planning — ensuring technical decisions align with organisational goals.
+
+## Primary Commands
+
+| Command | Purpose | Guide |
+|---------|---------|-------|
+| `/arckit:stakeholders` | Analyse stakeholder drivers, goals, and measurable outcomes | [Guide](#docs/guides/stakeholder-analysis.md) |
+| `/arckit:sobc` | Create Strategic Outline Business Case (Green Book 5-case model) | [Guide](#docs/guides/sobc.md) |
+| `/arckit:strategy` | Synthesise strategic artifacts into executive-level Architecture Strategy | [Guide](#docs/guides/strategy.md) |
+| `/arckit:roadmap` | Create multi-year strategic roadmap with capability evolution | [Guide](#docs/guides/roadmap.md) |
+| `/arckit:platform-design` | Design multi-sided platform strategy (Government as a Platform, marketplaces) | [Guide](#docs/guides/platform-design.md) |
+
+## Secondary Commands
+
+| Command | Your Involvement | Guide |
+|---------|-----------------|-------|
+| `/arckit:plan` | Create or review project plan and timeline | [Guide](#docs/guides/plan.md) |
+| `/arckit:principles` | Contribute business-aligned architecture principles | [Guide](#docs/guides/principles.md) |
+| `/arckit:requirements` | Review business requirements (BR-xxx) for alignment with strategy | [Guide](#docs/guides/requirements.md) |
+| `/arckit:wardley` | Review Wardley Maps for strategic positioning | [Guide](#docs/guides/wardley.md) |
+| `/arckit:risk` | Review business risks and strategic mitigations | [Guide](#docs/guides/risk.md) |
+| `/arckit:presentation` | Present strategic findings to boards | [Guide](#docs/guides/presentation.md) |
+| `/arckit:story` | Review project narrative for business alignment | [Guide](#docs/guides/story.md) |
+
+## Typical Workflow
+
+```text
+plan → principles → stakeholders → risk → sobc → strategy → roadmap
+```
+
+### For platform projects
+
+```text
+plan → principles → stakeholders → risk → sobc → requirements → platform-design → strategy → roadmap
+```
+
+### Step-by-step
+
+1. **Plan the project**: Run `/arckit:plan` for project timeline and phases
+2. **Set principles**: Contribute business principles to `/arckit:principles`
+3. **Map stakeholders**: Run `/arckit:stakeholders` to identify drivers, goals, and power dynamics
+4. **Assess risks**: Review `/arckit:risk` for business and strategic risks
+5. **Build business case**: Run `/arckit:sobc` with Green Book 5-case model (Strategic, Economic, Commercial, Financial, Management)
+6. **Design platform** (if applicable): Run `/arckit:platform-design` for ecosystem strategy
+7. **Synthesise strategy**: Run `/arckit:strategy` to combine all strategic inputs
+8. **Plan evolution**: Run `/arckit:roadmap` for multi-year capability roadmap
+
+## Key Artifacts You Own
+
+- `ARC-{PID}-STKE-v*.md` — Stakeholder analysis
+- `ARC-{PID}-SOBC-v*.md` — Strategic Outline Business Case
+- `ARC-{PID}-STGY-v*.md` — Architecture strategy
+- `ARC-{PID}-ROAD-v*.md` — Strategic roadmap
+- `ARC-{PID}-PLAT-v*.md` — Platform design (if applicable)
+
+## Related Roles
+
+- [Enterprise Architect](enterprise-architect.md) — uses your strategic context for governance decisions
+- [Product Manager](product-manager.md) — translates your strategy into delivery plans
+- [CTO/CDIO](cto-cdio.md) — consumes your strategy and roadmap at executive level
+- [Solution Architect](solution-architect.md) — designs solutions aligned to your business case

arckit_cli-6.1.1.data/data/share/arckit/docs/guides/roles/cdo.md

@@ -0,0 +1,59 @@
+# CDO (Chief Data Officer) — ArcKit Command Guide
+
+> **Guide Origin**: Official | **ArcKit Version**: [VERSION]
+
+> **DDaT Role Family**: [Chief Digital and Data](https://ddat-capability-framework.service.gov.uk/role/chief-data-officer)
+> **Framework**: [UK Government DDaT Capability Framework](https://ddat-capability-framework.service.gov.uk/)
+
+## Overview
+
+The Chief Data Officer sets data strategy and governance policy. You use ArcKit's data commands at a strategic level — ensuring data models, privacy assessments, and data contracts align with organisational data strategy and regulatory obligations.
+
+## Primary Commands
+
+| Command | Purpose | Guide |
+|---------|---------|-------|
+| `/arckit:data-model` | Review and approve data models for governance compliance | [Guide](#docs/guides/data-model.md) |
+| `/arckit:dpia` | Oversee Data Protection Impact Assessments for regulatory compliance | [Guide](#docs/guides/dpia.md) |
+| `/arckit:datascout` | Discover and catalogue external data sources across the organisation | [Guide](#docs/guides/datascout.md) |
+| `/arckit:data-mesh-contract` | Define data governance standards for federated data products | [Guide](#docs/guides/data-mesh-contract.md) |
+
+## Secondary Commands
+
+| Command | Your Involvement | Guide |
+|---------|-----------------|-------|
+| `/arckit:principles` | Define data governance principles | [Guide](#docs/guides/principles.md) |
+| `/arckit:requirements` | Review data requirements (DR-xxx) for strategic alignment | [Guide](#docs/guides/requirements.md) |
+| `/arckit:strategy` | Contribute data strategy to Architecture Strategy | [Guide](#docs/guides/strategy.md) |
+| `/arckit:analyze` | Review governance quality for data completeness | [Guide](#docs/guides/analyze.md) |
+| `/arckit:platform-design` | Oversee data platform strategy for data marketplaces | [Guide](#docs/guides/platform-design.md) |
+| `/arckit:atrs` | Review algorithmic transparency records for data ethics | [Guide](#docs/guides/atrs.md) |
+
+## Typical Workflow
+
+```text
+principles → requirements (DR-xxx) → datascout → data-model → data-mesh-contract → dpia
+```
+
+### Step-by-step
+
+1. **Set data principles**: Contribute data governance principles to `/arckit:principles`
+2. **Review data requirements**: Ensure DR-xxx requirements align with data strategy
+3. **Catalogue data sources**: Run `/arckit:datascout` to map available data across the organisation
+4. **Approve data models**: Review `/arckit:data-model` outputs for governance compliance
+5. **Define contracts**: Run `/arckit:data-mesh-contract` for federated data governance standards
+6. **Oversee privacy**: Review `/arckit:dpia` for regulatory compliance
+
+## Key Artifacts You Oversee
+
+- `ARC-{PID}-DATA-v*.md` — Data models (owned by Data Architect, approved by CDO)
+- `ARC-{PID}-DPIA-v*.md` — DPIAs (owned by Data/Security Architect, approved by CDO)
+- `ARC-{PID}-DSCT-v*.md` — Data source catalogue
+- `ARC-{PID}-DMC-{NUM}-v*.md` — Data mesh contracts
+
+## Related Roles
+
+- [Data Architect](data-architect.md) — implements your data strategy at project level
+- [Data Governance Manager](data-governance-manager.md) — enforces the policies you define
+- [CTO/CDIO](cto-cdio.md) — aligns technology and data strategy
+- [CISO](ciso.md) — co-owns data protection with you

arckit_cli-6.1.1.data/data/share/arckit/docs/guides/roles/ciso.md

@@ -0,0 +1,61 @@
+# CISO (Chief Information Security Officer) — ArcKit Command Guide
+
+> **Guide Origin**: Official | **ArcKit Version**: [VERSION]
+
+> **DDaT Role Family**: [Chief Digital and Data](https://ddat-capability-framework.service.gov.uk/role/chief-information-security-officer)
+> **Framework**: [UK Government DDaT Capability Framework](https://ddat-capability-framework.service.gov.uk/)
+
+## Overview
+
+The CISO sets security strategy and risk appetite for the organisation. You use ArcKit's security and compliance commands at a strategic level — ensuring security assessments are consistent, risk registers are maintained, and architecture conforms to security standards.
+
+## Primary Commands
+
+| Command | Purpose | Guide |
+|---------|---------|-------|
+| `/arckit:secure` | Review Secure by Design assessments across projects | [Guide](#docs/guides/secure.md) |
+| `/arckit:mod-secure` | Review MOD Secure by Design assessments (if MOD) | [Guide](#docs/guides/mod-secure.md) |
+| `/arckit:dpia` | Oversee DPIAs for data protection compliance | [Guide](#docs/guides/dpia.md) |
+| `/arckit:risk` | Set risk appetite and review risk registers | [Guide](#docs/guides/risk.md) |
+| `/arckit:conformance` | Monitor security conformance across the portfolio | [Guide](#docs/guides/conformance.md) |
+
+## Secondary Commands
+
+| Command | Your Involvement | Guide |
+|---------|-----------------|-------|
+| `/arckit:principles` | Define security principles (Zero Trust, defence in depth) | [Guide](#docs/guides/principles.md) |
+| `/arckit:requirements` | Review NFR-SEC security requirements standards | [Guide](#docs/guides/requirements.md) |
+| `/arckit:tcop` | Review TCoP compliance for security-related points | [Guide](#docs/guides/tcop.md) |
+| `/arckit:analyze` | Review governance quality for security gaps | [Guide](#docs/guides/analyze.md) |
+| `/arckit:health` | Monitor for stale security artifacts | [Guide](#docs/guides/artifact-health.md) |
+| `/arckit:ai-playbook` | Review AI safety and security controls | [Guide](#docs/guides/ai-playbook.md) |
+| `/arckit:jsp-936` | Review MOD AI assurance (if applicable) | [Guide](#docs/guides/jsp-936.md) |
+
+## Typical Workflow
+
+```text
+principles (security) → risk → secure / mod-secure → conformance → analyze
+```
+
+### Step-by-step
+
+1. **Define security principles**: Set organisational security principles in `/arckit:principles`
+2. **Set risk appetite**: Review `/arckit:risk` registers across projects
+3. **Review assessments**: Review `/arckit:secure` or `/arckit:mod-secure` outputs
+4. **Check conformance**: Run `/arckit:conformance` to verify security decisions are implemented
+5. **Monitor quality**: Review `/arckit:analyze` for security governance gaps
+
+## Key Artifacts You Oversee
+
+- `ARC-{PID}-SECD-v*.md` — Secure by Design assessments (owned by Security Architect)
+- `ARC-{PID}-SECD-MOD-v*.md` — MOD Secure by Design assessments
+- `ARC-{PID}-RISK-v*.md` — Risk registers
+- `ARC-{PID}-DPIA-v*.md` — Data Protection Impact Assessments
+- `ARC-{PID}-CONF-v*.md` — Conformance assessments
+
+## Related Roles
+
+- [Security Architect](security-architect.md) — implements your security strategy at project level
+- [CTO/CDIO](cto-cdio.md) — aligns security and technology strategy
+- [CDO](cdo.md) — co-owns data protection
+- [Enterprise Architect](enterprise-architect.md) — ensures security principles are embedded in governance

arckit_cli-6.1.1.data/data/share/arckit/docs/guides/roles/cto-cdio.md

@@ -0,0 +1,59 @@
+# CTO / CDIO — ArcKit Command Guide
+
+> **Guide Origin**: Official | **ArcKit Version**: [VERSION]
+
+> **DDaT Role Family**: [Chief Digital and Data](https://ddat-capability-framework.service.gov.uk/role/chief-technology-officer)
+> **Framework**: [UK Government DDaT Capability Framework](https://ddat-capability-framework.service.gov.uk/)
+
+## Overview
+
+The Chief Technology Officer (CTO) or Chief Digital and Information Officer (CDIO) sets technology strategy and direction. You use ArcKit's strategic and reporting commands to define principles, visualise the technology landscape, and present architectural decisions to boards.
+
+## Primary Commands
+
+| Command | Purpose | Guide |
+|---------|---------|-------|
+| `/arckit:principles` | Define enterprise-wide architecture principles | [Guide](#docs/guides/principles.md) |
+| `/arckit:strategy` | Synthesise strategic artifacts into executive-level Architecture Strategy | [Guide](#docs/guides/strategy.md) |
+| `/arckit:roadmap` | Create multi-year strategic roadmap with capability evolution | [Guide](#docs/guides/roadmap.md) |
+| `/arckit:wardley` | Visualise technology landscape and evolution with Wardley Maps | [Guide](#docs/guides/wardley.md) |
+| `/arckit:presentation` | Generate board-level slide decks from architecture artifacts | [Guide](#docs/guides/presentation.md) |
+
+## Secondary Commands
+
+| Command | Your Involvement | Guide |
+|---------|-----------------|-------|
+| `/arckit:plan` | Review project plans for strategic alignment | [Guide](#docs/guides/plan.md) |
+| `/arckit:sobc` | Review business cases for investment decisions | [Guide](#docs/guides/sobc.md) |
+| `/arckit:analyze` | Review governance quality across the portfolio | [Guide](#docs/guides/analyze.md) |
+| `/arckit:conformance` | Monitor architecture conformance across projects | [Guide](#docs/guides/conformance.md) |
+| `/arckit:story` | Review project narratives for executive reporting | [Guide](#docs/guides/story.md) |
+| `/arckit:tcop` | Review TCoP compliance across the department | [Guide](#docs/guides/tcop.md) |
+| `/arckit:research` | Review technology research for strategic implications | [Guide](#docs/guides/research.md) |
+
+## Typical Workflow
+
+```text
+principles → wardley → strategy → roadmap → presentation
+```
+
+### Step-by-step
+
+1. **Set principles**: Run `/arckit:principles` to establish the architecture principles for your organisation
+2. **Map the landscape**: Run `/arckit:wardley` to visualise current technology positions and evolution
+3. **Synthesise strategy**: Run `/arckit:strategy` to combine principles, stakeholder needs, and Wardley Maps into a coherent strategy
+4. **Plan evolution**: Run `/arckit:roadmap` for a multi-year capability roadmap with investment phases
+5. **Present to board**: Run `/arckit:presentation` in Executive focus mode for board-level slides
+
+## Key Artifacts You Own
+
+- `ARC-000-PRIN-v*.md` — Enterprise architecture principles (global, cross-project)
+- `ARC-{PID}-STGY-v*.md` — Architecture strategy (co-owned with Enterprise Architect)
+- `ARC-{PID}-ROAD-v*.md` — Strategic roadmap
+
+## Related Roles
+
+- [Enterprise Architect](enterprise-architect.md) — implements the governance framework under your direction
+- [Business Architect](business-architect.md) — provides the business context for your strategy
+- [CISO](ciso.md) — advises on security strategy and risk appetite
+- [CDO](cdo.md) — advises on data strategy and governance

arckit_cli-6.1.1.data/data/share/arckit/docs/guides/roles/data-architect.md

@@ -0,0 +1,68 @@
+# Data Architect — ArcKit Command Guide
+
+> **Guide Origin**: Official | **ArcKit Version**: [VERSION]
+
+> **DDaT Role Family**: [Architecture](https://ddat-capability-framework.service.gov.uk/role/data-architect)
+> **Framework**: [UK Government DDaT Capability Framework](https://ddat-capability-framework.service.gov.uk/)
+
+## Overview
+
+The Data Architect designs data structures, governance, and flows. You own ArcKit's data-focused commands — ensuring data models are GDPR-compliant, data sources are catalogued, and data contracts enforce quality standards across the organisation.
+
+## Primary Commands
+
+| Command | Purpose | Guide |
+|---------|---------|-------|
+| `/arckit:data-model` | Create comprehensive data model with entity relationships, GDPR compliance, and governance | [Guide](#docs/guides/data-model.md) |
+| `/arckit:data-mesh-contract` | Define federated data product contracts with SLAs and interoperability guarantees | [Guide](#docs/guides/data-mesh-contract.md) |
+| `/arckit:dpia` | Generate Data Protection Impact Assessment for UK GDPR Article 35 | [Guide](#docs/guides/dpia.md) |
+| `/arckit:datascout` | Discover external data sources — APIs, datasets, open data portals | [Guide](#docs/guides/datascout.md) |
+
+## Secondary Commands
+
+| Command | Your Involvement | Guide |
+|---------|-----------------|-------|
+| `/arckit:requirements` | Define Data Requirements (DR-xxx) within the requirements specification | [Guide](#docs/guides/requirements.md) |
+| `/arckit:principles` | Contribute data governance principles | [Guide](#docs/guides/principles.md) |
+| `/arckit:diagram` | Review data flow diagrams for accuracy | [Guide](#docs/guides/diagram.md) |
+| `/arckit:traceability` | Verify DR-xxx requirements trace to data model entities | [Guide](#docs/guides/traceability.md) |
+| `/arckit:research` | Evaluate data platforms and storage technologies | [Guide](#docs/guides/research.md) |
+| `/arckit:platform-design` | Design data platform ecosystems (data marketplaces, data mesh) | [Guide](#docs/guides/platform-design.md) |
+
+## Typical Workflow
+
+```text
+requirements (DR-xxx) → datascout → data-model → data-mesh-contract → dpia
+```
+
+### Step-by-step
+
+1. **Define data requirements**: Work with Business Analyst to define DR-xxx requirements in `/arckit:requirements`
+2. **Discover data sources**: Run `/arckit:datascout` to find external APIs, datasets, and open data portals
+3. **Design data model**: Run `/arckit:data-model` — entities, relationships, GDPR classification, retention policies
+4. **Define data contracts**: Run `/arckit:data-mesh-contract` for federated governance (if using data mesh)
+5. **Assess privacy impact**: Run `/arckit:dpia` for any processing involving personal data
+6. **Verify traceability**: Review `/arckit:traceability` output to confirm all DR-xxx requirements are covered
+
+## Key Artifacts You Own
+
+- `ARC-{PID}-DATA-v*.md` — Data model with entity-relationship diagrams
+- `ARC-{PID}-DMC-{NUM}-v*.md` — Data mesh contracts
+- `ARC-{PID}-DPIA-v*.md` — Data Protection Impact Assessment
+- `ARC-{PID}-DSCT-v*.md` — Data source catalogue
+
+## UK Government Data Context
+
+ArcKit's data commands are designed for UK public sector data governance:
+
+- **datascout** prioritises UK Government open data (data.gov.uk, ONS, NHS Digital, Companies House, OS Data Hub)
+- **data-model** includes GDPR compliance classification and ICO lawful basis
+- **dpia** follows ICO guidance for UK GDPR Article 35
+- **data-mesh-contract** supports TCoP Point 10 (share and reuse technology)
+
+## Related Roles
+
+- [Data Governance Manager](data-governance-manager.md) — enforces the policies your model defines
+- [CDO](cdo.md) — sets the data strategy you implement
+- [Solution Architect](solution-architect.md) — integrates your data model into the solution design
+- [Business Analyst](business-analyst.md) — provides the data requirements you model

arckit_cli-6.1.1.data/data/share/arckit/docs/guides/roles/data-governance-manager.md

@@ -0,0 +1,59 @@
+# Data Governance Manager — ArcKit Command Guide
+
+> **Guide Origin**: Official | **ArcKit Version**: [VERSION]
+
+> **DDaT Role Family**: [Data](https://ddat-capability-framework.service.gov.uk/role/data-governance-manager)
+> **Framework**: [UK Government DDaT Capability Framework](https://ddat-capability-framework.service.gov.uk/)
+
+## Overview
+
+The Data Governance Manager ensures data is managed according to organisational policies and regulatory requirements. You use ArcKit to assess data protection compliance, review data models for governance standards, and measure principles adherence.
+
+## Primary Commands
+
+| Command | Purpose | Guide |
+|---------|---------|-------|
+| `/arckit:dpia` | Generate Data Protection Impact Assessment for UK GDPR compliance | [Guide](#docs/guides/dpia.md) |
+| `/arckit:data-model` | Review data models for governance compliance (classification, retention, lineage) | [Guide](#docs/guides/data-model.md) |
+| `/arckit:principles-compliance` | Assess compliance with data governance principles | [Guide](#docs/guides/principles-compliance.md) |
+| `/arckit:data-mesh-contract` | Review and enforce data product contracts and SLAs | [Guide](#docs/guides/data-mesh-contract.md) |
+
+## Secondary Commands
+
+| Command | Your Involvement | Guide |
+|---------|-----------------|-------|
+| `/arckit:principles` | Define data governance principles | [Guide](#docs/guides/principles.md) |
+| `/arckit:requirements` | Review data requirements (DR-xxx) for governance standards | [Guide](#docs/guides/requirements.md) |
+| `/arckit:datascout` | Review external data sources for compliance and licensing | [Guide](#docs/guides/datascout.md) |
+| `/arckit:traceability` | Verify data requirements trace through to governance controls | [Guide](#docs/guides/traceability.md) |
+| `/arckit:analyze` | Review governance quality for data governance gaps | [Guide](#docs/guides/analyze.md) |
+| `/arckit:atrs` | Review algorithmic transparency for data ethics compliance | [Guide](#docs/guides/atrs.md) |
+
+## Typical Workflow
+
+```text
+principles → requirements (DR-xxx) → data-model → dpia → data-mesh-contract → principles-compliance
+```
+
+### Step-by-step
+
+1. **Set governance standards**: Define data governance principles in `/arckit:principles`
+2. **Review data requirements**: Ensure DR-xxx requirements include classification, retention, and lineage
+3. **Validate data models**: Review `/arckit:data-model` for GDPR compliance and governance standards
+4. **Assess privacy**: Run `/arckit:dpia` for any personal data processing
+5. **Enforce contracts**: Review `/arckit:data-mesh-contract` for SLA and quality standards
+6. **Measure compliance**: Run `/arckit:principles-compliance` to score adherence to data principles
+
+## Key Artifacts You Review/Approve
+
+- `ARC-{PID}-DPIA-v*.md` — Data Protection Impact Assessment
+- `ARC-{PID}-DATA-v*.md` — Data model governance sections
+- `ARC-{PID}-DMC-{NUM}-v*.md` — Data mesh contracts
+- `ARC-{PID}-PRIN-COMP-v*.md` — Principles compliance scorecard (data sections)
+
+## Related Roles
+
+- [CDO](cdo.md) — sets the data strategy you enforce
+- [Data Architect](data-architect.md) — designs the data models you govern
+- [Security Architect](security-architect.md) — co-owns data protection compliance
+- [Enterprise Architect](enterprise-architect.md) — aligns data governance with architecture governance

arckit_cli-6.1.1.data/data/share/arckit/docs/guides/roles/delivery-manager.md

@@ -0,0 +1,63 @@
+# Delivery Manager — ArcKit Command Guide
+
+> **Guide Origin**: Official | **ArcKit Version**: [VERSION]
+
+> **DDaT Role Family**: [Product and Delivery](https://ddat-capability-framework.service.gov.uk/role/delivery-manager)
+> **Framework**: [UK Government DDaT Capability Framework](https://ddat-capability-framework.service.gov.uk/)
+
+## Overview
+
+The Delivery Manager ensures the project is delivered on time and to quality standards. You use ArcKit to track plans, risks, backlogs, and traceability — giving you visibility across all project artifacts to identify blockers and governance gaps.
+
+## Primary Commands
+
+| Command | Purpose | Guide |
+|---------|---------|-------|
+| `/arckit:plan` | Create and maintain project plan with timeline and governance gates | [Guide](#docs/guides/plan.md) |
+| `/arckit:risk` | Maintain risk register following HM Treasury Orange Book | [Guide](#docs/guides/risk.md) |
+| `/arckit:backlog` | Generate and review product backlog for sprint planning | [Guide](#docs/guides/backlog.md) |
+| `/arckit:trello` | Export backlog to Trello for team visibility | [Guide](#docs/guides/trello.md) |
+| `/arckit:traceability` | Track requirements through design to tests — identify gaps | [Guide](#docs/guides/traceability.md) |
+| `/arckit:health` | Scan for stale artifacts, orphaned requirements, and version drift | [Guide](#docs/guides/artifact-health.md) |
+
+## Secondary Commands
+
+| Command | Your Involvement | Guide |
+|---------|-----------------|-------|
+| `/arckit:stakeholders` | Review stakeholder map for delivery dependencies | [Guide](#docs/guides/stakeholder-analysis.md) |
+| `/arckit:requirements` | Track requirements completion status | [Guide](#docs/guides/requirements.md) |
+| `/arckit:story` | Generate project narrative for governance reporting | [Guide](#docs/guides/story.md) |
+| `/arckit:operationalize` | Review operational readiness for go-live | [Guide](#docs/guides/operationalize.md) |
+| `/arckit:analyze` | Review governance quality for delivery assurance | [Guide](#docs/guides/analyze.md) |
+| `/arckit:service-assessment` | Prepare evidence for GDS Service Standard gates | [Guide](#docs/guides/service-assessment.md) |
+
+## Typical Workflow
+
+```text
+plan → stakeholders → risk → requirements → backlog → trello →
+traceability → health → story
+```
+
+### Step-by-step
+
+1. **Plan delivery**: Run `/arckit:plan` for timeline, phases, and governance gates
+2. **Map stakeholders**: Ensure `/arckit:stakeholders` captures delivery dependencies
+3. **Track risks**: Run `/arckit:risk` and review regularly — update mitigations as project progresses
+4. **Monitor requirements**: Track completion of requirements from `/arckit:requirements`
+5. **Manage backlog**: Run `/arckit:backlog` then `/arckit:trello` for sprint-level tracking
+6. **Check traceability**: Run `/arckit:traceability` to ensure nothing falls through the cracks
+7. **Health checks**: Run `/arckit:health` periodically to catch drift and stale artifacts
+8. **Report progress**: Run `/arckit:story` for governance board updates
+
+## Key Artifacts You Own
+
+- `ARC-{PID}-PLAN-v*.md` — Project plan (co-owned with Product Manager)
+- `ARC-{PID}-RISK-v*.md` — Risk register (co-owned with Security Architect)
+- `ARC-{PID}-TRAC-v*.md` — Traceability matrix
+
+## Related Roles
+
+- [Product Manager](product-manager.md) — sets priorities you deliver against
+- [Business Analyst](business-analyst.md) — maintains the requirements you track
+- [Enterprise Architect](enterprise-architect.md) — sets the governance gates you manage
+- [Service Owner](service-owner.md) — receives the service you deliver

arckit_cli-6.1.1.data/data/share/arckit/docs/guides/roles/devops-engineer.md

@@ -0,0 +1,55 @@
+# DevOps Engineer — ArcKit Command Guide
+
+> **Guide Origin**: Official | **ArcKit Version**: [VERSION]
+
+> **DDaT Role Family**: [Software Development](https://ddat-capability-framework.service.gov.uk/role/development-operations-devops-engineer)
+> **Framework**: [UK Government DDaT Capability Framework](https://ddat-capability-framework.service.gov.uk/)
+
+## Overview
+
+The DevOps Engineer designs and implements CI/CD pipelines, infrastructure as code, and deployment automation. You use ArcKit to generate DevOps strategy documents and review architecture diagrams for deployment and infrastructure patterns.
+
+## Primary Commands
+
+| Command | Purpose | Guide |
+|---------|---------|-------|
+| `/arckit:devops` | Create DevOps strategy — CI/CD pipelines, IaC, container orchestration, developer experience | [Guide](#docs/guides/devops.md) |
+| `/arckit:mlops` | Create MLOps strategy — model lifecycle, training pipelines, serving, monitoring (for AI projects) | [Guide](#docs/guides/mlops.md) |
+| `/arckit:diagram` | Create deployment, infrastructure, and pipeline architecture diagrams | [Guide](#docs/guides/diagram.md) |
+
+## Secondary Commands
+
+| Command | Your Involvement | Guide |
+|---------|-----------------|-------|
+| `/arckit:requirements` | Review NFR requirements (deployment frequency, MTTR, change failure rate) | [Guide](#docs/guides/requirements.md) |
+| `/arckit:operationalize` | Contribute to runbooks, monitoring, and alerting | [Guide](#docs/guides/operationalize.md) |
+| `/arckit:finops` | Review cloud cost implications of infrastructure choices | [Guide](#docs/guides/finops.md) |
+| `/arckit:backlog` | Review backlog for DevOps and infrastructure stories | [Guide](#docs/guides/backlog.md) |
+| `/arckit:adr` | Record infrastructure and tooling decisions | [Guide](#docs/guides/adr.md) |
+| `/arckit:azure-research` | Research Azure DevOps and infrastructure services | [Guide](#docs/guides/azure-research.md) |
+| `/arckit:aws-research` | Research AWS DevOps and infrastructure services | [Guide](#docs/guides/aws-research.md) |
+
+## Typical Workflow
+
+```text
+requirements → diagram → devops → mlops → operationalize
+```
+
+### Step-by-step
+
+1. **Understand NFRs**: Review deployment, availability, and performance requirements
+2. **Create diagrams**: Run `/arckit:diagram` for deployment and infrastructure views
+3. **Design DevOps**: Run `/arckit:devops` for CI/CD, IaC, and container strategy
+4. **Design MLOps** (if AI project): Run `/arckit:mlops` for model pipeline infrastructure
+5. **Contribute to operations**: Help create runbooks and monitoring in `/arckit:operationalize`
+
+## Key Artifacts You Own
+
+- `ARC-{PID}-DEVOPS-v*.md` — DevOps strategy
+- `ARC-{PID}-MLOPS-v*.md` — MLOps strategy (for AI projects)
+
+## Related Roles
+
+- [Technical Architect](technical-architect.md) — designs the infrastructure you automate
+- [IT Service Manager](it-service-manager.md) — manages the services you deploy to
+- [Solution Architect](solution-architect.md) — defines the architecture your pipelines build