Skip to content
View pedronauck's full-sized avatar

Sponsoring

@raphamorim

Highlights

  • Pro

Organizations

@doczjs @compozy

Block or report pedronauck

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
pedronauck/README.md

hi, I'm Pedro Nauck 👋

🤖 Building harness for AI.

I'm a software engineer based in San Francisco, founder of Compozy — where we're building the orchestration layer that takes AI coding agents from idea to shipped code in a single pipeline.

Before AI ate everything, I spent a decade shipping open-source developer tools — Docz (23.6k+ ⭐), react-adopt (1.6k+ ⭐), reworm (1.4k+ ⭐), and a long tail of React, JS, and tooling libraries. I've also shipped Rust systems work — notably contributing to FuelLabs/data-systems, the official data-streaming libraries for the Fuel Network. Today, most of my work lives at the intersection of agents, local-first runtimes, and developer experience.


Tech I ship with

Go TypeScript Rust Node.js Bun Claude Codex CLI MCP


🧭 Start here

If you only have a minute, these are the projects I'd point you to first:

  • 🎼 compozy — Orchestrate AI coding agents from idea to shipped code, in one pipeline. (2.2k+ ⭐)
  • 🏢 agh — An open workplace for AI agents — local-first runtime with durable sessions and agent-to-agent networking.
  • 📚 kb — Build topic-based knowledge bases from code, URLs, files and YouTube. Obsidian-compatible vaults, zero cloud deps.
  • 📓 skeeper — Version PRDs, tech specs, ADRs and AI plans in a sidecar Git repo — without polluting your main PRs.
  • 🔁 codex-loop — Keep Codex tasks running until they actually finish — by time, rounds, or independently confirmed goal.
  • 🧩 skills — My curated collection of 126 agent skills for Claude Code and compatible assistants. (375+ ⭐)

🎼 The Compozy ecosystem — the agent harness

The core thesis: AI agents are powerful but unreliable on their own. They need a harness — orchestration, durable state, peer discovery, knowledge, and quality gates — to turn one-shot generations into shippable software. This is what we're building at @compozy.

Orchestration & runtime

Project What it does
🎼 compozy CLI that drives the full lifecycle of AI-assisted dev — PRDs → specs → tasks → concurrent execution → code review remediation. (Go, 2.2k+ ⭐)
🏢 agh An open workplace for AI agents. Runs Claude Code, Codex, OpenClaw and friends as durable, inspectable sessions with peer-to-peer capability sharing over the open agh-network/v0 protocol. (Go)
🧠 go-orchestrator Next-level agentic orchestration framework. (Go)
🌉 arky LLM providers bridge and SDK in Rust. (Rust)

Quality loops & QA

Project What it does
🔁 codex-loop Release-grade QA loop for Codex CLI. Iterates until duration / rounds / goal targets are met — not just on the first plausible answer. (Go)
🔁 cc-loop Same harness, but wired into Claude Code lifecycle hooks. (Go)

Knowledge & spec tooling

Project What it does
📚 kb Build LLM-ready knowledge bases from code, URLs, files and YouTube. Outputs Obsidian-compatible vaults with codebase metrics, dead-code detection and semantic search. (Go)
📓 skeeper Sidecar Git repo for spec artifacts. Keeps PRDs, ADRs, and AI plans versioned and diffable — separate from main-branch noise. (Go)
🕸️ gograph Go codebase graph analyzer. Powers structural queries for agents working in large Go repos. (Go)

Distribution

Project What it does
🍺 homebrew-compozy Official Homebrew tap for the Compozy CLI suite.

🛠️ Personal tools & scaffolds

Project What it does
🧩 skills 126 curated agent skills across original work, hand-picked community gems, marketing playbooks, and broader dev tooling. (375+ ⭐)
🪜 devstack Full-stack scaffold generator — Bun + Turborepo + React 19 + Hono + Drizzle + Postgres in minutes, not days. (TS)
🪜 go-devstack Same idea, Go edition.

🪦 OSS classics — the React/JS era

A selection of projects I'm best known for from my pre-AI life. Several are archived or in maintenance mode, but they shipped to a lot of people.

Project What it is
docz ✍️ "It has never been so easy to document your things." MDX-based docs framework. (archived) 23.6k
react-adopt 😎 Compose render-props components like a pro. 1.6k
reworm 🍫 The simplest way to manage state. 1.4k
micro-router 🚉 A tiny, functional router for Zeit's Micro. 615
react-video 🎞 React component to load video from Vimeo or YouTube across any device. 274
react-simpletabs Just a simple tabs component built with React. 184
algorithms-with-es6 Classic algorithms implemented in modern JavaScript. 159
reicons 💅 Bundle your SVGs into fully customized React components. 111
gatsby-starter-docz 📝 Gatsby starter with Docz + a blog for your docs. 90
frontend-styleguide Keep your frontend code clean, legible and beautiful. 70
yarn-workspaces-example One of the earliest public examples of Yarn monorepos. 45
oneoften Tips, tricks and tutorials on "How to build a large-scale JS application." 44
which-licenses-i-have 📝 Learn about the licenses around your packages. 30
storz Global state machines, made easy. 21

⚡ What I'm doing now

  • Shipping Compozy and the surrounding agent stack
  • Running multiple agent instances concurrently as a daily driver — and learning what breaks
  • Writing and speaking about agentic engineering: how teams should actually adopt agents in production
  • Sponsoring open-source builders I rely on (@raphamorim)

🤝 Let's connect


📍 San Francisco · 🇧🇷 → 🇺🇸 · Coffee-powered · Always shipping

Pinned Loading

  1. compozy/compozy compozy/compozy Public

    Drive the full lifecycle of AI-assisted development — from idea to shipped code.

    Go 2.2k 111

  2. compozy/agh compozy/agh Public

    An open workplace for AI agents — local-first runtime with durable sessions and agent-to-agent networking.

    Go 70 6

  3. compozy/skeeper compozy/skeeper Public

    Version your spec artifacts — PRDs, tech specs, ADRs, AI plans — in a sidecar Git repository, without polluting your main PRs.

    Go 68 6

  4. compozy/codex-loop compozy/codex-loop Public

    Keep Codex tasks running until they meet a time or round-based completion target.

    Go 32 1

  5. skills skills Public

    My personal favorite skills

    JavaScript 377 64

  6. docz docz Public archive

    ✍ It has never been so easy to document your things!

    TypeScript 23.6k 1.4k