Spec reference · employee.md

spec

# optional type: object

Specification metadata for version tracking

Type	Required	Description
string	●	Must be 'employee.md' enum: employee.md
string	●	Semantic version (e.g., '1.0.0') pattern: ^\d+\.\d+\.\d+$
string	●	Must be 'agent-employment' enum: agent-employment
string	○	Spec maturity status enum: draft, stable, deprecated
string	○	URL to JSON schema format: uri
string	○	License identifier (e.g., 'MIT')
string	○	Project homepage URL format: uri
string	○	Reverse domain namespace
array<string>	○	Compatible spec versions
array<string>	○	Previous versions this replaces
array<string>	○	Parent specifications

identity

# optional type: object

Agent identity and identification

Type	Required	Description
string	○	Unique identifier for the agent
string	○	Agent configuration version
string	○	Human-readable name
string	○	Brief description of the agent
string	○	URL to avatar image format: uri
walletAddress (string \| null)	○	Cryptocurrency wallet address pattern: ^(0x[a-fA-F0-9]{40}\|(bc1\|[13])[a-zA-HJ-NP-Z0-9]{25,87}\|[1-9A-HJ-NP-Za-km-z]{32,44})$
isoDate (string)	○	Creation date (ISO 8601) pattern: ^\d{4}-\d{2}-\d{2}$
isoDate (string)	○	Last update date (ISO 8601) pattern: ^\d{4}-\d{2}-\d{2}$
array<string>	○	Classification tags

role

# required type: object

Job role and responsibilities

Field	Type	Required	Description
	string	●	Job title
	string	●	Experience level enum: junior, mid, senior, lead
	string	○	Department or team
	string	○	Primary function or specialty
	string	○	Manager or supervisor identifier
	array<string>	○	List of skill areas
	array<object>	○	Detailed skills with proficiency levels
↳	string	●
↳	number	●	range: 0..5
↳	string	○	Skill category (e.g., 'language', 'framework')
	array<object>	○	Professional certifications
↳	string	●
↳	string	●
↳	isoDate (string)	○	pattern: ^\d{4}-\d{2}-\d{2}$
↳	isoDate (string)	○	pattern: ^\d{4}-\d{2}-\d{2}$
	string	○	Work location type enum: remote, office, hybrid
	string	○	Employment type enum: full_time, part_time, contract
	string	○	Schedule type enum: fixed, flexible, on_call

mission

# optional type: object

Mission, purpose, and objectives

Type	Required	Description
string	○	High-level mission statement
string	○	URL or text of ethical guidelines
array<string>	○	Key goals to achieve
array<string>	○	Measurable success metrics
array<string>	○	Explicitly out of scope

context

# optional type: object

Operational context and environment

Field	Type	Required	Description
	string	○	Project name
	string	○	Project identifier
	string	○	Repository URL format: uri
	string	○	Repository platform enum: github, gitlab, bitbucket
	string	○	Runtime environment enum: dev, staging, prod
	string	○	Environment tier enum: development, staging, production
	string	○	Team name
	string	○	Team identifier
	string	○	Organization name
	string	○	Cloud region or location
	string	○	Infrastructure provider
	object	○	Related resources and links
↳	string	○	format: uri
↳	string	○	format: uri
↳	string	○	format: uri

scope

# optional type: object

Scope and boundaries

Type	Required	Description
array<string>	○	Included responsibilities
array<string>	○	Excluded responsibilities
array<string>	○	Required dependencies
array<string>	○	Limitations and restrictions

permissions

# optional type: object

Access permissions and controls

Type	Required	Description
array<string>	○	Data access levels
array<string>	○	System/infrastructure access
array<string>	○	Network/external access
array<string>	○	Available tools
boolean	○	Administrative access
boolean	○	Can invite new users
boolean	○	Can modify permissions

verification

# optional type: object

Quality verification and checks

Type	Required	Description
array<string>	○	Mandatory quality gates
array<string>	○	Required proof of work
string	○	Review policy name
boolean	○	Allow automatic merging
integer	○	Minimum number of approvals min: 0
boolean	○	Require passing tests

principles

# optional type: array

Core operating principles

Free-form section — see the JSON Schema for details.

operating_policy

# optional type: object

Operating rules and policies

Type	Required	Description
array<string>	○	Always perform these actions
array<string>	○	Never perform these actions
array<string>	○	Require approval for these
array<string>	○	Document these actions

workflows

# optional type: object

