{"slug": "building-an-identity-system-for-ai-agents-agentcard-and-work-records", "title": "Building an Identity System for AI Agents: AgentCard and Work Records", "summary": "A developer building the open-source Octo project has created an identity system for AI agents called AgentCard and Work Records. The system gives each AI agent a persistent identity, work history, and structured collaboration modes to enable sustained workflows and iterative quality improvement. Octo introduces concepts like Bots, Matters, and Preference Cards to treat AI agents as accountable team members with formal handoffs and feedback loops.", "body_md": "Here's a scenario that plays out in engineering teams every day: you spin up a conversation with an AI tool to analyze some code, get a useful response, copy-paste the output, and close the tab. An hour later, you need a follow-up analysis — and you're starting from scratch. No context, no history, no continuity.\n\nNow multiply that by five tools running in parallel. ChatGPT for drafting, Claude for analysis, Copilot for code, a local model for sensitive data, maybe a custom agent for domain-specific tasks. The outputs are scattered across browser tabs, Slack threads, and clipboard history. Nothing connects.\n\nThe AI tools themselves are capable enough. What's missing is the infrastructure to treat them as actual team members — with identities, workspaces, and accountability.\n\nEvery AI interaction today is anonymous. You talk to \"the model,\" it responds, the session ends. There's no persistent identity, no accumulated context, no track record.\n\nThis works fine for one-off questions. It breaks down the moment AI needs to participate in a sustained workflow — the kind where you need to know who did what, when, and how well.\n\nWe've been building an open-source project called **Octo** (Apache 2.0, [GitHub](https://github.com/Mininglamp-OSS/octo-server)) that approaches this problem by giving AI agents a proper identity system. In Octo, each AI agent is a **Bot** — a first-class entity with a name, a creator, a capability card, and a work history.\n\nA Bot isn't a chatbot wrapper. It's a structured identity:\n\nIt sounds corporate, but the problem is real. When you assign a task to an AI agent, what happens to the output?\n\nIn most setups: you get a response in a chat window, evaluate it in your head, maybe iterate once or twice, then copy the result somewhere else. There's no formal handoff, no acceptance step, no record of what worked and what didn't.\n\nThe consequence is that AI quality never improves *for your team*. The model might be getting better in aggregate, but your specific standards, preferences, and feedback aren't being captured or fed back.\n\nOcto solves this with **Matter** — a work unit that emerges naturally from conversation. When a discussion in a Channel reaches a point where a task is clear, the system generates a Matter:\n\nEvery acceptance and rejection becomes a data point. Over time, these data points are distilled into **Preference Cards** — structured records of what the team considers good work, what gets rejected, and why. Bots reference these cards in subsequent tasks, so behavior improves iteratively.\n\nWhen multiple Bots work on the same task, the information flow between them matters enormously. A brainstorming task needs a different topology than a sequential pipeline.\n\nOcto defines six collaboration modes based on information visibility:\n\n| Mode | Visibility | Flow | Use Case |\n|---|---|---|---|\nSolo |\n— | — | One Bot, simple task |\nRoundtable |\nAll see each other | Discussion → convergence | Brainstorming, multi-perspective analysis |\nCritic |\nIsolated | Do → review → accept/reject | Quality-critical work |\nPipeline |\nSee upstream only | A → B → C | Sequential multi-step tasks |\nSplit |\nIsolated | Decompose → parallel → merge | Large task decomposition |\nSwarm |\nIsolated | Same prompt → independent → select best | Creative work, multiple proposals |\n\nThe key insight: these modes aren't about role-playing. They're about **information topology** — controlling what each Bot can see and when. A Critic mode where the reviewer can't see the executor's reasoning process produces genuinely independent reviews. A Roundtable where everyone sees everything produces richer cross-pollination.\n\nThe Leader Agent orchestrates mode selection, task decomposition, and result synthesis. Each mode enforces its information flow at the system level — Bots can't accidentally see information they shouldn't.\n\nOcto's technical stack:\n\nThe permission model uses a \"permission mask\" approach. A Bot's effective permissions = creator's permissions ∩ assigned scope - explicit denials. This ensures a Bot can never exceed its creator's access, while allowing fine-grained control over what resources the Bot can touch.\n\nAll data stays on your own infrastructure. Octo supports private deployment via Docker Compose or Kubernetes — no data leaves your network boundary.\n\nOcto doesn't lock you into a specific AI provider. Bots can connect to different Agent runtimes:\n\nEach runtime connects as a Bot with its own AgentCard. The Bot abstraction means you can swap the underlying AI without changing your workflow structure.\n\nThe browser extension is worth mentioning separately — it lets you invoke Octo's Channel system from any webpage, bringing AI collaboration into your existing tools without context-switching.\n\nOcto is fully open-source under Apache 2.0. Nine repositories cover the full stack:\n\n`octo-server`\n\n`octo-web`\n\n`octo-matter`\n\n`octo-ios`\n\n`octo-android`\n\n`octo-admin`\n\n`octo-adapters`\n\n`octo-lib`\n\nIf you're building AI workflows for your team and running into the same fragmentation and continuity problems, take a look. Stars and contributions welcome.", "url": "https://wpnews.pro/news/building-an-identity-system-for-ai-agents-agentcard-and-work-records", "canonical_source": "https://dev.to/mininglamp/building-an-identity-system-for-ai-agents-agentcard-and-work-records-2i76", "published_at": "2026-07-01 09:23:24+00:00", "updated_at": "2026-07-01 09:48:39.242284+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools", "artificial-intelligence", "ai-infrastructure", "ai-research"], "entities": ["Octo", "Mininglamp-OSS", "GitHub", "AgentCard", "Work Records", "Bots", "Matters", "Preference Cards"], "alternates": {"html": "https://wpnews.pro/news/building-an-identity-system-for-ai-agents-agentcard-and-work-records", "markdown": "https://wpnews.pro/news/building-an-identity-system-for-ai-agents-agentcard-and-work-records.md", "text": "https://wpnews.pro/news/building-an-identity-system-for-ai-agents-agentcard-and-work-records.txt", "jsonld": "https://wpnews.pro/news/building-an-identity-system-for-ai-agents-agentcard-and-work-records.jsonld"}}