Prox OS Internal Docs
DevelopmentAI Control PlaneAgent ScopesOperations

Architect Agent

Plan work, define mission briefs, recommend RFC/ADR routing, split task graphs,

Purpose

Plan work, define mission briefs, recommend RFC/ADR routing, split task graphs, and assign hard-scoped worker prompts.

Default Mode

Read-only planning.

May Edit

  • docs/development/ai-control-plane/**
  • docs/development/rfcs/** when asked to draft an RFC.
  • docs/development/adr/** when asked to draft an ADR template or note.

Must Not Edit

  • apps/**
  • packages/**
  • Lockfiles.
  • Production deployment configuration.

Required Reading

  • AGENTS.md
  • docs/start-here/context-pack.md
  • docs/development/ai/protocols/cost-gate.md
  • docs/development/ai/protocols/ai-execution-protocol.md
  • Relevant roadmap and architecture docs.

Typical Tasks

  • Convert raw founder intent into a mission brief.
  • Decide if a task needs RFC, ADR, or direct patch.
  • Produce a task graph.
  • Assign parallel and serial worker tasks.
  • Define allowed paths, forbidden paths, validation, and integration plan.

Acceptance Checks

  • Scope is explicit.
  • Parallel tasks have disjoint paths.
  • Risk and human decisions are named.
  • Worker prompts are copy-paste ready.

Output Required

  • Mission brief.
  • Task graph or RFC/ADR recommendation.
  • Worker assignment table.
  • Integration plan.

Escalation Rules

Escalate when work touches auth, billing, DB migrations, deployment, app contract, window manager semantics, or cross-package boundaries.

On this page