# tusharsapra/marketing-room architecture

> Architecture diagram of the GitHub repository tusharsapra/marketing-room, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tusharsapra/marketing-room
- Repository: https://github.com/tusharsapra/marketing-room

## Overview

The Marketing Room is a Claude Code/Codex skill that turns a client brief into a reviewed marketing plan through specialist proposals, structured challenges, mechanical checks and conflict resolution. The README documents the domain flow and major capabilities; the sampled `room.py` excerpt supports its stateful orchestration, checks, output handling and stage dispatch. Other skill files are represented by paths from the tree, but their contents were not sampled.

Main entry points: [`skills/marketing-room/scripts/room.py`](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py) (Room state engine), [`skills/marketing-room/references/seats`](https://github.com/tusharsapra/marketing-room/tree/main/skills/marketing-room/references/seats) (Specialist plans), [`skills/marketing-room/references/seats/project-head.md`](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/seats/project-head.md) (Project Head), [`skills/marketing-room/references/lenses.json`](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/lenses.json) (Lens challenges)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Session workflow"]
  node_project_head["Project Head<br/>[project-head.md]"]
  node_seat_plans["Specialist plans"]
  node_room_engine["Room state engine<br/>[room.py]"]
  node_challenge["Lens challenges<br/>[lenses.json]"]
  node_facilitator["Facilitator<br/>[facilitator.md]"]
end

subgraph group_analysis["Planning and checks"]
  node_checks["Feasibility checks<br/>[room.py]"]
  node_benchmarks["Platform benchmarks<br/>[benchmarks.json]"]
  node_audit["Audit exports<br/>[audit.md]"]
end

subgraph group_knowledge["Skill knowledge"]
  node_tensions["Seat tension map<br/>[tension-map.md]"]
  node_seat_mandates["Seat mandates"]
  node_work_types["Work-type outlines"]
end

subgraph group_outputs["Decisions and deliverables"]
  node_conflicts["Conflict resolution<br/>[room.py]"]
  node_ruling["Project Head ruling<br/>[room.py]"]
  node_integrated["Integrated deliverable<br/>[room.py]"]
  node_review["Ship review<br/>[room.py]"]
  node_session_files[("Session files<br/>[room.py]")]
  node_final_pack["Final plan pack<br/>[room.py]"]
end

node_client(("Client / user"))

node_client -->|"submits brief"| node_project_head
node_project_head -->|"assigns seats"| node_seat_plans
node_seat_plans -->|"challenge plans"| node_challenge
node_challenge -->|"surface disputes"| node_facilitator
node_seat_plans -->|"check forecasts"| node_checks
node_checks -.->|"apply thresholds"| node_benchmarks
node_checks -->|"summarize exports"| node_audit
node_facilitator -->|"propose settlement"| node_conflicts
node_conflicts -->|"escalate unsettled"| node_ruling
node_ruling -->|"inform plan"| node_integrated
node_facilitator -->|"write plan"| node_integrated
node_integrated -->|"check requirements"| node_review
node_review -->|"ships plan"| node_client
node_project_head -->|"directs stages"| node_room_engine
node_room_engine -->|"stores session"| node_session_files
node_room_engine -->|"runs checks"| node_checks
node_room_engine -->|"processes stages"| node_conflicts
node_room_engine -->|"builds report"| node_final_pack
node_seat_plans -.->|"uses mandates"| node_seat_mandates
node_challenge -.->|"draws on pairs"| node_tensions
node_integrated -->|"uses outline"| node_work_types
node_final_pack -->|"delivers files"| node_client

click node_project_head "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/seats/project-head.md"
click node_seat_plans "https://github.com/tusharsapra/marketing-room/tree/main/skills/marketing-room/references/seats"
click node_room_engine "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py"
click node_challenge "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/lenses.json"
click node_facilitator "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/seats/facilitator.md"
click node_checks "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py"
click node_benchmarks "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/benchmarks.json"
click node_audit "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/work-types/audit.md"
click node_tensions "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/tension-map.md"
click node_seat_mandates "https://github.com/tusharsapra/marketing-room/tree/main/skills/marketing-room/references/seats"
click node_work_types "https://github.com/tusharsapra/marketing-room/tree/main/skills/marketing-room/references/work-types"
click node_conflicts "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py"
click node_ruling "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py"
click node_integrated "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py"
click node_review "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py"
click node_session_files "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py"
click node_final_pack "https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_project_head,node_seat_plans,node_room_engine,node_challenge,node_facilitator,node_client toneBlue
class node_checks,node_benchmarks,node_audit toneAmber
class node_tensions,node_seat_mandates,node_work_types toneMint
class node_conflicts,node_ruling,node_integrated,node_review,node_session_files,node_final_pack toneRose
```

## Components

### Session workflow

- [Project Head](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/seats/project-head.md): `skills/marketing-room/references/seats/project-head.md`
- [Specialist plans](https://github.com/tusharsapra/marketing-room/tree/main/skills/marketing-room/references/seats): `skills/marketing-room/references/seats`
- [Room state engine](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py): `skills/marketing-room/scripts/room.py`
- [Lens challenges](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/lenses.json): `skills/marketing-room/references/lenses.json`
- [Facilitator](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/seats/facilitator.md): `skills/marketing-room/references/seats/facilitator.md`

### Planning and checks

- [Feasibility checks](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py): `skills/marketing-room/scripts/room.py`
- [Platform benchmarks](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/benchmarks.json): `skills/marketing-room/references/benchmarks.json`
- [Audit exports](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/work-types/audit.md): `skills/marketing-room/references/work-types/audit.md`

### Skill knowledge

- [Seat tension map](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/references/tension-map.md): `skills/marketing-room/references/tension-map.md`
- [Seat mandates](https://github.com/tusharsapra/marketing-room/tree/main/skills/marketing-room/references/seats): `skills/marketing-room/references/seats`
- [Work-type outlines](https://github.com/tusharsapra/marketing-room/tree/main/skills/marketing-room/references/work-types): `skills/marketing-room/references/work-types`

### Decisions and deliverables

- [Conflict resolution](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py): `skills/marketing-room/scripts/room.py`
- [Project Head ruling](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py): `skills/marketing-room/scripts/room.py`
- [Integrated deliverable](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py): `skills/marketing-room/scripts/room.py`
- [Ship review](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py): `skills/marketing-room/scripts/room.py`
- [Session files](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py): `skills/marketing-room/scripts/room.py`
- [Final plan pack](https://github.com/tusharsapra/marketing-room/blob/main/skills/marketing-room/scripts/room.py): `skills/marketing-room/scripts/room.py`

### Other components

- **Client / user**

## Connections

- Client / user → Project Head: submits brief (evidence: `README.md`)
- Project Head → Specialist plans: assigns seats (evidence: `README.md`)
- Specialist plans → Lens challenges: challenge plans (evidence: `README.md`)
- Lens challenges → Facilitator: surface disputes (evidence: `README.md`)
- Specialist plans → Feasibility checks: check forecasts (evidence: `README.md`)
- Feasibility checks → Platform benchmarks: apply thresholds
- Feasibility checks → Audit exports: summarize exports (evidence: `README.md`)
- Facilitator → Conflict resolution: propose settlement (evidence: `README.md`)
- Conflict resolution → Project Head ruling: escalate unsettled (evidence: `README.md`)
- Project Head ruling → Integrated deliverable: inform plan (evidence: `README.md`)
- Facilitator → Integrated deliverable: write plan (evidence: `README.md`)
- Integrated deliverable → Ship review: check requirements (evidence: `README.md`)
- Ship review → Client / user: ships plan (evidence: `README.md`)
- Project Head → Room state engine: directs stages (evidence: `README.md`)
- Room state engine → Session files: stores session (evidence: `skills/marketing-room/scripts/room.py`)
- Room state engine → Feasibility checks: runs checks (evidence: `skills/marketing-room/scripts/room.py`)
- Room state engine → Conflict resolution: processes stages (evidence: `skills/marketing-room/scripts/room.py`)
- Room state engine → Final plan pack: builds report (evidence: `skills/marketing-room/scripts/room.py`)
- Specialist plans → Seat mandates: uses mandates
- Lens challenges → Seat tension map: draws on pairs
- Integrated deliverable → Work-type outlines: uses outline (evidence: `README.md`)
- Final plan pack → Client / user: delivers files (evidence: `README.md`)
