Skip to content
View zircote's full-sized avatar

Highlights

  • Pro

Organizations

@hmhco

Block or report zircote

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
.github/profile/README.md

zircote

GitHub Followers Public Repos swagger-php Stars

LinkedIn Blog


About

Robert Allen is a Systems/Platform engineer, technologist, open source maintainer and sheep and poultry farmer based in Farmville, Virginia. By day, he drives infrastructure automation at HMH. By evening, he builds developer tools that solve real problems in technology and agriculture. And somehow also runs a regenerative pasture farm.

Creator of swagger-php, the PHP library for generating OpenAPI documentation from annotations. Much appreciation to the community of contributors and users who have made it a success over the years.

Focus Areas

  • Open Standards for AI Tooling - Authoring specifications that make AI development portable and interoperable
  • AI-Assisted Development - Building Claude Code plugins, agents, and workflows
  • DevOps & Platform Engineering - Infrastructure automation, CI/CD, AWS architecture
  • Open Source Tooling - Creating and maintaining tools that developers actually use

Open Specifications

Two open specifications currently occupy the center of my development attention — both aimed at solving fragmentation in the AI coding assistant ecosystem.

Memory Interchange Format (MIF) — Portable AI Memory

mif-spec.dev

The AI memory ecosystem is fragmented — Mem0, Zep, Letta, LangMem, and others all use proprietary schemas with no interoperability. MIF defines a common data model with dual representations: human-readable Markdown files (Obsidian-compatible) and machine-processable JSON-LD documents.

MIF solves vendor lock-in, data ownership, and future-proofing for AI memory. Key features:

  • Dual format — Lossless conversion between .memory.md and .memory.json
  • Three conformance levels — Core (4 fields), Standard (+ namespaces, entities, relationships), Full (+ bi-temporal, decay, provenance, embeddings, citations)
  • Ontology system — Semantic/episodic/procedural memory types with domain-extensible entity discovery
  • W3C PROV provenance and JSON Schema validation
  • Migration guides from Mem0, Zep, Letta, Subcog, and Basic Memory

Status: v0.1.0-draft • SpecificationGitHub

ccpkg — Portable Packaging for AI Coding Extensions

ccpkg.dev

AI coding assistants are increasingly extensible, but sharing extensions is fragmented and fragile — Git-based installs break silently, startup latency scales with plugin count, and there are no trust signals or version pinning. ccpkg defines a self-contained archive format (.ccpkg) for packaging and distributing skills, agents, commands, hooks, MCP servers, and LSP servers as a single portable unit.

One file, one install, zero post-install steps. Key features:

  • Cross-tool portability — Works across Claude Code, Gemini CLI, Codex, Copilot, and other compatible tools
  • Self-contained archives — All dependencies vendored, no runtime network fetches
  • Lazy loading — Only metadata loaded at startup; twenty packages have the same startup time as zero
  • Deterministic lockfilesccpkg-lock.json pins exact versions with checksums for reproducible team environments
  • Decentralized registries — JSON files hostable on GitHub Pages, S3, or any static server
  • Built on open standards — Agent Skills, MCP, LSP, SemVer, JSON Schema

Status: Draft (2026-02-14) • SpecificationGitHub


Memory, Ontology & AI

The intersection of cognitive science and AI systems presents a compelling question: how do we build AI that remembers meaningfully?

Human memory isn't a tape recorder—it's a constructive process where our mental models (ontology) shape what we encode, and our memories reshape how we understand the world. This recursive loop is central to how we learn, adapt, and make sense of novel situations.

The Recursive Loop: How Memory and Ontology Shape Our Reality

The goal: AI assistants that don't just respond—they accumulate knowledge, recognize patterns, and evolve their understanding of your codebase and preferences. MIF grew directly from this research — encoding these cognitive principles into an interoperable specification.


Featured Projects

mnemonic — Persistent Memory for Claude Code

A pure filesystem-based memory system that gives Claude Code long-term memory across sessions. Memories are stored as markdown files with YAML frontmatter in a git-versioned directory, organized by cognitive type:

  • Semantic memory — decisions, knowledge, entities
  • Episodic memory — incidents, sessions, debugging journeys
  • Procedural memory — runbooks, patterns, workflows

MIF Level 3 compliant with ontology-driven entity discovery, bi-temporal tracking, memory decay, and relationship graphs. Research-validated on the Letta LoCoMo benchmark (74.0% accuracy vs 68.5% for graph-based approaches) — proving that LLMs work best with the filesystem operations they were pre-trained on.

Ships as a Claude Code plugin with 13 commands, 4 autonomous agents, and event-driven hooks that enable proactive recall and silent capture.

claude-team-orchestration — Multi-Agent Orchestration & RLM

A production-grade framework for coordinating teams of Claude Code agents. Built on Claude Code's agent teams API, it provides team management, shared task lists, inter-agent messaging, and seven proven orchestration patterns — from parallel specialists to self-organizing swarms.

The standout capability is its content-aware RLM (Recursive Language Model) implementation based on arXiv:2512.24601, which processes files and directories that exceed context limits:

  • Automatic content-type detection — source code, CSV/TSV, JSON/JSONL, logs, prose
  • Semantic chunking — respects function boundaries, preserves CSV headers, maintains valid JSON per partition
  • Specialized analyst agents — code-aware, data-aware, JSON-aware, and general-purpose analyzers run on Haiku for cost efficiency
  • Multi-file directory analysis — routes mixed content types to the right analysts, synthesizes findings across file types in two phases
  • Context protection — findings written to task descriptions (pass-by-reference), keeping the leader's context under 2K characters even with 30 active analysts

