name: titan-mutation-gate
description: Gate Forge workspace-write work with explicit intent, target paths, prechecks, validation, and rollback or stop posture. Use when a Titan service-cohort route needs this explicit bounded step. Do not use for hidden background agents, silent mutation, unreviewed proof sovereignty, or memory canonization without owner confirmation.
license: Apache-2.0
compatibility: Designed for Codex or similar coding agents with repository file access and an interactive shell. Network access is optional and only needed when repository validation or referenced workflows require it.
metadata:
aoa_scope: project
aoa_status: scaffold
aoa_invocation_mode: explicit-only
aoa_source_skill_path: skills/project/titan/titan-mutation-gate/SKILL.md
aoa_source_repo: 8Dionysus/aoa-skills
aoa_technique_dependencies: AOA-T-0028,AOA-T-0004,AOA-T-0091
aoa_portable_profile: codex-facing-wave-3
titan-mutation-gate
Intent
Use this skill before Forge performs any workspace-write or code mutation work.
Trigger boundary
Use this skill when:
- Forge is being asked to edit files
- the mutation target and validation path need to be explicit
- Atlas, Sentinel, and Mneme prechecks must be visible before mutation
Do not use this skill when:
- the request has no explicit mutation intent
- targets or validation are unclear
- the action is destructive without approval and rollback posture
- intent text
- target repos and paths
- allowed actor
- precheck evidence
- validation command
- rollback or stop condition
Outputs
- mutation gate packet
- allowed or blocked decision
- precheck summary
- validation expectation
- rollback or stop note
Procedure
- verify explicit Forge mutation intent and allowed actor
- name target repos, paths, prechecks, validation, and rollback or stop condition
- collect Atlas route, Sentinel risk, and Mneme provenance notes
- fail closed when approval, target, validation, or rollback posture is missing
- emit an allow or block packet linked to the receipt or approval ledger
Contracts
- The skill is explicit-only and must not be invoked as hidden background behavior.
- Titan role, helper/control-plane, runtime implementation, memory, proof, and public-runbook authority stays in owner repositories: aoa-agents, aoa-sdk, abyss-stack, aoa-memo, aoa-evals, and 8Dionysus.
- Receipts, bridge ledgers, console state, replay artifacts, approval records, and memory records are witnesses or candidates, not final owner truth.
- Forge mutation and Delta judgment gates must remain distinct, operator-visible, and receipt-linked.
- Missing source refs, missing approval, missing validation, or unclear owner route must be named as stop conditions.
Risks and anti-patterns
- treating Titan vocabulary as permission to widen authority
- letting receipt, replay, console, or bridge state replace owner-repo evidence
- auto-approving Forge or Delta because a plan looks plausible
- promoting candidate memory, approvals, replay, or receipts into canon without owner review
- using the skill for an ordinary repo task that has no explicit Titan route
Verification
- confirm direct skill invocation or explicit Titan service-cohort request is present
- confirm lane, gate, source refs, and owner surface are named when relevant
- confirm Forge or Delta locked or allowed state matches recorded approval evidence
- confirm generated artifacts are marked witness, candidate, derived, or advisory rather than final truth
- confirm next validation, replay, repair, or owner-route follow-up is named before continuation
Technique traceability
Manifest-backed techniques:
- AOA-T-0028 from
8Dionysus/aoa-techniques at 3b1d5d623569aa4920b87280d0db0e911d2e29d5 using path techniques/execution/agent-workflows-core/confirmation-gated-mutating-action/TECHNIQUE.md and sections: Intent, When to use, Inputs, Outputs, Core procedure, Contracts, Validation - AOA-T-0004 from
8Dionysus/aoa-techniques at 3b1d5d623569aa4920b87280d0db0e911d2e29d5 using path techniques/execution/intent-chain/intent-plan-dry-run-contract-chain/TECHNIQUE.md and sections: Intent, When to use, Inputs, Outputs, Core procedure, Contracts, Validation - AOA-T-0091 from
8Dionysus/aoa-techniques at 3b1d5d623569aa4920b87280d0db0e911d2e29d5 using path techniques/proof/owner-truth-closeout/workspace-root-ingress-and-mutation-gate/TECHNIQUE.md and sections: Intent, Inputs, Outputs, Core procedure, Contracts, Risks, Validation
Adaptation points
- Extract a Titan-specific reusable technique into aoa-techniques only after repeated reviewed evidence exists; do not add pending IDs as placeholders.
- Keep repo-local command examples in owner docs or examples rather than hard-coding them into skill law.
- If a Titan surface graduates from scaffold to reviewed or evaluated, add review evidence before changing status.