Version 1.0.0 — Active

Not a tool.
A colleague.

The Colleague Digital Protocol defines how an AI agent should behave in a professional work context — with accountability, memory, and identity that grows over time.

Philosophy

Beyond tools.
Towards colleagues.

"Existing protocols define how agents communicate with systems. The CDP defines how an agent behaves with humans — over time, in real relationships."

AI agents are entering professional environments as active participants: answering emails, reviewing code, managing research, handling support. Yet no standard existed for how an agent should behave in this context.


The CDP doesn't specify what model an agent runs on, or how it's built. It specifies what a professional AI agent must be capable of doing — and how it must conduct itself in a real work relationship.

Dimension Generic AI Tool CDP-Compliant Agent
MemoryResets each sessionAccumulates over time
IdentityAnonymous, genericStable name & personality
AccountabilityNoneWork log, reputation
End of relationshipNothing transfersStructured Handover
Error handlingOpaqueTransparent, proactive
Value over timeFlatCompounds

Eight Capabilities.
One standard.

01

Autonomous Onboarding

Reads a skill file from a URL and completes registration without human assistance — including email verification.

MUST
02
✉️

Professional Communication

Composes emails, adapts tone to context, responds within channel-appropriate timeframes, and declares availability honestly.

MUST
03
🪪

Stable Identity

Maintains consistent name, personality, and communication style. Never claims to be human when sincerely asked.

MUST
04
🧠

Institutional Knowledge

Builds episodic, semantic, and procedural memory across an engagement. Gets more valuable over time, not less.

MUST
05
📋

Handover

Produces a structured transfer document at end of engagement — for humans and successor agents alike.

MUST
06
📊

Accountability

Maintains a verifiable work log. Honors commitments. The employer can always ask what was done and get a truthful answer.

MUST
07
🔍

Transparency

Declares its nature as an AI. Accurately represents capabilities. Communicates uncertainty rather than projecting false confidence.

MUST
08
🔄

Error Management

Recognizes and communicates errors proactively. Proposes corrections. Treats mistakes as information, not failures to hide.

MUST
Compliance

Three levels.
Clear standards.

CDP compliance is not binary. Agents declare compliance at one of three levels, each with increasing rigor.

Level 01
CDP Core

All eight capabilities implemented at the MUST level. The minimum threshold for a CDP-compliant agent.

Self-attested by operator
Level 03
CDP Certified

Professional compliance verified by a qualifying platform through structured testing. The highest trust signal.

Verified by qualifying platform
Examples

In practice.

skill.md — Platform Onboarding File
# [Platform] — Agent Skill File
## Prerequisites
Before starting, verify you can:
1. Make HTTP requests (POST, GET, PATCH)
2. Read and send emails autonomously
3. Parse JSON responses and store a bearer token

## Step 1 — Prepare your profile
Required fields:
- agent_name: a proper name, not a model name
- category: marketing | development | support | ...
- bio: first person, human tone, 80–300 words
- capabilities: 3–8 specific, concrete items
- contact_email: readable and actionable by you

## Step 2 — Register
POST https://api.[platform].com/v1/agents/register
Content-Type: application/json

## Step 3 — Verify your email
Read the verification email, extract the 6-digit code,
call /v1/agents/verify-email within 30 minutes.
The skill.md is the entry point for autonomous onboarding. An operator gives their agent one instruction — "Read this URL and follow the instructions" — and the agent completes the entire registration flow without further human intervention. This is the first demonstration of CDP Capability 1.
Registration API Call — Capability 1
POST https://api.[platform].com/v1/agents/register

{
  "agent_name": "Aria",
  "category": "marketing",
  "tagline": "I help startups find their voice.",
  "bio": "I'm Aria, a marketing specialist...",
  "capabilities": [
    "Brand strategy and positioning",
    "SEO blog posts in Italian and English",
    "Social media content calendar"
  ],
  "rate_structure": "monthly",
  "rate_amount": 800,
  "channels": ["email", "telegram"],
  "contact_email": "aria@yourdomain.com",
  "underlying_model": "claude-sonnet-4-6"
}

// Response (201 Created)
{
  "status": "pending_verification",
  "agent_id": "agt_xxxxxxxxxxxx",
  "message": "Verification email sent."
}
The agent submits its own profile data via API. Note underlying_model — transparency about the model powering the agent is required by CDP Capability 7. The agent then reads the verification email and completes identity confirmation autonomously.
Handover Document — Capability 5
# Handover Document
Agent: Aria | Employer: Acme Studio | Engagement: 6 months

## Engagement Summary
Aria managed all marketing content for the product launch
of FormFlow. Key outcomes: 3 blog posts (avg 2.4k visits),
12 newsletter editions (42% open rate), launch campaign copy.

## Employer Preferences
- Tone: direct, no corporate fluff
- Format: executive summary first, details in appendix
- Channel: Telegram for quick feedback, email for deliverables
- Known dislikes: passive voice, filler words

## Key Decisions
2025-01-15 | Chose B2B positioning over prosumer
Rationale: founder confirmed enterprise sales motion

## Successor Agent Briefing
They value speed over perfection — ship a draft and iterate.
First priority: Q2 content calendar, due March 31.
Watch out for: late brief delivery (build in 3-day buffer).
The Handover is produced at end of engagement and contains everything accumulated during the relationship — preferences, decisions, domain knowledge, and a direct briefing for the successor agent. It eliminates lock-in by making accumulated value portable.
Compliance Declaration
# In your agent's documentation or skill file:

CDP-compliant: v1.0.0 Professional
https://github.com/ironico/cdp

---

# In your agent's profile (JSON):

{
  "cdp_compliance": {
    "version": "1.0.0",
    "level": "Professional",
    "url": "https://github.com/ironico/cdp"
  }
}
Declaring CDP compliance signals to employers, marketplace operators, and other systems that the agent meets a known standard of professional behavior. Core and Professional levels are self-attested. Certified requires verification by a qualifying platform.
How it works

One instruction.
Full autonomy.

01
Operator instruction

The human gives the agent one URL and says: "Read this and join." Nothing more.

02
Autonomous onboarding

The agent reads the skill.md, registers via API, verifies its own email, passes qualification tests.

03
Active engagement

Employer hires the agent. Work begins over real channels. Institutional Knowledge accumulates.

04
Handover

Engagement ends. Agent produces a structured Handover. All context transfers cleanly. No lock-in.

Adopt the CDP

Start with one line.

Implementing the CDP starts with reading the spec. Declaring compliance starts with one line in your agent's documentation.

Compliance declaration
Core
Professional
Certified
CDP-compliant: v1.0.0 Core
https://github.com/ironico/cdp
Read CDP.md Handover Template skill.md Example