Documentation Guides / Regulated teams

Site

Docs Guides

Regulated teams (ISO 27001, ISO 42001)

This page maps the OpenGantry workflow to common audit questions for teams that use AI-assisted development in regulated domains such as fintech, health and critical infrastructure.

It is operational guidance, not legal or certification advice. ISO 27001 and ISO 42001 conformance depends on your whole information security or AI management system: scope, policies, training and third-party assessment. OpenGantry produces the engineering artifacts and process controls auditors typically ask for. It does not grant certification.

What auditors look for

Auditors for ISO 27001 (information security management) and ISO 42001 (AI management systems) generally do not evaluate prompt engineering. They look for:

  • Operational evidence: records that show controls ran, not only policy documents.
  • Segregation of duties: the party that executes work is not the party that approves it.
  • Blast-radius control: limits on what an automated or semi-automated actor can change.

An IDE agent with write access is an untrusted worker inside your management system’s scope, like a contractor with repository access. OpenGantry lets you show who authorized agent work, under what scope, and with what evidence.

ISO 27001: change management and traceability

A.5.3 Segregation of duties. Can the same party propose and approve a change without independent review?

ControlMechanism
Executor ≠ verifierThe agent that runs the gate must not declare it passed
Executor ≠ PlannerScope, gates and edit roots are Planner-owned; executors cannot amend them without the Planner legislating again
Approval before mergegantry verify requires the Planner commit: the newest [MSN-NNNN] commit from an allowlisted Planner email must modify the mission file

A.8.28 Secure development. How do you stop an AI tool from changing security-sensitive configuration or bypassing your development lifecycle?

ControlMechanism
Declared edit scopetmvc_roots and forbidden_zones in the manifest, narrowed per mission
Hard subprocess boundarygantry runtime exec checks edit roots and forbidden zones for orchestrated runs
Governance path protectionHooks block casual shell writes to .gitagent/foreman/, RULES.md and similar paths
Merge gatePre-push and CI gantry verify fail closed without the Planner commit, the gate and the evidence

A.8.15 Logging and monitoring. Can you reconstruct who authorized a change, what was in scope, and what actually ran?

ArtifactContents
.gitagent/missions/MSN-*.yamlDeclared intent, skill, scope, gate command, trace rows
git log --grep='MSN-NNNN'A greppable mission index with author, time and message
EXECUTOR_LOG.mdThe execution trace; a PASS needs a verbatim quote from it
gantry verify outputStructured phases; failures carry GXT_* codes

ISO 42001: AI governance and accountability

Scope and authority limits. Mission files define scope, skill routing, gates and expected evidence before any executor runs, and the Planner reviews them first. The manifest maps skills to trust tiers, edit roots, path risks and forbidden zones. Access outside the scope needs a context request recorded in EXECUTOR_LOG.md.

Human oversight. Work is staged in two phases: a draft mission, a human Planner commit, then execution and verify. Tier 2 and Tier 3 skills require a human audit of the evidence (Missions). Emergency bypass is explicit, secret-gated and recorded (Break-glass).

Monitoring and reversibility. Mission and trace artifacts live in Git: versioned, branchable and revertible like any other change. The pull request workflow and validate checks run on every change, gantry mission pin shows the pinned mission and gantry doctor checks the repository’s setup.

Mapping table

Framework and focusTypical requirementOpenGantry evidenceAdoption note
ISO 27001 change controlManaged, approved changesPlanner commit and mission YAML before merge; verify gate and evidenceFull strength when verify gates merges and the Planner workflow is mandatory
ISO 27001 audit logsWho or what changed systemsEXECUTOR_LOG.md, [MSN-NNNN] commits, mission history; stale-evidence checks bind evidence to the codeQuote matching is forensic process control, not an immutable crypto log
ISO 27001 least privilegeLimited actor capabilitiesEdit roots and forbidden zones; hard enforcement through runtime execAn IDE agent’s own edits are advisory; document your tier
ISO 42001 AI boundariesDocumented, verified limitsMission files and manifest routing before executionScope must be legislated and pinned, not implied in chat
ISO 42001 accountabilityClear ownership of AI outcomesThe Planner email on the legislation commit owns the authorized scopeThe Planner owns the scope, not every line the model wrote; review and verify still apply
ISO 42001 monitoringOngoing oversight of AI in operationsGit-native artifacts, CI validation, structured verify failuresTreat unrecorded bypass or advisory-only use as an audit finding

Honest limits

Compliance claims must match what your deployment actually enforces (Enforcement boundary):

  • gantry runtime exec is the strongest scope trap for subprocess and headless agents.
  • Hooks and pre-push verify block unlegislated governance edits and check the Planner commit on handoff.
  • IDE rules, AGENTS.md and MCP context are guidance only, never enough for an “AI cannot touch X” claim.

Teams that legislate missions but skip runtime exec and merge-time verify keep the audit artifacts but weaken the blast-radius guarantee. Tell assessors which tier you operate at. Trace mapping is process control, not cryptographic tamper-proofing; for a hash-chained ledger and a SOC 2 export, see Org control plane.

Example: a fintech platform

  1. Intent. Product and engineering define the change; the manifest routes it to a skill and risk tier.
  2. Legislation. A Planner reviews scope, gates and edit roots and commits [MSN-NNNN].
  3. Execution. The executor runs under the pinned mission (runtime env or runtime exec) and appends gate output to EXECUTOR_LOG.md.
  4. Verification. An independent verifier phase, human or automated per tier, runs gantry verify before merge.
  5. Audit. The assessor greps git log --grep='MSN-' and reads the mission, the log and the verify record.

What to hand an assessor

The minimal evidence bundle for one agent-assisted change:

git log --grep='MSN-0042' --format=fuller                    # authorization
cat .gitagent/missions/MSN-0042.<slug>.yaml                   # declared scope
cat EXECUTOR_LOG.md                                           # execution trace
gantry verify --mission .gitagent/missions/MSN-0042.<slug>.yaml --audience verifier   # verify record

Include a statement of your enforcement tier (advisory IDE, or runtime exec plus merge verify) and your Planner allowlist policy (GANTRY_PLANNER_EMAILS).