Skip to content
View ShadowAgents's full-sized avatar

Block or report ShadowAgents

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.

Content in all repositories owned by your account will be closed.
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
ShadowAgents/README.md

Waving gradient hero banner with Jason Vineis and subtitle GMP Manufacturing Systems and AI Agent Orchestration

Animated typing headline describing GMP manufacturing background and governed AI orchestration systems

Focus badge: AI Agent Orchestration Stack badge: n8n, Supabase, Next.js Principle badge: Reliability greater than Cleverness

Who I am

I've spent two decades inside GMP biologics manufacturing at Merck's West Point site — currently as the SAP PAS-X (MES) subject matter expert, designing master data and electronic batch records that have to pass regulatory audit and survive contact with the actual factory floor.

That's where the governance obsession below comes from. Validation, audit trails, change control, deviation handling — manufacturing spent decades learning how to make automated systems trustworthy. Most AI projects are relearning it the hard way.


The Reals — public flagship

The Reals - a pixel town where the characters are real AI agents

A pixel-RPG front-end for real automation stacks — the characters are your actual AI agents, and everything they say is true. The banker knows the balances; the mailman read the email; the approvals desk signs real decisions. Play the demo · Repo

Little people. Real work.


What I do

I design and operate reliable AI agent fleets — 47 agents built, 37 in production across finance, rentals, documents, calendar, and email, coordinating to run real operations, not demos. Governed by design: deterministic logic first, AI second, with heartbeats, event logs, and human approval gates on every agent.

47 agents built, 37 in production n8n to Supabase to The Reals architecture Approval gated by design


Architecture

flowchart LR
    T([Triggers: schedule, webhook, chat]) --> N[n8n - logic and orchestration]
    N -- writes --> S[(Supabase - source of truth)]
    S -- reads --> L[The Reals - pixel-town interface]
    N -. heartbeats .-> H[workflow_health]
    N -. actions .-> E[agent_events]
    N -- destructive? --> A{approval_requests}
    A -- approved by human --> N
    subgraph Fleet[Agent Fleet]
      C[chief_of_staff]
      R[rental_intelligence]
      F[finance_intelligence]
      D[document_intelligence]
      G[gmail_intelligence]
    end
    C -.coordinates.- R & F & D & G
    N --- Fleet
    classDef brain fill:#06B6D4,stroke:#0891B2,color:#fff
    classDef logic fill:#6366F1,stroke:#4F46E5,color:#fff
    class S brain
    class N,C logic
Loading

See it run

Play the town demo


How approvals work

Proof-of-governance audit trail (sanitized example)
  • approval_request created for a destructive-action candidate
  • Human reviewer approves the request
  • Action executes through the orchestrated workflow
  • agent_events records the action metadata
  • workflow_health receives the updated heartbeat state

Tech toolbox

n8n Supabase PostgreSQL Next.js TypeScript Tailwind CSS SAP PAS-X MES Anthropic Claude OpenAI Telegram


Roadmap

timeline
    title Good / Better / Best rollout
    Q3 : Rental OS SKU #1
    Q4 : Finance Intelligence rollout
    Q1 : Document Intelligence rollout
    Q2 : Full composable Good/Better/Best menu
Loading

How I'd build yours in 30 days

  1. Discover - map one high-friction operational workflow worth automating.
  2. Build - ship one governed, approval-gated agent into production.
  3. Prove - measure reliability, speed, and decision quality on real operations.

Book a call


Activity

GitHub activity stats for ShadowAgents


Contact

Email LinkedIn

Reliability beats cleverness. Simplicity beats over-engineering.

Popular repositories Loading

  1. ShadowAgents ShadowAgents Public

  2. the-reals the-reals Public template

    The Sims, except the characters are real AI agents. Little people. Real work.

    HTML

  3. .github .github Public