Back to Go Micro

Go Micro — Thesis & North Star

internal/docs/THESIS.md

6.3.05.0 KB
Original Source

Go Micro — Thesis & North Star

This is the North Star for the project and for the autonomous improvement loop (see CONTINUOUS_IMPROVEMENT.md). Every change should move toward it; work that doesn't isn't an improvement, however clean.

Thesis

Go Micro is an agent harness and service framework — one runtime that, holistically, encapsulates the lifecycle of services, agents, and workflows. Not three products stitched together: one set of primitives, because an agent is a distributed system and building one is building a service.

The progression: services → agents → workflows

Value is unlocked in order, and each layer needs the one beneath it:

  1. Services — typed, discoverable, callable capabilities. The substrate; every endpoint is automatically an AI-callable tool.
  2. Agents — a model with memory and tools that uses those services, plans, delegates, and is bounded by guardrails. Intelligence on top of capability.
  3. Workflows — the part that pieces it all together: composing agents and services over time, deterministically where the path is known and dynamically where it isn't, on schedules and in loops. The workloads come after the agents, because the value is in stitching it into systems that do real work.

A harness that stops at "a model in a loop" is incomplete. The point is the whole lifecycle — capability, intelligence, and orchestration as one runtime.

Where we fit — complementary, not competing

"Agent = Model + Harness" (LangChain) is the right frame, but harness has two layers, and we own the second:

  • The intra-agent harness — the runtime around a single model: system prompt, tools, context compaction, sandbox, self-verification, and the continuation ("Ralph") loop. LangChain / LangGraph, deepagents, and Claude Code do this well. We do not compete here.
  • The operational harness — the distributed substrate agents operate inside: services as typed tools, discovery and RPC, durable and resumable runs, observability, scheduling, and the protocols agents use to reach each other. The place a single agent becomes part of a system, and many agents, services, and workflows compose. This is Go Micro's focus.

They stack. An intra-agent harness produces an agent; Go Micro is where that agent runs as a first-class service and gets composed into workflows with other services and agents. They plug together through open protocols — a LangGraph or deepagents agent is reachable over A2A and consumes Go Micro tools over MCP, and the reverse. We make those agents better neighbours, not obsolete.

So the focus is deliberately narrow: the operational harness for Go, and the services → agents → workflows lifecycle — not a model-orchestration framework, not a graph DSL, not a prompt layer. Lead with interop and the distributed substrate; treat LangChain-class tools as complements to build alongside, never as targets to replace.

Why now

The frontier is moving from chat to scheduled, looping, work-performing agents: Anthropic itself is building toward agents that do work on a cadence (Claude for Work, schedulers), and running coding agents continuously in loops is becoming standard practice among the people who build them. That shift is exactly the "workflows after agents" layer — and the harness is what makes it safe, durable, observable, and composable instead of a fragile script.

The bet: whoever gives Go a holistic harness for the whole lifecycle — not just an agent SDK, not just a service framework — owns where agentic software gets built.

What every improvement should serve

Judge each loop increment against the North Star:

  1. Make the harness real — operate the loop in production: durability, observability, resilience, streaming, human-in-the-loop.
  2. Tighten the lifecycle — services ↔ agents ↔ workflows as one runtime, not three silos.
  3. Advance orchestration — durable, resumable, scheduled, looping workflows that compose agents and services over time.
  4. Sharpen DX — the 0→1 and 0→hero paths stay effortless.
  5. Strengthen interop — MCP (tools), A2A (agents), x402 (paid tools).
  6. Harden trust — cross-provider conformance, failure semantics, tests.

Prefer changes that advance these; avoid scope that doesn't. Brand/positioning copy and breaking public-API changes stay with the human.

The loop is the proof

Go Micro is built by an autonomous agentic loop — Claude Code and Codex continuously improving the repo against this North Star. That isn't a gimmick; it's the thesis applied to itself: an agent harness, built by agents running in a loop. If the harness is good enough to build itself, it's good enough to build your agentic software.

What this is not

The framework is the product — no hosted platform, no enterprise tier, no VC, no graph DSL. Sustained by sponsorship from those who run it. See ROADMAP.md.