AI Analytics

Operating contract

Inputs

Outputs

• Produce: metric specification, analysis or dashboard design, uncertainty notes, validation results, and decision recommendation.

Skill-specific outputs:

• A concrete deliverable matched to the request: architecture, implementation plan, audit, policy, runbook, UX flow, test strategy, or operating model.
• The selected consolidated reference files and any assumptions, risks, evidence requirements, or follow-up actions that affect execution.

Capability and permission boundaries

Default to read-only analysis. Read only scoped records; redact secrets and regulated data. Writes, execution, network calls, production configuration, customer communication, billing changes, and delegation require explicit authority and an identified owner. Never widen tenant, time-window, or system scope implicitly.

Degraded mode

When required telemetry, evidence, execution, network access, or write authority is unavailable, return a partial result with each unassessed item labelled, preserve the safest existing state, and state the evidence or approval needed to continue. Never convert missing evidence into a pass.

Decision rules

Anti-Patterns

• Treating absent evidence as success. Fix: mark the check unassessed and name the missing source.
• Expanding one tenant or workflow to all tenants. Fix: enforce supplied scope at every query and action.
• Performing a production write during analysis. Fix: emit a reviewed change plan until authority is explicit.
• Reporting a metric without population, window, or source. Fix: attach all three.
• Hiding a failed threshold inside an average. Fix: report failure slices and the remediation owner.

Acknowledgement: Shared by Peter Bamuhigire, techguypeter.com, +256 784 464178.

Use When

• Design AI analytics products, metric trees, dashboards, and AI insight workflows.
• Plan SaaS AI analytics, NLP analytics, predictive analytics, or reporting surfaces.
• Choose the right analytics reference from consolidated child modules.

Do Not Use When

• The work is not AI-specific or agentic-AI-specific.
• A narrower retained AI parent skill fits the request better.

Required Inputs

• Product, tenant, user, data, risk, and operational context relevant to the AI workflow.
• Target artifact: design, implementation plan, audit, test strategy, UX flow, commercial policy, or runbook.
• Constraints from security, privacy, reliability, billing, support, and compliance stakeholders when relevant.

Workflow

1. Read this SKILL.md first.
2. Load references/routing.md to select the absorbed child reference that matches the task.
3. Load only the selected child reference files needed for the current request.
4. Produce execution-oriented output with assumptions, risks, evidence, and next actions where relevant.

Quality Standards

• Keep routing explicit: name which reference files were used when the work depends on absorbed material.
• Preserve tenant isolation, auditability, cost controls, safety gates, and operational evidence when they matter.
• Prefer concrete contracts, checklists, tables, schemas, runbooks, and decision records over broad summaries.
• AI or written insights built from product figures follow the Chwezi Reporting and Dashboards Standard narrative rules (hard gate RPT-GATE-07, ungrounded narrative): every claim cites the measure, filter and period it rests on (RPT-NARR-001); observation is kept apart from inference, a cause is stated only with supporting evidence and never from correlation alone, and uncertainty is disclosed (RPT-NARR-002); consequential financial, clinical or regulatory text needs named human approval and shows its status, draft, verified or disputed (RPT-NARR-003); prompt, template and model versions are logged where policy allows (RPT-NARR-004). The figures themselves come from approved metric contracts, never from the model. Claim-table and metric procedure: reporting-and-export-engineering.

Anti-Patterns

• Loading every absorbed reference by default.
• Treating AI-specific billing, compliance, safety, or UX concerns as generic SaaS work without checking AI failure modes.
• Hiding retired skill names; old slugs must remain discoverable through references/routing.md.

References

• references/routing.md maps retired child skill slugs to their consolidated reference folders.

Consolidated Child References

• Load references/routing.md to map retired AI child skill slugs to their reference modules.

Evidence Produced