Catalog
obiot/imda-ai-governance

obiot

imda-ai-governance

Engineering reference for aligning agentic AI systems with Singapore IMDA's Model AI Governance Framework for Agentic AI (v1.5, 2026). Use when designing, reviewing or changing anything that builds or deploys an AI agent — agent architecture and design docs, tool / MCP / API integrations, agent identity and permissions, human-approval flows, guardrails, evals and pre-deployment tests, monitoring and logging, rollout and change management, third-party agent platforms, or end-user disclosure for agents. Also covers, as a supplement, IMDA's Model AI Governance Framework for Generative AI (2024) for the model, training / RAG data and generated content underneath an agent, and for generative features that take no actions.

v1.0LATEST
NewUpdated Oct 7, 2026

IMDA AI Governance — Layered Reference for Agentic Systems

Skill version: 0.3.1 · Primary framework: MGF for Agentic AI v1.5 · Supplement: MGF for Generative AI (2024)

⚠ Reference material, not legal or regulatory advice

This skill is engineering reference material. It is not legal advice, not regulatory advice, and not an assessment or certification of any kind. The maintainers are not affiliated with, endorsed by, or speaking for the Infocomm Media Development Authority (IMDA) or any other Singapore government agency.

The Model AI Governance Framework (MGF) for Agentic AI is voluntary guidance. It describes emerging good practice; most of it is phrased as what organisations "should consider". This skill does not turn it into law, and alignment with it does not discharge obligations under statutes that do bind you (the PDPA, sector rules such as MAS notices, contract terms). Always (a) verify any section reference or quotation against the official IMDA publication, and (b) involve your organisation's risk, security, legal and compliance owners before treating a design as approved.

Source-text posture: this skill does not reproduce or republish the framework. It provides engineer-facing interpretation, short attributed quotations of operative phrases, and section references, with a pointer to the official source. See DISCLAIMER.md, including § Copyright in source materials.

By using this skill you accept the full disclaimer in DISCLAIMER.md, including the "use at your own risk" terms and the maintainers' zero liability for any decision taken in reliance on this content.

This skill helps engineers make sure that what they design and build — architecture, agent design, permissions, approval flows, tests, monitoring, rollout plans, user-facing disclosures, internal guidelines — lines up with IMDA's MGF for Agentic AI. The agentic framework is the primary bar. IMDA's earlier MGF for Generative AI is applied as a supplement for what sits under the agent: the model, the data it was tuned or grounded on, and the content it generates. It is organised by where in the system the expectation lands, not by framework section number, so an engineer can work from the thing in front of them (a tool definition, an approval dialog, a deploy plan) rather than from the PDF.

Two conventions run through the layer files, checklists and templates (framework notes in frameworks/ restate the framework, and say where they add interpretation):

  • [MGF §x.y] marks something the agentic framework itself says, with the section it comes from. That is the alignment bar.
  • [MGF-GenAI <dimension>, p.N] marks something the generative-AI framework says. That framework has no section numbers, so it is cited by dimension and page.
  • [Practice] marks an engineering pattern this skill recommends to meet that bar. It is not an IMDA requirement and can be substituted by anything that achieves the same outcome.

Keep that distinction in every review you write. A reviewer who presents a [Practice] item as "IMDA requires X" is overstating the framework.

Step 1 — Establish scope and the project's governance config

On first use in a project, check for .ai-governance.json at the project root. If present, load the listed frameworks' frameworks/<code>/README.md, and read riskTier and agentRegistry before doing anything else. If absent, establish three things with the user — or, when nobody is available to ask (an automated review, a CI run, a reviewer working from documents), infer them from the material, mark them provisional, list what you'd have asked as open questions, and carry on:

  1. Is this agentic? The framework targets systems that plan and take actions over multiple steps towards a goal, built on SLM / LLM / MLLM models [MGF §1.1]. A generative feature with no tools or actions (chat, summariser, RAG Q&A, content generation) is out of the agentic framework's scope: use the generative-AI supplement as the bar instead, starting from checklists/new-genai-feature.md.
  2. What is the organisation's role in the value chain? Model developer, tooling provider, platform provider, system provider / app developer, deployer, or several [MGF §2.2.1]. A team building an agent and running it in-house is both system provider and deployer.
  3. What is the agent's current risk tier? If nobody has assessed it: when designing, run checklists/new-agent.md section 1 first; when reviewing, set a provisional tier as checklists/design-review.md step 2 describes. Every later decision — how many approval checkpoints, how much testing, how gradual the rollout — is calibrated to it.

