How ynarvel/cloudadmin-ai works
CloudAdmin-AI is a policy-driven framework for AI-assisted Microsoft 365 and Azure administration, not a standalone management application. An administrator uses an AI/MCP environment to follow onboarding or offboarding guidance: discover targets and dependencies, prepare a plan, obtain explicit confirmation, perform approved changes through the existing MCP connection, verify the resulting state, and record the outcome. Policies define administration, confirmation, and verification controls. Audit scripts support JSON/CSV records, and the dashboard components provide a generated audit view. The README documents these relationships; source excerpts were unavailable, so implementation-level call wiring is not inferred.
Main entry points: verification.md State Verification · admin-policy.md Admin Policy · offboarding.md Approved Changes · onboarding.md Onboarding Workflow
Components 18
Policies
- Admin Policy
prompts/admin-policy.md - Confirmation Policy
policies/confirmation.md - Verification Policy
policies/verification.md
Workflows
- Onboarding Workflow
workflows/onboarding.md - Offboarding Workflow
workflows/offboarding.md - Discovery and Dependencies
workflows/offboarding.md - Change Plan
workflows/offboarding.md - Approval Gate
policies/confirmation.md - State Verification
policies/verification.md
Cloud Operations
- Approved Changes
workflows/offboarding.md - M365/Azure MCP
- Microsoft Cloud Services
Audit and Dashboard
- Audit Records
- JSON Audit Writer
audit/write-offboarding-record.ps1 - CSV Audit Writer
audit/write-offboarding-csv.ps1 - Dashboard Generator
dashboard/build-dashboard.ps1 - Audit Dashboard
dashboard/index.html
Other components
- Administrator / AI
Connections 22
- Administrator / AI → Admin Policy: uses controls
- Administrator / AI → Onboarding Workflow: requests onboarding
- Administrator / AI → Offboarding Workflow: requests offboarding
- Admin Policy → Onboarding Workflow: guides
- Admin Policy → Offboarding Workflow: guides
- Onboarding Workflow → Discovery and Dependencies: begins with
- Offboarding Workflow → Discovery and Dependencies: begins with
- Discovery and Dependencies → Change Plan: informs
- Change Plan → Approval Gate: requires approval
- Confirmation Policy → Approval Gate: governs
- Approval Gate → Approved Changes: permits approved
- Approved Changes → M365/Azure MCP: requests operations
- M365/Azure MCP → Microsoft Cloud Services: operates on
- Approved Changes → State Verification: followed by
- State Verification → M365/Azure MCP: queries state
- Verification Policy → State Verification: governs
- State Verification → JSON Audit Writer: records outcome
- State Verification → CSV Audit Writer: records outcome
- JSON Audit Writer → Audit Records: writes JSON
- CSV Audit Writer → Audit Records: writes CSV
- Audit Records → Dashboard Generator: provides audit data
- Dashboard Generator → Audit Dashboard: generates view