Ships as a Claude Code plugin with 8 modular skills and 5 custom agent definitions.

nsip — Sheep Genetic Evaluation CLI & MCP Server

A Rust CLI and Model Context Protocol server for the National Sheep Improvement Program database — 400,000+ animals with Estimated Breeding Values (EBVs), pedigrees, and performance data.

Beyond basic search and lookup, nsip provides breeding intelligence:

  • Inbreeding analysis — Wright's coefficient of inbreeding with traffic-light risk classification
  • Weighted trait ranking — custom breeding objective scoring with accuracy weighting
  • Mating recommendations — optimal sire pairings ranked by trait complementarity and inbreeding risk
  • Flock summary — aggregate genetics across a flock

The MCP server exposes 13 tools, 5 resources, 4 resource templates, and 7 guided prompts — enabling AI assistants to provide expert breeding advice through natural conversation. Published as a Docker image at ghcr.io/zircote/nsip.

nsip-example — GitHub as a Farm Management System

A working demonstration of GitHub4Farms — using GitHub Issues as the record-keeping interface for a sheep operation, with automated genetic enrichment powered by the nsip MCP server and GitHub Copilot.

Farmers create issues for breeding events (mating, lambing, health, weaning, sales) using structured templates. A Copilot agent automatically enriches each record with genetic data: inbreeding risk assessment, EBV comparisons, predicted offspring traits, and breeding recommendations. Flock-wide analyses — ranking, mating optimization, inbreeding matrices — are generated as markdown reports via issue-triggered workflows.

Seven issue templates, eleven runbooks, and comprehensive user documentation make it accessible to farmers with no technical background.


Active Projects

Last updated: 2026-02-15

Most Active Repositories

Ranked by recent contributions, community engagement, and development activity.

Repository Description Tech Activity
swagger-php A php swagger annotation and parsing library PHP ✨ Active
nsip-example GitHub-powered farm management with NSIP sheep breeding inte... Unknown 📈 Growing
mnemonic Persistent filesystem-based memory system for Claude Code. P... Python 📈 Growing
subcog Persistent memory system for AI coding assistants. Captures ... Rust 📈 Growing
claude-team-orchestration Multi-agent orchestration plugin for Claude Code. Coordinate... Unknown 📈 Growing
homebrew-tap Homebrew tap for various projects Ruby 📈 Growing
git-adr 🏛️ Architecture Decision Records in git notes - no files, no... Rust 📈 Growing
nsip Sheep genetic evaluation CLI & MCP server -- search animals,... Rust 📈 Growing

Recently Created

  • ccpkg (MDX) - No description
  • version-guard (Unknown) - Claude Code plugin that verifies library versions against live documentation bef...
  • claude-team-orchestration (Unknown) - Multi-agent orchestration plugin for Claude Code. Coordinate agent teams with sh...
  • nsip-example (Unknown) - GitHub-powered farm management with NSIP sheep breeding intelligence. Issue-base...
  • nsip (Rust) - Sheep genetic evaluation CLI & MCP server -- search animals, compare EBVs, plan ...

Technology Stack

Languages        Rust | Python | TypeScript | Go
Infrastructure   AWS | Docker | Kubernetes | Terraform | GitHub Actions
AI Integration   Claude Code | GitHub Copilot | MCP Protocol
Specifications   MIF (mif-spec.dev) | ccpkg (ccpkg.dev)
Platforms        Linux | macOS | AWS (Solutions Architect certified)

Principles

  1. Developer Experience First - Tools should reduce friction, not add it
  2. Automation Over Documentation - Encode knowledge in code
  3. Open by Default - Share solutions that might help others
  4. Practical Over Perfect - Ship working software, iterate based on usage

Connect

  • GitHub Issues - For project-specific discussions
  • Pull Requests - The best way to propose changes
  • LinkedIn - Professional networking and collaboration

Pinned Loading

  1. swagger-php swagger-php Public

    A php swagger annotation and parsing library

    PHP 5.3k 945

  2. git-adr git-adr Public

    🏛️ Architecture Decision Records in git notes - no files, no merge conflicts, linked to commits. AI-powered drafting, wiki sync, 6 templates.

    Rust 2

  3. structured-madr structured-madr Public

    Machine-readable Architectural Decision Records with YAML frontmatter, risk assessment, and audit trails. Includes GitHub Action validator and JSON Schema for CI/CD.

    JavaScript 1

  4. rlm-rs rlm-rs Public

    Rust CLI implementing the Recursive Language Model (RLM) pattern for Claude Code. Process documents 100x larger than context windows through intelligent chunking, SQLite persistence, and recursive …

    Rust 5

  5. mnemonic mnemonic Public

    Persistent filesystem-based memory system for Claude Code. Pure MIF Level 3 compliant memory storage with YAML frontmatter, bi-temporal tracking, and proactive hooks. No dependencies - just markdow…

    Python 4 2

  6. claude-team-orchestration claude-team-orchestration Public

    Multi-agent orchestration plugin for Claude Code. Coordinate agent teams with shared tasks, messaging, and 7 patterns including RLM (arXiv:2512.24601) for large-file analysis beyond context limits.

    1 1