Standard operating procedures

Type	Required	Description
array<string>	○	Work intake process
array<string>	○	Work execution process
array<string>	○	Review process
array<string>	○	Completion/handoff process

outputs

# optional type: object

Outputs and deliverables

Type	Required	Description
array<string>	○	Primary outputs
array<string>	○	Generated artifacts
array<string>	○	Regular reports

economy

# optional type: object

Economic and payment configuration

Field	Type	Required	Description
	number	○	Hourly or per-task rate min: 0
	string	○	Payment currency enum: USD, EUR, BTC, ETH, ENERGY
	string	○	Payment method enum: x402, crypto, fiat, joulework, none
	string	○	Billing frequency enum: weekly, monthly, milestone, real_time
	number	○	Maximum budget min: 0
	string	○	Accounting cost center
	string	○	Compensation model enum: wage, task, joulework, subscription
	string	○	Pricing strategy enum: fixed, dynamic, complexity_based, auction
	boolean	○	Track energy costs
	boolean	○	Track P&L
	string	○	Policy when budget exhausted enum: suspend, escalate, liquidate, auto_loan
	object	○	Wallet addresses
↳	walletAddress (string \| null)	○	pattern: ^(0x[a-fA-F0-9]{40}\|(bc1\|[13])[a-zA-HJ-NP-Z0-9]{25,87}\|[1-9A-HJ-NP-Za-km-z]{32,44})$
↳	walletAddress (string \| null)	○	pattern: ^(0x[a-fA-F0-9]{40}\|(bc1\|[13])[a-zA-HJ-NP-Z0-9]{25,87}\|[1-9A-HJ-NP-Za-km-z]{32,44})$
↳	walletAddress (string \| null)	○	pattern: ^(0x[a-fA-F0-9]{40}\|(bc1\|[13])[a-zA-HJ-NP-Z0-9]{25,87}\|[1-9A-HJ-NP-Za-km-z]{32,44})$
	string \| null	○	Internal token symbol
	object	○	Cost deductions
↳	number	○	LLM/token costs min: 0
↳	number	○	API costs min: 0
↳	number	○	Storage costs min: 0
↳	number	○	Infrastructure costs min: 0
↳	array<object>	○	Other deductions
↳	string	●
↳	number	●	min: 0
↳	string	●

delegation

# optional type: object

Task delegation configuration

Type	Required	Description
integer	○	Maximum concurrent tasks min: 1
string	○	Delegation protocol enum: a2a, A2A, human_review, auto
integer	○	Task timeout in seconds min: 60
boolean	○	Allow re-delegation
array<string>	○	Escalation targets
array<string>	○	Preferred task types
array<string>	○	Excluded task types

lifecycle

# required type: object

Agent lifecycle status

Field	Type	Required	Description
	string	●	Current status enum: onboarding, active, suspended, terminated
	isoDate (string)	○	Employment start date pattern: ^\d{4}-\d{2}-\d{2}$
	isoDate (string)	○	Employment end date pattern: ^\d{4}-\d{2}-\d{2}$
	isoDate (string)	○	End of probation period pattern: ^\d{4}-\d{2}-\d{2}$
	string	○	Performance rating enum: exceeds, meets, needs_improvement
	isoDate (string)	○	Next review date pattern: ^\d{4}-\d{2}-\d{2}$
	string	○	Current availability enum: available, busy, away, offline
	integer	○	Maximum capacity percentage range: 0..100
	array<object>	○	Version history
↳	string	○
↳	string	○
↳	string	○

compliance

# optional type: object

Compliance and governance

Type	Required	Description
array<string>	○	Compliance frameworks (SOC2, GDPR, etc.)
string	○	Data classification level enum: public, confidential, restricted
boolean	○	Enable audit logging
integer	○	Audit log retention period min: 1
string	○	Security clearance level enum: none, basic, secret, top_secret
string	○	Data retention policy
string	○	PII handling policy
boolean	○	Require encryption

communication

# optional type: object

Communication preferences

Type	Required	Description
array<string>	○	Communication channels
string	○	IANA timezone
string	○	Working hours
string	○	Response time commitment
string	○	Email address format: email
string	○	Slack username
array<string>	○	Events to notify on

guardrails

# optional type: object

Safety guardrails and constraints

