# aguileralorenzo/cockpit-entretien architecture

> Architecture diagram of the GitHub repository aguileralorenzo/cockpit-entretien, 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/aguileralorenzo/cockpit-entretien
- Repository: https://github.com/aguileralorenzo/cockpit-entretien

## Overview

Cockpit d'entretien is a private, local-first workspace for preparing an annual compensation review and retaining a sourced career record. The user workflow runs from Claude Code skills that gather and analyze documents into the dossier, through interface-based planning and practice, to acceptance decisions and reusable debriefs. The browser app and localhost server exchange JSON with the on-disk dossier; Claude Code provides the model-driven coaching externally. The README documents several capabilities whose implementation was not sampled, so those nodes are mapped to supported data paths or directories, with uncertain links omitted.

Main entry points: [`public/app.js`](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/public/app.js) (Cockpit interface), [`.claude/skills/demarrer/SKILL.md`](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/.claude/skills/demarrer/SKILL.md) (Setup skill), [`.claude/skills/relire/SKILL.md`](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/.claude/skills/relire/SKILL.md) (Document review), [`outils/faire-debrief.mjs`](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/outils/faire-debrief.mjs) (Debrief page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prep["Dossier preparation"]
  node_incoming["Source documents"]
  node_startskill["Setup skill<br/>[SKILL.md]"]
  node_reviewskill["Document review<br/>[SKILL.md]"]
  node_dossier[("Career dossier")]
  node_profile["Profile and targets<br/>[profil.json]"]
  node_records["Career evidence<br/>[realisations.json]"]
  node_offers["Market offers<br/>[offres.json]"]
  node_pay["Pay records<br/>[paie.json]"]
end

subgraph group_workspace["Cockpit workspace"]
  node_cockpit["Cockpit interface<br/>[app.js]"]
  node_server["Local API server<br/>[server.js]"]
  node_actions["Action plan<br/>[actions.json]"]
  node_otherdata[("Career tracking data")]
end

subgraph group_practice["Practice and review"]
  node_practicedata["Practice exercises<br/>[exercices.json]"]
  node_numberquiz["Figure quiz<br/>[chiffres.json]"]
  node_trainingskill["Manager rehearsal<br/>[SKILL.md]"]
  node_exchange["Live exchange<br/>[echange.json]"]
  node_sessions["Replay sessions<br/>[repetitions.json]"]
  node_debrief["Debrief page<br/>[faire-debrief.mjs]"]
  node_debriefdata["Debrief evaluation<br/>[negociation.json]"]
end

subgraph group_decision["Compensation decisions"]
  node_acceptance["Acceptance grid"]
  node_acceptdata["Acceptance rules<br/>[acceptation.json]"]
  node_commitments["Commitments<br/>[engagements.json]"]
end

node_person(("User"))
node_claude["Claude Code"]

node_person -->|"invokes skills"| node_claude
node_person -->|"provides documents"| node_incoming
node_claude -->|"runs setup"| node_startskill
node_claude -->|"runs review"| node_reviewskill
node_startskill -->|"requests documents"| node_incoming
node_startskill -->|"fills dossier"| node_dossier
node_reviewskill -->|"reads documents"| node_incoming
node_reviewskill -->|"updates dossier"| node_dossier
node_person -->|"edits and reviews"| node_cockpit
node_cockpit -->|"GET and PUT"| node_server
node_server -->|"reads and writes JSON"| node_dossier
node_cockpit -.->|"loads exercises"| node_practicedata
node_cockpit -->|"resolves quiz values"| node_numberquiz
node_cockpit -->|"writes and polls"| node_exchange
node_trainingskill -->|"plays manager"| node_claude
node_claude -->|"reads and responds"| node_exchange
node_cockpit -->|"records rehearsals"| node_sessions
node_claude -->|"writes evaluation"| node_debriefdata
node_debrief -->|"formats evaluation"| node_debriefdata
node_debrief -->|"writes output page"| node_debrief
node_cockpit -.->|"shows grid"| node_acceptdata
node_acceptance -->|"derives thresholds"| node_profile
node_acceptance -->|"generates grid"| node_acceptdata
node_cockpit -->|"tracks habits"| node_actions
node_cockpit -.->|"shows pending items"| node_commitments
node_cockpit -.->|"presents evidence"| node_records
node_cockpit -.->|"presents offers"| node_offers
node_cockpit -.->|"charts pay history"| node_pay

click node_incoming "https://github.com/aguileralorenzo/cockpit-entretien/tree/main/inbox"
click node_startskill "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/.claude/skills/demarrer/SKILL.md"
click node_reviewskill "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/.claude/skills/relire/SKILL.md"
click node_dossier "https://github.com/aguileralorenzo/cockpit-entretien/tree/main/data"
click node_profile "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/profil.json"
click node_records "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/realisations.json"
click node_offers "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/offres.json"
click node_pay "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/paie.json"
click node_cockpit "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/public/app.js"
click node_server "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/server.js"
click node_practicedata "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/exercices.json"
click node_numberquiz "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/chiffres.json"
click node_trainingskill "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/.claude/skills/train/SKILL.md"
click node_exchange "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/echange.json"
click node_sessions "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/repetitions.json"
click node_debrief "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/outils/faire-debrief.mjs"
click node_debriefdata "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/negociation.json"
click node_acceptance "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/outils/faire-acceptation.mjs"
click node_acceptdata "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/acceptation.json"
click node_actions "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/actions.json"
click node_commitments "https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/engagements.json"
click node_otherdata "https://github.com/aguileralorenzo/cockpit-entretien/tree/main/data"

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_incoming,node_startskill,node_reviewskill,node_dossier,node_profile,node_records,node_offers,node_pay,node_person toneBlue
class node_cockpit,node_server,node_actions,node_otherdata toneAmber
class node_practicedata,node_numberquiz,node_trainingskill,node_exchange,node_sessions,node_debrief,node_debriefdata toneMint
class node_acceptance,node_acceptdata,node_commitments toneRose
class node_claude toneIndigo
```

## Components

### Dossier preparation

- [Source documents](https://github.com/aguileralorenzo/cockpit-entretien/tree/main/inbox): `inbox`
- [Setup skill](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/.claude/skills/demarrer/SKILL.md): `.claude/skills/demarrer/SKILL.md`
- [Document review](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/.claude/skills/relire/SKILL.md): `.claude/skills/relire/SKILL.md`
- [Career dossier](https://github.com/aguileralorenzo/cockpit-entretien/tree/main/data): `data`
- [Profile and targets](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/profil.json): `data/profil.json`
- [Career evidence](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/realisations.json): `data/realisations.json`
- [Market offers](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/offres.json): `data/offres.json`
- [Pay records](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/paie.json): `data/paie.json`

### Cockpit workspace

- [Cockpit interface](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/public/app.js): `public/app.js`
- [Local API server](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/server.js): `server.js`
- [Action plan](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/actions.json): `data/actions.json`
- [Career tracking data](https://github.com/aguileralorenzo/cockpit-entretien/tree/main/data): `data`

### Practice and review

- [Practice exercises](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/exercices.json): `data/exercices.json`
- [Figure quiz](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/chiffres.json): `data/chiffres.json`
- [Manager rehearsal](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/.claude/skills/train/SKILL.md): `.claude/skills/train/SKILL.md`
- [Live exchange](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/echange.json): `data/echange.json`
- [Replay sessions](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/repetitions.json): `data/repetitions.json`
- [Debrief page](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/outils/faire-debrief.mjs): `outils/faire-debrief.mjs`
- [Debrief evaluation](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/negociation.json): `data/negociation.json`

### Compensation decisions

- [Acceptance grid](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/outils/faire-acceptation.mjs): `outils/faire-acceptation.mjs`
- [Acceptance rules](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/acceptation.json): `data/acceptation.json`
- [Commitments](https://github.com/aguileralorenzo/cockpit-entretien/blob/main/data/engagements.json): `data/engagements.json`

### Other components

- **User**
- **Claude Code**

## Connections

- User → Claude Code: invokes skills (evidence: `README.md`)
- User → Source documents: provides documents (evidence: `README.md`)
- Claude Code → Setup skill: runs setup (evidence: `README.md`)
- Claude Code → Document review: runs review (evidence: `README.md`)
- Setup skill → Source documents: requests documents (evidence: `README.md`)
- Setup skill → Career dossier: fills dossier (evidence: `README.md`)
- Document review → Source documents: reads documents (evidence: `README.md`)
- Document review → Career dossier: updates dossier (evidence: `README.md`)
- User → Cockpit interface: edits and reviews (evidence: `README.md`)
- Cockpit interface → Local API server: GET and PUT (evidence: `public/app.js`)
- Local API server → Career dossier: reads and writes JSON (evidence: `server.js`)
- Cockpit interface → Practice exercises: loads exercises
- Cockpit interface → Figure quiz: resolves quiz values (evidence: `README.md`)
- Cockpit interface → Live exchange: writes and polls (evidence: `public/app.js`)
- Manager rehearsal → Claude Code: plays manager (evidence: `README.md`)
- Claude Code → Live exchange: reads and responds (evidence: `README.md`)
- Cockpit interface → Replay sessions: records rehearsals (evidence: `README.md`)
- Claude Code → Debrief evaluation: writes evaluation (evidence: `README.md`)
- Debrief page → Debrief evaluation: formats evaluation (evidence: `outils/faire-debrief.mjs`)
- Debrief page → Debrief page: writes output page (evidence: `outils/faire-debrief.mjs`)
- Cockpit interface → Acceptance rules: shows grid
- Acceptance grid → Profile and targets: derives thresholds (evidence: `outils/faire-acceptation.mjs`)
- Acceptance grid → Acceptance rules: generates grid (evidence: `outils/faire-acceptation.mjs`)
- Cockpit interface → Action plan: tracks habits (evidence: `public/app.js`)
- Cockpit interface → Commitments: shows pending items
- Cockpit interface → Career evidence: presents evidence
- Cockpit interface → Market offers: presents offers
- Cockpit interface → Pay records: charts pay history
