Developer · ChatGPT Desktop · Runtime Adapter · Repository
Status: Permanent
Applies to: All development work
Canonical reference: AI_DEVELOPMENT_ENVIRONMENT.md
ERP reference: runtime/specification/engineering-runtime-platform.md
Adapter v1 (Cursor): Native tools are Cursor Agent and OpenAI Codex — see adapters/cursor-adapter-v1/profile.md. This document describes collaboration roles; ERP Core defines runtime abstraction.
Role Model
| Role | Actor | Authority |
|---|---|---|
| Developer | Human | Architecture approval, implementation approval, freeze, releases, Git |
| ChatGPT Desktop | Architect | Specifications, reviews, planning, prompt generation, documentation |
| Runtime Adapter | IDE-specific mirror | ERP Core → native files (Adapter v1: Cursor) |
| Native IDE Runtime | Adapter v1: Cursor Agent · Codex | Runtime Implementation — no architecture authority |
| Repository | Git working tree | Source of truth |
No role absorbs another's responsibilities. Runtime Implementation agents are not architecture authorities.
Developer
Responsible for:
| Area | Detail |
|---|---|
| Architecture approval | Accept or reject Architect recommendations before implementation |
| Implementation approval | Review Cursor Agent and Codex output before Architect review |
| Context delivery | Live Context, Uploaded Context, Visual Context, Text Context |
| Freeze | Backup, commit, tag, push — on Architect instruction only |
| Releases | Execute release doc updates and Git with Architect guidance |
| Git decisions | Final authority on repository state |
Developer does NOT: bypass Architecture Review; freeze without Decision: Approved; treat Codex output as self-approved.
ChatGPT Desktop (Architect)
Responsible for:
| Area | Detail |
|---|---|
| Architecture | Module design, contracts, registries, boundaries |
| Specifications | Phase architecture specs — design before code |
| Reviews | RESPONSE_TEMPLATE.md |
| Planning | Scope, baseline verification |
| Prompt generation | Cursor Agent and Codex prompts |
| Documentation | Methodology alignment, release guidance |
| Architect Context | Live, Uploaded, Visual, Text orchestration |
ChatGPT Desktop does NOT: index the repository; write implementation code; execute freeze Git; delegate architecture review to Codex.
Cursor Agent
Responsible for:
| Area | Detail |
|---|---|
| Repository understanding | Indexing, @files, @folders, navigation |
| Implementation | Scoped edits within authorized prompts |
| Refactoring | Structural changes when explicitly prompted |
| Project-wide edits | Multi-file updates under authorization |
| Tests | Run and report when prompted |
Cursor Agent does NOT: become architecture authority; freeze without Developer + Architect approval.
OpenAI Codex (Autonomous Implementation Agent)
Responsible for:
| Area | Detail |
|---|---|
| Autonomous implementation | Multi-step tasks inside Cursor |
| Terminal execution | Shell, artisan (per approval mode) |
| Tests | Test suite execution |
| TODO execution | TODO → Task workflow |
| Planning mode | Step proposals before execution |
| Background implementation | Long-running scoped tasks |
| Implementation proposals | Suggested changes for Developer review |
Codex does NOT: perform architecture review; approve freeze; override frozen boundaries without prompt authorization.
Terminal and Git Responsibility
| Actor | Terminal / Git at implementation | Terminal / Git at freeze |
|---|---|---|
| ChatGPT Desktop | No | Instructs timing only |
| Developer | Manual when needed | Executes all freeze Git |
| Cursor Agent | When prompted | No |
| OpenAI Codex | When authorized in task | No |
Freeze sequence: GIT_FREEZE_PROCEDURE.md
Collaboration Flow
ChatGPT Desktop Developer Cursor Agent / Codex
(Architect) │ │
│── specification ───▶│ │
│── prompt ──────────▶│ │
│ │── Agent or Codex task ─▶│
│ │◀── implementation report│
│◀── Text Context ────│ │
│── review (8 sect) ──▶│ │
│ │── freeze Git ──────────│ (Developer only)Related Documents
Architect designs. Cursor Agent and Codex implement. Developer approves and freezes. Repository is truth.