Compliance

​

Agent compliance

​

Required

• Has agent.yaml at the repository root (or declared agent root)
• agent.yaml includes opengap, name, version, model.provider, and model.name
• The opengap field value matches the format "MAJOR.MINOR" (e.g., "0.4")
• All skills in skills/ export at least one skill-decorated function
• No undeclared file dependencies outside the agent directory tree
• All referenced environment variables are documented (in README or agent.yaml comments)

​

Recommended (not required for compliance)

• Has a tests/ directory with at least one test per skill
• Skills include descriptive description fields (not empty strings)
• agent.yaml has a description field
• .gitignore excludes .env, *.pyc, __pycache__

​

Validation

gitagent validate

​

Runtime compliance

​

Discovery

• Reads agent.yaml from the agent root to initialize the agent
• Rejects agents whose opengap version it does not support, with a clear error
• Discovers skills by scanning the skills.path directory (default: skills/)
• Loads skills from .py files and Python packages in the skills directory
• Discovers hooks from the hooks.path directory (default: hooks/)
• Discovers flows from the flows.path directory (default: flows/)

​

Skill contract

• Passes skill inputs as keyword arguments matching the function signature
• Returns skill output as a JSON-serializable value
• Reports SkillError to the LLM as a tool error (not as an exception)
• Enforces the input_schema if provided in the skill decorator

​

Execution

• Respects execution.max_iterations — stops the agent loop after N iterations
• Respects execution.timeout — cancels the run after N seconds
• Injects conversation history (last memory.max_history turns) into the context when memory.enabled: true

​

Environment variable interpolation

• Resolves ${VAR_NAME} and ${VAR_NAME:-default} in agent.yaml values
• Fails with a clear error if a required variable (no default) is not set

​

Validation command

• Implements validate (or equivalent) that checks agent compliance and reports violations

​

Version negotiation

• Reports the OpenGAP spec version(s) it supports
• Refuses to execute an agent targeting an unsupported spec version

​

Spec version compatibility

​

Requesting compliance certification

1. Implement all required runtime compliance criteria above
2. Run the OpenGAP compliance test suite against your runtime
3. All tests must pass
4. Open a PR to the OpenGAP repo adding your runtime to RUNTIMES.md