Skip to content

Consider applying MIKE IO's agent-documentation work here #700

Description

@ecomodeller

Placeholder — not to be actioned yet.

MIKE IO is running an exercise to make its documentation work well for AI agents writing user scripts: measure what agents actually get wrong, ship the guidance inside the wheel so it is version-matched and reachable offline, and execute every code snippet in CI so it cannot rot. The plan is roadmap/ai-agent-documentation.md, tracked in DHI/mikeio#995.

modelskill has the same shape of problem — an API that agents write advisory scripts against, with idioms a model will not infer correctly on its own — so the approach should transfer. It also sits downstream of mikeio, which raises a question worth answering before copying anything: whether an agent needs one combined picture of both libraries rather than two separate guides it may only find one of.

Revisit once the mikeio work has a measured before/after. If it did not move the numbers there, it will not move them here either.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions