Skip to content

Epic: agents live outside the monorepo — enforce the platform-only boundary #50

Description

@serge-ivo

Principle

From docs/agent-platform-strategy.md:

The monorepo holds the platform only (runtime, tools, brain, marketplace, billing). Creator agents are either data or isolated code — never woven into the core. First-party runtime agents (Coder/apply) are the rare core-resident exception.

PAGS had drifted from this: 10 self-contained standalone-worker agents existed as duplicate inert copies under platform/agents/ (not pnpm workspace members, not typechecked, not deployed) and as their own ProAgentStore/<slug> repos (the real deploy unit, each with its own deploy.yml). Pure drift weight, untouched since the 2026-06 seed.

The correct model (three buckets)

Bucket Agents Home
Tier-0 — core-resident (platform imports/runs them) coder (web UI imported by console), job-application-assistant (apply pipeline) monorepo platform/agents/ (pnpm workspace members)
Tier-1 — config/data (D1/DO, no code) repo-chat (seeded via migration 0032, runs in AgentDO) monorepo (seed/migration) — data, not a worker
Standalone-worker (own CF Worker + deploy.yml) site-monitor, lead-qualifier, content-pipeline, competitor-intel, support-escalator, data-analyst, meeting-notes, seo-auditor, invoice-parser, email-drafter, creator-os-agent, qa-automation, small-business-website-lead-finder own ProAgentStore/<slug> repo, cloned locally to ~/dev/stores/pags/agents/<slug>/

Done (2026-08-01)

  • Verified each of the 10 monorepo copies against its standalone repo (7 identical; invoice-parser/meeting-notes/seo-auditor had monorepo-only cosmetic biome/lint drift — pushed back to the standalone repos so those are canonical).
  • Removed the 10 duplicate platform/agents/* dirs from the monorepo — commit f9980a8 on main.
  • Kept coder, job-application-assistant, repo-chat.
  • Updated docs/agent-platform-strategy.md (standalone agents live in own repos) and documented the local pags/agents/<slug>/ clone convention.

Remaining

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions