Model Documentation and Operational Procedures
In the PMI-CPMAI framework, which builds on the CPMAI methodology's iterative phases (Business Understanding, Data Understanding, Data Preparation, Model Development, Model Evaluation, and Model Operationalization), model documentation and operational procedures connect building a model with running it responsibly. They make AI solutions transparent, repeatable, auditable, and maintainable after handoff from the development team. Model documentation records what the model is, how it was built, and how it should and should not be used. Key artifacts include model cards and datasheets that describe the business objective, intended use, and out-of-scope uses. They also cover training data sources and lineage, the feature engineering and preprocessing steps, the algorithm chosen, and the hyperparameters. Evaluation metrics should be tied to the success criteria defined during Business Understanding. Documentation also captures known limitations, assumptions, bias and fairness assessments, explainability considerations, and version history. This supports regulatory compliance, stakeholder trust, knowledge transfer, and reproducibility when teams change or models must be rebuilt. Operational procedures define how the model behaves in production. They include deployment runbooks, environment and infrastructure requirements, and access controls. They also specify integration points with business systems and service-level expectations for latency, availability, and accuracy. Critically, they establish monitoring for data drift, concept drift, and performance decay. They set thresholds and triggers for retraining and describe rollback and incident-response steps. Escalation paths and human-in-the-loop review points should be clearly defined. Procedures should also assign ownership through RACI-style roles for data scientists, MLOps engineers, business owners, and governance or ethics reviewers. For the AI project manager, these deliverables are formal acceptance criteria rather than afterthoughts. The manager ensures documentation is produced iteratively, reviewed in evaluation gates, and kept under version control alongside code and data. Procedures should be tested before go-live. Because AI models are probabilistic and degrade over time, strong documentation and operational procedures sustain business value, support trustworthy AI principles, and enable a confident decision to iterate, retrain, or retire the model.
Model Documentation and Operational Procedures (PMI-CPMAI: Manage AI Model Development and Evaluation)
Within the PMI Certified Professional in Managing AI (PMI-CPMAI) framework, which builds on the CPMAI methodology and its six iterative phases (Business Understanding, Data Understanding, Data Preparation, Model Development, Model Evaluation, and Model Operationalization), Model Documentation and Operational Procedures sits at the link between building a model and running it reliably in the real world.
It covers the structured recording of everything about an AI model:
- what it is,
- how it was built,
- what data it used,
- how it performed,
- what its limitations are,
- how it should be deployed, monitored, maintained, retrained and retired.
Why Model Documentation and Operational Procedures Matter
1. AI systems are probabilistic, not deterministic. Unlike traditional software, a model's behavior depends on training data, assumptions and statistical patterns. Without documentation, no one can explain why the model behaves the way it does or when it should no longer be trusted.
2. Transparency and explainability. Stakeholders, regulators, auditors and end users increasingly expect to know how AI decisions are made. Documentation is the evidence base for trustworthy AI.
3. Regulatory and compliance requirements. Frameworks such as the EU AI Act, the NIST AI Risk Management Framework, ISO/IEC 42001, GDPR and sector-specific rules (finance, healthcare) require traceability, risk records and human oversight procedures.
4. Reproducibility. Teams must be able to recreate a model version, including:
- the dataset version,
- the feature engineering steps,
- the hyperparameters,
- the code and environment.
This supports debugging, auditing and retraining.
5. Knowledge transfer and continuity. Data scientists move on. Operations, MLOps and support teams need clear handover materials to run the model without depending on the original builders.
6. Operational reliability. Models degrade through data drift, concept drift and changing business conditions. Operational procedures define how this is detected and handled before it causes business harm.
7. Risk management and accountability. Documentation records who approved what, under what assumptions, and with what known risks. This makes clear governance and ownership possible.
8. Supports the iterative nature of CPMAI. CPMAI stresses iterating, starting small and returning to earlier phases when needed. Good documentation makes each iteration build on the last rather than starting over.
What Model Documentation Includes
1. Model Card / Model Fact Sheet
- Model name, version, owner and date
- Intended use and intended users
- Out-of-scope or prohibited uses
- Model type and algorithm (e.g., gradient boosted trees, neural network, LLM fine-tune)
- Performance metrics, overall and by relevant subgroups
- Known limitations, biases and ethical considerations
- Evaluation datasets and conditions
2. Data Documentation (Datasheets for Datasets)
- Data sources, provenance, licensing and consent
- Collection methods and time periods
- Labeling process and quality checks
- Preprocessing, cleansing and transformation steps
- Data splits (training, validation, test)
- Privacy, PII handling and data retention rules
3. Development and Experiment Records
- Experiments tried, hyperparameters and results
- Feature engineering logic
- Code repository, commit references and environment/dependency versions
- Rationale for choosing the final model, including trade-offs such as accuracy vs. explainability or latency vs. performance
4. Evaluation Documentation
- Technical metrics: accuracy, precision, recall, F1, AUC, RMSE, etc.
- Business KPIs tied back to the success criteria set in Business Understanding
- Fairness, robustness, explainability and stress testing results
- Acceptance criteria and the go/no-go decision with sign-offs
5. Risk and Governance Records
- Risk assessment and mitigations
- Ethical review outcomes
- Regulatory mapping
- Approval workflow and accountable owners
6. Deployment Documentation
- Architecture and integration points (APIs, batch jobs, edge)
- Infrastructure requirements
- Input/output schemas
- Security controls and access permissions
What Operational Procedures Include
Operational procedures are the runbooks and standard operating procedures (SOPs) that govern the model after deployment.
- Deployment procedures: release steps, staging environments, canary or shadow deployment, A/B testing, rollback plans.
- Monitoring procedures: what is monitored, including:
- model performance,
- data drift,
- concept drift,
- prediction distribution,
- latency, uptime and errors,
- fairness metrics.
They also define thresholds, alerting rules and dashboards.
- Incident response: what to do when the model fails or produces harmful outputs, escalation paths, kill-switch or fallback to manual/rule-based processes.
- Retraining and model refresh: triggers (scheduled, performance-based or drift-based), the retraining pipeline, revalidation and re-approval steps.
- Version control and change management: model registry, versioning of models, data and code, change approval board, audit trail.
- Human-in-the-loop procedures: when humans review, override or approve model outputs.
- Access and security: who can change, deploy or query the model; protection against adversarial attacks and data leakage.
- Roles and responsibilities (RACI): model owner, data steward, MLOps engineer, business owner, risk/compliance.
- Decommissioning / retirement: criteria and steps for sunsetting a model, archiving artifacts and notifying stakeholders.
How It Works in Practice (Lifecycle View)
Step 1 - Start documenting early. Documentation begins in Business Understanding (objectives, success criteria, AI pattern, go/no-go) and continues through every phase. It is not an afterthought written at the end.
Step 2 - Capture data lineage. During Data Understanding and Data Preparation, record sources, quality issues, transformations and the dataset versions used.
Step 3 - Track experiments. In Model Development, use experiment tracking tools (e.g., MLflow, Weights and Biases) and a model registry so every candidate model is reproducible.
Step 4 - Record evaluation and approval. In Model Evaluation, document:
- technical metrics,
- business metrics,
- fairness and robustness results,
- the formal decision to proceed, iterate or stop.
Step 5 - Write operational runbooks before go-live. Define monitoring, alert thresholds, incident handling, retraining triggers and owners as part of readiness for Model Operationalization.
Step 6 - Hand over and train. Transfer knowledge to operations and business users, and ensure users understand limitations and appropriate use.
Step 7 - Maintain as living documents. Update documentation with each retraining, version change, incident or regulatory change. Stale documentation is a risk in itself.
Step 8 - Feed back into iteration. Monitoring findings and lessons learned trigger a return to earlier CPMAI phases when needed.
Key Concepts to Know
- Model card: standardized summary of a model's purpose, performance and limitations.
- Datasheet for datasets: standardized documentation of a dataset.
- Model registry: central repository for versioned models and their metadata.
- Data drift: change in input data distribution over time.
- Concept drift: change in the relationship between inputs and the target.
- MLOps: practices that combine ML, DevOps and data engineering to operationalize models reliably.
- Lineage and traceability: ability to trace an output back to its model version, data and code.
- Runbook / SOP: step-by-step operational instructions.
- Rollback plan: procedure to revert to a previous stable model version.
- Human-in-the-loop: human oversight embedded in the decision process.
Exam Tips: Answering Questions on Model Documentation and Operational Procedures
1. Favor proactive over reactive. If an option says to define monitoring, documentation or retraining procedures before deployment, it is usually better than one that addresses issues after problems appear.
2. Documentation is continuous. Be wary of answers implying documentation happens only at the end of the project. CPMAI expects documentation across all phases.
3. Models are never done. Answers that treat deployment as the finish line are usually wrong. Look for:
- ongoing monitoring,
- drift detection,
- retraining,
- lifecycle management.
4. Tie back to business objectives. The strongest answers connect model metrics and monitoring to the business success criteria defined in Business Understanding, not just technical accuracy.
5. Reproducibility and traceability are key words. When a question involves audits, regulators, unexplained behavior or rebuilding a model, look for the answer involving versioning of data, code and models plus lineage records.
6. Performance drop scenario. If a deployed model's performance degrades, the typical best sequence is:
- consult monitoring data and documentation,
- investigate the cause (often data or concept drift),
- follow the defined retraining or incident procedure,
- revalidate before redeploying.
Avoid answers that jump straight to building a new model or ignore the established procedure.
7. Harmful or erroneous output scenario. Choose answers that follow the incident response procedure: contain the issue (rollback or fallback to a human or prior version), notify stakeholders, find the root cause and document lessons learned.
8. Handover scenario. When a data science team leaves or hands off to operations, the correct answer usually involves complete documentation, runbooks, knowledge transfer and clearly assigned ownership.
9. Transparency and ethics. Questions about trustworthy AI often point to model cards that disclose limitations, intended use, out-of-scope uses and bias testing results. Hiding limitations is never correct.
10. Clear ownership. Answers that assign accountable roles (model owner, RACI) beat vague collective responsibility.
11. Governance and approvals. Changes to production models should go through change management, revalidation and documented approval. Be suspicious of options that let individuals push model changes straight to production.
12. Watch for distractors. Common wrong answers include:
- relying solely on the original developer's memory,
- documenting only code,
- monitoring only system uptime and ignoring model quality,
- retraining without revalidation,
- skipping documentation to save time under schedule pressure.
13. Think of the PM perspective. The exam tests you as an AI project manager. Prefer answers where the PM ensures processes, standards and stakeholder communication exist, rather than personally performing technical tasks.
14. Iteration mindset. If monitoring reveals the business problem or data has fundamentally changed, the best answer may be to return to an earlier CPMAI phase (Business or Data Understanding) rather than simply retraining.
Quick Example Question
A fraud detection model in production shows a steady decline in precision over three months. Investigators report many more false positives. What should the project manager do FIRST?
A) Immediately replace the model with a new deep learning model
B) Follow the documented monitoring and retraining procedure to analyze drift and determine root cause
C) Lower the alert threshold so fewer cases are flagged
D) Ask users to ignore false positives until the next release
Answer: B. It follows established operational procedures, investigates drift, and leads to controlled retraining and revalidation. A is premature. C is an undocumented ad-hoc change. D ignores the risk.
Summary
Model Documentation and Operational Procedures make AI models:
- understandable,
- reproducible,
- auditable,
- maintainable,
- safe to operate over time.
In the exam, choose answers that are proactive, continuous, traceable, governed, tied to business value, and that treat the model as a living asset needing ongoing monitoring, maintenance and eventual retirement.