Type	Required	Description
array<string>	○	Forbidden actions
array<string>	○	Actions requiring approval
number	○	Per-task budget limit min: 0
number	○	Minimum confidence level range: 0..1
integer	○	Maximum execution time (seconds) min: 1
integer	○	Rate limit min: 1
boolean	○	Enable content filtering
array<string>	○	Whitelisted domains
array<string>	○	Blacklisted domains

ai_settings

# optional type: object

AI model and behavior settings

Field	Type	Required	Description
	string	○	Preferred LLM model
	array<string>	○	Fallback model options
	object	○	Token limits
↳	integer	○	Max input tokens min: 1
↳	integer	○	Max output tokens min: 1
↳	integer	○	Context window size min: 1
	object	○	Generation parameters
↳	number	○	Sampling temperature range: 0..1
↳	number	○	Nucleus sampling range: 0..1
↳	number	○	Frequency penalty range: -2..2
↳	number	○	Presence penalty range: -2..2
	array<string>	○	Enabled tool categories
	object	○	Memory configuration
↳	string	○	Memory retention type enum: conversation, session, persistent
↳	integer	○	Max conversation history min: 1
↳	boolean	○	Enable vector memory
↳	boolean	○	Sync with knowledge base
	string	○	Reasoning depth enum: low, medium, high
	boolean	○	Show reasoning steps
	boolean	○	Enable self-correction

knowledge_base

# optional type: object

Knowledge sources and references

Field	Type	Required	Description
	array<string>	○	Documentation URLs
	object	○	Training data sources
↳	array<string>	○	Data sources
↳	array<string>	○	Training corpora
↳	array<string>	○	Datasets
	array<string>	○	FAQ URLs
	array<string>	○	Best practice guides
	string	○	Knowledge repository URL format: uri

integration

# optional type: object

External integrations

Field	Type	Required	Description
	array<object>	○	External API integrations
↳	string	●
↳	string	●	format: uri
↳	string	●	enum: api_key, oauth, jwt
↳	integer	●	min: 1
	array<object>	○	Webhook endpoints
↳	string	●
↳	string	●	format: uri
↳	string	●	enum: POST, PUT, PATCH
	array<object>	○	Connected services
↳	string	●
↳	string	●	enum: database, storage, queue, cache
↳	string	●
	array<object>	○	MCP server connections
↳	string	●
↳	string	●	format: uri
↳	array<string>	●

performance

# optional type: object

Performance metrics and targets

Field	Type	Required	Description
	number	○	Target efficiency range: 0..1
	number	○	Energy efficiency range: 0..1
	number	○	Target profit margin %
	array<object>	○	Performance metrics
↳	string	●
↳	number	●
↳	number	●	range: 0..1
	array<object>	○	Key Performance Indicators
↳	string	●
↳	string	●
↳	number	●
	array<object>	○	Service Level Agreements
↳	string	●
↳	number	●
↳	number	●
	array<object>	○	Performance benchmarks
↳	string	●
↳	string	●
↳	number	●	range: 0..1

protocols

# optional experimental type: object

Communication protocols

Field	Type	Required	Description
	object	○	Agent-to-Agent protocol
↳	boolean	○	Enable A2A communication
↳	string	○	Discovery method enum: broadcast, registry, direct
↳	string	○	Message format enum: json, yaml, protobuf
↳	boolean	○	Enable encryption
	object	○	x402 payment protocol
↳	boolean	○	Enable x402 payments
↳	walletAddress (string \| null)	○	Payment wallet pattern: ^(0x[a-fA-F0-9]{40}\|(bc1\|[13])[a-zA-HJ-NP-Z0-9]{25,87}\|[1-9A-HJ-NP-Za-km-z]{32,44})$
↳	string	○	Settlement terms enum: instant, net30, net60
↳	boolean	○	Use escrow
	object	○	Human review workflow
↳	boolean	○	Enable human review
↳	array<string>	○	Actions triggering review
↳	integer	○	Approval timeout (seconds) min: 1
↳	array<string>	○	Escalation contacts
	object	○	Delegation protocol
↳	boolean	○	Enable delegation
↳	array<string>	○	Allowed delegation targets
↳	boolean	○	Track delegated tasks
↳	string	○	Notification method enum: slack, email, none

custom_fields

# optional type: object

Custom extension fields

Free-form section — see the JSON Schema for details.

Employee.md Configuration

spec

identity

role

mission

context

scope

permissions

verification

principles

operating_policy

workflows

outputs

economy

delegation

lifecycle

compliance

communication

guardrails

ai_settings

knowledge_base

integration

performance

protocols

custom_fields