Then suggest creating .ai-governance.json so future sessions and the changed-file guardrail don't re-ask:

{
  "aiGovernance": {
    "frameworks": ["sg-mgf-agentic", "sg-mgf-genai"],
    "role": ["system-provider", "deployer"],
    "riskTier": "unassessed",
    "agentRegistry": "docs/agents/",
    "reviewPolicy": "warn"
  }
}

frameworks lists the primary framework first. Use ["sg-mgf-agentic", "sg-mgf-genai"] for agents and ["sg-mgf-genai"] for generative features that take no actions. riskTier is one of unassessed, low, medium, high (see layer 02). agentRegistry is the folder holding one AGENT_CARD.md per agent. If the project cannot take that file, record the same facts in the project's AGENTS.md, CLAUDE.md or equivalent instruction file.

Framework codes: sg-mgf-agentic (primary) and sg-mgf-genai (supplement). How they relate, and to the 2020 baseline, is in frameworks/_index.md.

Step 2 — Pick the right entry point

You're reviewing something that already exists — a design doc, architecture diagram, ADR, internal guideline, PR or running system — and want to know whether it is aligned:

Task Checklist
Review a design, architecture or guideline for alignment, and write up the gaps checklists/design-review.md → output in the shape of ALIGNMENT_REVIEW.md.template

You're starting work on something. Open the matching checklist:

Task Checklist
Designing a new agent, or a new agentic feature in an existing product checklists/new-agent.md
Giving an agent a new tool, API, MCP server, data source, or computer-use / browser access checklists/new-tool-or-integration.md
Adopting a third-party agent, agent platform, or SaaS product with embedded agents checklists/third-party-agent.md
Getting an agent ready to ship (release gate) checklists/pre-deployment.md
Changing a deployed agent — model, prompt, tools, autonomy, workflow checklists/change-review.md
An agent did something it shouldn't have checklists/agent-incident.md
Building a generative feature that takes no actions (chat, summariser, RAG Q&A, content generation) checklists/new-genai-feature.md
Adding a fine-tuning set, RAG corpus or index, or evaluation dataset checklists/new-dataset-or-corpus.md

You want depth on a specific layer. Open the matching layer file:

Layer What it covers
01 Accountability Who owns what across the value chain, vendor terms, adaptive governance, residual-risk sign-off
02 Use case and risk Suitability, impact and likelihood factors, tiering, threat modelling and taint tracing
03 Architecture and bounding Action-space, autonomy, SOP-driven workflows, sandboxes, blast radius, kill switch, multi-agent topology
04 Identity and authorisation Agent identity, delegation, least privilege, session-bound scopes, central registry
05 Technical controls Structural vs prompt-layer controls; planning, tool, protocol / MCP, multi-agent and runtime controls
06 Human oversight Approval checkpoints, approval UX, automation bias, fail-closed approvals
07 Testing and evaluation Task, policy, tool-call and robustness tests; workflow-level and multi-agent tests; repeated runs
08 Monitoring and operations What to log, alerts, interventions, immutable trails, gradual rollout, change management, incidents
09 End-user transparency Agent disclosure, capability statements, escalation contacts, training, tradecraft retention, labelling and provenance of generated content
10 Data and grounding Training, fine-tuning, RAG and evaluation data: provenance, licence, personal data, quality, poisoning, documentation

Layer files say how to build it. What the agentic framework expects, section by section, lives in the dimension files listed below; use framework-map.md to cite a section in a PR description or review. The generative-AI supplement is in frameworks/sg-mgf-genai/. Disclosure for the system as a whole goes in a SYSTEM_CARD.md alongside each agent's card.

Framework files

Open these directly rather than following links from one file to the next:

Framework Start here Section lookup Dimensions
sg-mgf-agentic (primary) README · case studies framework-map 00 foundations · 01 assess and bound · 02 human accountability · 03 technical controls · 04 end user responsibility
sg-mgf-genai (supplement) README framework-map 01 accountability · 02 data · 03 trusted development and deployment · 04 incident reporting · 05 testing and assurance · 06 security · 07 content provenance · 08 safety and alignment rnd · 09 ai for public good

