Skip to content
View zircote's full-sized avatar

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

 _______ _             _
|__   (_) |           | |
   / / _ _ __ ___ ___ | |_ ___
  / / | | '__/ __/ _ \| __/ _ \
 / /__| | | | (_| (_) | ||  __/
/_____|_|_|  \___\___/ \__\___|

Building practical open source tools that improve developer workflows

About

Robert Allen is a DevOps engineer, technologist and open source maintainer 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 (5K+ stars), 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 Source Tooling - Creating and maintaining tools that developers actually use
  • AI-Assisted Development - Building Claude Code plugins, agents, and workflows
  • DevOps & Platform Engineering - Infrastructure automation, CI/CD, AWS architecture
  • Architecture Documentation - ADRs, decision tracking, knowledge capture

Featured Projects

Project Description Tech
swagger-php OpenAPI/Swagger documentation from PHP annotations PHP
git-adr Architecture Decision Records in git notes Python
git-notes-memory Semantic memory storage for Claude Code Python
claude-spec Project specification & lifecycle management plugin Python
.claude Claude Code dotfiles: agents, skills, commands Python

Claude Code Ecosystem

I maintain a comprehensive ecosystem of Claude Code extensions for AI-assisted development:

Plugins

  • claude-spec - Socratic project planning with implementation tracking
  • git-notes-memory - Git-native semantic memory with vector search

Agent Library

The .claude repository contains 100+ specialized agents organized by domain:

Category Agents
Core Development frontend, backend, fullstack, API design, microservices
Language Specialists Python, TypeScript, Go, Rust, Java, PHP
Infrastructure DevOps, SRE, Kubernetes, Terraform, cloud architecture
Quality & Security code review, security audit, testing, performance
Data & AI ML engineering, data science, LLM architecture

GitHub Ecosystem

This account uses standardized templates and automation for consistency across repositories.

Project Templates

Template Stack
python Python 3.12+, uv, ruff, pyright
typescript Node 22, pnpm, ESLint 9, Vitest
go Go 1.23+, golangci-lint
rust Stable, clippy, cargo-deny
docs-site Astro, Starlight, MDX

Reusable Workflows

# Use in any repository
jobs:
  ci:
    uses: zircote/.github/.github/workflows/reusable-ci-python.yml@main

Technology Stack

Languages        PHP | Python | TypeScript | Go
Infrastructure   AWS | Docker | Kubernetes | Terraform | GitHub Actions
AI Integration   Claude Code | GitHub Copilot | MCP Protocol
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

Blog LinkedIn GitHub

  • GitHub Issues - For project-specific discussions
  • Pull Requests - The best way to propose changes

Building in the open | [View Ecosystem](https://github.com/zircote/github)

Pinned Loading

  1. swagger-php swagger-php Public

    A php swagger annotation and parsing library

    PHP 5.3k 948

  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.

    Python 1

  3. epicpast/nsip-api-client epicpast/nsip-api-client Public

    Python client for the NSIP (National Sheep Improvement Program) Search API - reverse-engineered from nsipsearch.nsip.org

    Python 1

  4. marketplace marketplace Public

    Forked from epicpast/marketplace

    A marketplace of Claude Code plugins for enhanced development workflows

    Python

  5. git-notes-memory git-notes-memory Public

    Git-native, semantically-searchable memory storage for Claude Code. Captures decisions, learnings, and context as git notes with vector search.

    Python 1

  6. claude-spec claude-spec Public

    Claude Code plugin for project specification and implementation lifecycle management. Socratic planning, progress tracking, and retrospectives.

    Python 1 1