Projects / employee.md

AI & tools / Schema + tooling

employee.md

Define an agent’s role, tools, and policies in YAML, then validate the contract with a JSON Schema, CLI, and Python helpers.

NosytLabs/employee-mdPublic repository

Overview

What it does

  • Describe agent roles, scope, permissions, and policies in YAML.
  • Validate the contract structure using the JSON Schema and CLI.
  • Use Python helpers and reference contracts as a starting point.

An agent contract format with a JSON Schema, CLI validator, and Python helpers. Policy enforcement requires integration with the agent runtime.

A written contract does not enforce itself. Policy enforcement requires integration with the agent runtime.

Project preview

Open source page
Published employee.md documentation introducing the agent contract format and runtime boundaries.
Published documentation

Published documentation · 2026-10-23

Getting started

Validate your first contract

A Python environmentA local source checkout
  1. Clone the repository and install the package into your Python environment.
  2. Validate the included minimal contract, then copy a reference example for your own agent.
  3. Connect the relevant checks to your executor. Schema validation checks the document; runtime enforcement needs your integration.
Install from source and validate
git clone https://github.com/NosytLabs/employee-md.git
cd employee-md
python -m pip install -e .
employee-validate examples/minimal.md

The required sections are spec, role, and lifecycle. Optional sections cover tool access, guardrails, integrations, budgets, and other agent settings.

Browse reference contracts

Based on the public README, reviewed 23 October 2026. Check the repository for updates.

Keep exploring

Related projects

All five projects

Client work

Work with Nosytlabs.

Contact the studio

Search pages and projects

Tab to move · Enter to open · Esc to close