[Draft] Add skills and agents for configuring Marlim3 simulations

[yantavares]

Add skills and agents for configuring Marlim3 simulations

This pull request introduces an agent-based workflow for developing Marlim3 simulations, defining the role of each agent, the orchestration logic, and the documentation required for usage and maintenance. The workflow organizes the planning, implementation, and validation stages of the simulation process.

Workflow and agent definitions

• Adds .github/agents/marlim3.agent.md, which defines the orchestrator agent, responsible for coordinating the development workflow, delegating tasks to the planning, implementation, and QA agents, and managing approval and revision cycles.
• Adds .github/agents/marlim3-planner.agent.md, which defines the planning agent, responsible for conducting interviews, extracting information from the documentation, and generating ADRs while following rules for handling default values, units, and source documents.
• Adds .github/agents/marlim3-specialist.agent.md, which defines the specialist agent, responsible for implementing the ADR in .mr3 files, Python scripts, and pytest tests, following the ADR specifications and the repository conventions.
• Adds .github/agents/marlim3-qa.agent.md, which defines the QA agent, responsible for validating the implementation against the ADR, performing schema and plausibility checks, running the test suite, and generating a validation report.

flowchart TD
    U([User describes the simulation]) --> O[marlim3<br/>orchestrator]
    O --> P[marlim3-planner<br/>interview via askQuestions]
    P --> ADR["docs/slug.adr.md"]
    ADR --> G{User approves the ADR?}
    G -- revise --> P
    G -- yes --> S[marlim3-specialist<br/>implements and tests]
    S --> IMPL["simulations/slug/slug.mr3<br/>tests/test_slug.py"]
    IMPL --> Q[marlim3-qa<br/>validates against the ADR]
    Q --> R["docs/slug.qa.md"]
    R --> V{Verdict}
    V -- FAIL, max. 2 cycles --> S
    V -- PASS --> F([Final report])

Loading

Documentation and developer guidance

• Adds .github/README-agents.md, providing an overview of the workflow, usage instructions, descriptions of the agents and skills, and guidance for using the pipeline.
• Adds .github/copilot-instructions.md, containing instructions for GitHub Copilot and contributors about the agent workflow, along with references to the project's documentation and conventions.