Templates: AGENT_CARD.md, SYSTEM_CARD.md, ALIGNMENT_REVIEW.md, and ai-governance-nudge.sh (changed-file reminder hook).

Load-bearing principles (commit to memory)

These recur across the framework and settle most design arguments. Each links to the section that carries it.

Principle What it means for a design Source
Bound by design, not by prompt If an agent must not do something, make it impossible at the tool, permission or workflow layer. A system-prompt instruction is the weakest control available and is not sufficient on its own for higher-risk actions. [MGF §2.1.2, §2.3.1]
Risk = impact × likelihood, assessed per agent Impact grows with domain criticality, sensitive-data access, external access, write scope and irreversibility. Likelihood grows with autonomy, task complexity, untrusted inputs, third-party opacity and system complexity. [MGF §2.1.1]
Least privilege, scoped and non-transferable Minimum tools and data for the task; authorisations time- or session-bound; as a rule of thumb, an agent holds no more than the human who delegated to it. [MGF §2.1.2]
Every agent has an identity and an owner Unique, verifiable identity; tied to a human, team or supervising agent; capacity recorded; issued from a central registry to stop sprawl. [MGF §2.1.2]
Humans approve the irreversible and the high-stakes Define checkpoints for high-stakes, irreversible, atypical and user-defined actions; make approval requests short and clear; deny by default when approval infrastructure fails. [MGF §2.2.2]
Oversight decays — measure it Track override rates and review times; low override rates and fast approvals can signal rubber-stamping. [MGF §2.2.2]
Test the workflow, not just the answer Test task execution, policy compliance, tool calls (right tool, permission, input, order) and robustness, across whole trajectories, repeatedly, in realistic environments, individually and as a multi-agent system. [MGF §2.3.2]
Roll out gradually, monitor continuously Stage by users, tools and systems; log and trace every step; define alerts and the intervention each one triggers; keep failure trajectories undeletable. [MGF §2.3.3]
Changes get risk-categorised review Model updates, tool changes, autonomy changes, domain shifts and regulatory changes are triggers; review depth scales with the change. [MGF §2.3.3]
Tell users what the agent is and can do Declare the agent at the point of interaction, state its range of actions and data use, and name a human to escalate to. [MGF §2.4]
Know what's under the agent (supplement) Pinned model from a reputable source; documented training, RAG and eval data; disclosure of evaluations, limits and intended use; a way for outsiders to report unsafe behaviour; labelled generated content. [MGF-GenAI]

How to use the layer ↔ framework split

The pattern is design once against the layers, then check against the framework:

  1. Establish scope, role and risk tier (Step 1).
  2. Walk the relevant layers/ to plan or critique the implementation.
  3. Walk frameworks/sg-mgf-agentic/dimensions/01–04 (and, for the model and data layer, the generative-AI supplement) and confirm each expectation that applies is met, partly met, not met, or not applicable — with evidence (a file, a config, a test, a dashboard), not intent.
  4. Record the outcome where the next engineer will find it: the agent's AGENT_CARD.md, the PR description, or an alignment review.

When reviewing, report against what exists, not what the author meant. A design doc that says "the agent will only read" while the tool grants write scope is a finding. A guardrail that lives only in the system prompt, protecting an irreversible action, is a finding. "We'll add monitoring later" for an agent heading to production is a finding.

Interactions with other obligations

  • Personal data. Agents that touch personal data also carry PDPA (or other data-protection) obligations, which are law, not guidance. The MGF points to the organisation's data privacy policies and explicit consent where needed [MGF §2.4.2]; it does not replace them. If the personal-data-protection skill is installed, run it alongside this one.
  • Cybersecurity. The MGF defers to CSA's Draft Addendum on Securing Agentic AI and GovTech's Agentic Risk & Capability Framework for control catalogues [MGF §2.3.1]. This skill does not reproduce them.
  • Copyright and licences. Training, fine-tuning and RAG content can carry copyright and licence terms. The generative-AI framework flags this but leaves it to law [MGF-GenAI Data, p.11]; involve legal before using content you don't have clear rights to.
  • Sector rules. Financial services, healthcare and public-sector deployments typically have binding rules on outsourcing, model risk and technology risk that sit above this framework.

Framework version

frameworks/sg-mgf-agentic/README.md and frameworks/sg-mgf-genai/README.md record which version of each framework the content reflects, when it was last verified, and what to watch for. The framework calls itself a living document and is updated as practice develops; check IMDA for a newer version before relying on a section number. See the upstream CHANGELOG.md and pin to a tag if you need stability.

Overall Score

82/100

Grade

B

Good

Grades are signals, not a certification. Always review a skill yourself before use.

Safety

88

Quality

80

Clarity

82

Completeness

78

Summary

A comprehensive engineering reference skill that helps teams align agentic AI systems with Singapore's IMDA Model AI Governance Framework (Agentic v1.5, 2024). It provides checklists, layer-based design guidance, templates, and framework mappings to guide architecture, testing, monitoring, and disclosure decisions across the agent lifecycle. The skill is structured for engineers to use either as a linear process (establish scope → pick entry point → dive into layers) or as a quick reference (jump to a specific layer or checklist).

Detected Capabilities

file readingframework reference mappingchecklist navigationgovernance documentation reviewno direct file writes or shell execution — reference and guidance only

Trigger Keywords

Phrases that agents use to match this skill to user intent.

ai governance frameworkagentic system reviewimda alignmentagent design checklistagent risk assessmentdeployment gate reviewagent incident responsethird-party agent evaluation

Risk Signals

INFO

Disclaimer and reference material assertion (not legal advice, not regulatory advice, not certification)

Preamble after frontmatter
INFO

References external GitHub repository for DISCLAIMER.md and other content

Section 'Reference material, not legal or regulatory advice'
INFO

Directs users to verify framework quotations against official IMDA publication

Preamble disclaimer

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.com

Use Cases

  • Reviewing an agent's architecture or design doc against IMDA governance expectations
  • Planning a new agent system from first principles (agents, tools, integrations, workflows)
  • Preparing an agent for production release (pre-deployment checklist)
  • Evaluating a third-party agent platform or tool integration for governance alignment
  • Incident response: understanding what went wrong in an agent incident and what controls were missing
  • Documenting an agent's capabilities, data access, and safeguards in an AGENT_CARD or SYSTEM_CARD
  • Adding tools, APIs or data sources to an existing agent with governance review
  • Monitoring and change management: assessing whether a model update or tool change requires a re-review

Quality Notes

  • ✓ Comprehensive scope definition — establishes Step 1 (establish governance config), Step 2 (pick entry point), then drills into layers and frameworks
  • ✓ Clear entry points via structured checklists and templates for different tasks (new agent, new tool, design review, pre-deployment, incident response)
  • ✓ Principled design guidance: 10 load-bearing principles with framework citations, recurring across layers
  • ✓ Strong governance hygiene: configuration file pattern (.ai-governance.json) to track frameworks, role, risk tier and agent registry
  • ✓ Dual-framework strategy: primary (Agentic AI v1.5) with optional supplement (Generative AI 2024) for model/data layer
  • ✓ Clear distinction between framework expectations [MGF §x.y] and engineering practices [Practice]
  • ✓ Well-organized by system layer (10 layers) rather than by framework section, enabling engineers to work from the artifact in front of them
  • ✓ Templates provided for AGENT_CARD, SYSTEM_CARD, ALIGNMENT_REVIEW to record and track compliance
  • ✓ Case study and examples expected in frameworks/ directory
  • ✓ Robust cross-references and links to framework dimensions; central framework-map for section lookup
  • ⚠ Relies heavily on external files not shown in SKILL.md (layer files, checklists, framework dimensions, templates) — completeness depends on supporting directory structure
  • ⚠ No worked example in the skill body itself — text is reference, not tutorial; users need to follow links to checklists
  • ⚠ Assumes familiarity with IMDA frameworks and concepts; no primer for engineers new to AI governance
  • ⚠ Tone is formal and legalistic; while appropriate for governance, may feel prescriptive rather than enabling to some teams
Model: claude-haiku-4-5-20251001Analyzed: Oct 7, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use obiot/imda-ai-governance in your dev environment

Command Palette

Search for a command to run...