Skip to content
View AreteDriver's full-sized avatar
🎯
Focusing
🎯
Focusing

Highlights

  • Pro

Block or report AreteDriver

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 is supported. This note will only be visible to you.
Report abuse

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

Report abuse
AreteDriver/README.md

The Human Stack

Engineering methodology for deploying AI systems with operational discipline.

A system that ships predictably beats one that demos brilliantly.

The Human Stack Animus Tests

I write The Human Stack — a living engineering reference for deploying, operating, and evaluating AI systems in production. Everything in this profile is evidence supporting that methodology: eval frameworks that catch regressions before they ship, cost observability that surfaces spend anomalies in real time, and MCP tooling that standardizes how AI agents connect to the world.

Before software I spent 17 years running manufacturing and logistics systems (IBM, Toyota Production System) — standard work, visual management, error-proofing. That discipline shows up in every codebase: ADL-governed decisions, adversarial test gates, evidence-graded maturity.

Building toward a world where every engineering team ships AI systems with the same operational discipline they apply to production infrastructure.

Substack · LinkedIn · jamesyng79@gmail.com


Notable Projects

These are the repos I maintain to production quality — evidence, tests, and documentation first.

Project Stars Language What It Is
animus ⭐1 Python Personal AI operating environment — bitemporal memory, evidence-graded maturity, autonomous improvement
mcp-manager ⭐1 Python MCP server lifecycle manager across Claude Code, Cursor, Windsurf — now with permission-prompt audit
ai-spend ⭐0 Python Cross-provider AI cost aggregation with provider retry, config encryption, and health checks
agent-lint ⭐2 Python Workflow YAML cost estimator + anti-pattern detection for agent orchestration
the-human-stack ⭐0 Markdown Living engineering reference — evidence-graded chapters, benchmark methodology, failure taxonomy
ai-skills ⭐3 Python Production-ready skills for Claude Code personas and orchestrated workflows

Hobby projects (EVE Online lore, personal context servers) are kept private. What you see here is what I ship.


Start Here: The Arete Stack

The fastest way to understand the methodology is to use it. These repos are arranged as an onion — start at the outer layer and peel inward.

Layer Repo What It Is Entry Point
Skills ai-skills Production-ready skills for Claude Code, agent orchestration, and workflows ./tools/install.sh --bundle arete-studio-ops
Cost ai-spend htop for AI spend — cross-provider cost aggregation pip install ai-spend
Governance agent-lint Workflow YAML cost estimator + anti-pattern linter pip install agentlinter
Orchestration animus Personal AI operating environment with local-first control, evidence-graded maturity, session persistence, autonomous improvement git clone + docker compose up
Methodology the-human-stack The engineering reference itself — evidence-graded chapters, benchmark methodology, failure taxonomy Read VISION.md

The Proof: Animus

Animus is the primary reference implementation — a personal AI operating environment with local-first control and evidence-graded maturity tracking.

Subsystem What It Does Tests
Kernel Bitemporal memory core, checkpoint/resume, session persistence 179 green
Head Quality gates, fallback routing, natural-language interface 72 green
Citizens Architect (autonomous improvement proposals), Conversation Designer, Knowledge Curator 35 green
Forge Eval pipeline, benchmark execution, rubric-based scoring Integrated
Session Controller Token-budgeted session lifecycle, graceful wrap, auto-restart 22 green

Key design decisions (visible in the code):

  • Evidence Framework — Six-stage maturity model (Concept → Self-improving) with Coverage KPI. Makes "documented but unverified" into "inspectable evidence."
  • ADL-governed architecture — Every major decision is append-only, dated, and cross-referenced. No tribal knowledge.
  • Quality gates before merge — Deterministic scoring (tool/completeness/structure) with adversarial test harness. Features don't ship without gate passage.

Active Developer Tools

Tool What It Does Install
ai-spend htop for AI spend — cross-provider cost aggregation with OpenRouter, Anthropic, OpenAI pip install ai-spend
mcp-manager MCP server manager across agentic IDEs (Claude Code, Cursor, Windsurf) pip install arete-mcp
agent-lint Workflow YAML cost estimator + anti-pattern linter pip install agentlinter
context-hygiene Heuristic context-window analyzer — position-decay scoring + regex patterns pip install context-hygiene

How I Work

  • Decision logs, not memory. Every architectural choice is an ADL entry — rationale, rejected options, tradeoffs, kill criteria.
  • Tests are deliverables. Not an afterthought. Adversarial tests prevent regression of quality-gate contracts.
  • Local-first where possible. RX 7900 XTX inference stack (Ollama, 4-model tiered) for zero-cost eval calibration.
  • Ship, measure, error-proof, repeat. Kaizen learned from scaling an ice-cream line 6× — applied to software.

Selected Work

Direct entry points for "what does the code actually look like":

  • Animus Kernel — bitemporal memory + adversarial tests — v2.3 scaffold: valid-time / transaction-time axes, quality-gate contracts enforced before any feature ships. Architect Citizen produces ImprovementProposals from codebase observation.
  • ai-spend — OpenRouter providerGET /api/v1/generations pagination with native_cost fallback to token-based estimates. Pattern: provider registry ABC with side-effect registration.
  • Animus Session Controller — Token-budgeted session lifecycle (96% utilization trigger), graceful finalization with model-generated summary, checkpoint + auto-restart. 22 tests, 83 existing head core tests green.
  • Animus P5 Discovery — MCP scanner, OpenAPI ingestion, annotated script discovery, 4-dimension schema validator, hash deduplication. 41 tests, 194 total P0–P5 tests green.

Background

17 years in manufacturing and logistics operations (IBM, Toyota Production System). Scaled an ice-cream production line from 740 pints/day to 4,800/hour using Kaizen. Now apply the same discipline to AI infrastructure: standard work, visual management, error-proofing, continuous improvement.

See it through. Do it better. Leave something real.

Pinned Loading

  1. ai-skills ai-skills Public

    Production-ready skills for Claude Code and multi-agent systems

    Python 3 1

  2. animus animus Public

    Personal AI operating environment with evidence-graded maturity, local-first control, and autonomous improvement.

    Python 1

  3. arete-evals arete-evals Public

    LLM eval suites and the run records they produced — the eval practice behind animus-forge

    Python 1

  4. the-human-stack the-human-stack Public

    A living engineering reference for deploying, operating, and evaluating AI systems.

  5. mcp-manager mcp-manager Public

    Manage MCP servers across agentic IDEs

    Python 1

  6. agent-lint agent-lint Public

    CLI tool for cost estimation and anti-pattern detection in agent workflow YAML configs

    Python 2