Continual MI
MDL
Endless VN Engine
GamesMGPT APIEarningsMonitoringDocs
Learn
  • Introduction
  • Quick Start
  • MDL CLI
  • How It Works
Build
  • Workspace
  • Agentic Workflow
  • Instructions
  • Schema
  • Assets
Ship
  • Publishing
  • Monitoring
  • Earnings & Payouts
Reference
  • Package Model
  • API Keys & Auth
  • CLI Reference
  • Platform Reference
Docs/Agentic Workflow

Agentic Workflow

MDL game packages are designed to work well with Git and code agents. Keep the package as the reviewable source, use deterministic CLI checks, and treat hosted pushes as deliberate staging actions.

Why local packages matter

Agentic engineering works best when the source of truth is a normal repository with stable paths and text-first artifacts. MDL packages keep prompts, manifests, schema, openings, and published asset rules in files that can be reviewed directly.

Recommended loop

  1. Edit the package locally in Git, using any package-specific skill that applies.
  2. Review the exact file changes before pushing.
  3. Compute or inspect the package inventory hash when you need a stable local checkpoint.
  4. Run mdl diff to inspect the change set against the hosted dev workspace.
  5. Run mdl push only when the diff matches your intent.
  6. Keep release and domain changes separate from ordinary pushes.

Dedicated package skills

Some packages have a dedicated agent skill that gives a code agent the package's local source map, common edit targets, and ownership boundaries. Use those skills for package authoring work, then keep the normal MDL review, hash, diff, and sync loop as the platform handoff.

For example, the Monte Lua package skill lives in the MDL checkout at .agents/skills/montelua-game-package/SKILL.md. It is for work inside ./montelua, including prompt files, manifests, structured-output schema, authored openings, game-owned assets, and bootstrap content that is synced into the hosted montelua workspace.

Skill vs platform docs

Reach for a package skill when the change belongs to the game package: narrative behavior, world rules, package metadata, schema enum values, openings, or game-owned assets. Use the MDL docs and CLI reference when the question is about package transport, hosted workspace behavior, authentication, diff output, release controls, domains, billing, monitoring, or runtime/platform semantics.

The boundary matters. Package files describe the game. MDL owns the engine, hosted runtime, sync APIs, public workspace, release workflow, and player-facing platform behavior. A package skill can help make local edits, but it should not be treated as permission to bypass hosted review or directly edit live hosted state.

Skills belong before sync

A dedicated skill can guide local edits and verification, but mdl diff is still the check that compares the package inventory with the hosted dev container. Push only after reviewing both the Git diff and the MDL diff.

Safe habits

  • Prefer small commits that isolate prompt, schema, and asset changes.
  • Ask agents to name the package skill they are using when the package has one.
  • Keep unpublished reference files outside the published asset globs.
  • Use remote diff output as a final check before mutating hosted state.
  • Do not treat push as a replacement for release review.
  • Use CI secrets or local environment variables for API keys instead of hardcoding them.
Agents should work against the package, not the live runtime

The package is the place for deterministic edits and code review. The hosted dev workspace is where those reviewed changes are staged for platform inspection. Live release should still require an explicit platform action.

What to avoid

  • Bundling unpublished working files into assets.published globs accidentally
  • Using an agent as a direct editor of hosted dev or live state instead of the package
  • Skipping diff inspection and pushing broad changes blindly
  • Using one long-lived API key everywhere without rotation or scope review
  • Collapsing dev push and release into a single automation step

Next

Build
MDL CLI
Use the canonical local commands in the recommended package workflow.
Reference
Package model
See the stable file contract that makes review and automation predictable.
Build
Hosting
Understand how staged pushes fit into the hosted workspace model.