Diagnostic Atlas - devzzs.com

1. Architecture du CLAUDE.md global

Le fichier /root/.claude/CLAUDE.md est le cerveau central. Il est injecte dans chaque conversation de chaque agent, quel que soit le projet. C'est l'identite partagee de tout le systeme.

Structure et role de chaque section

Section	Role	Impact
Qui je suis	Definit le contexte metier (achat-revente, testeur antibot)	Permet aux agents de comprendre le cadre legal et le type de travail
Activites principales	Liste les domaines d'intervention	Guide les agents sur ce qui est autorise (bypass legal, bots CGU-compliant)
Stack habituelle	Python, JS, Go, VPS, Discord	Les agents proposent des solutions dans cette stack par defaut
Preferences de travail	FR/EN, commits, git add cible, tester avant PR	Regles appliquees par tous les agents a chaque action
Agents Discord actifs	Liste les 6 agents et leur role	Reference pour le routage des taches entre agents
Skills disponibles	Pointe vers `/root/.claude/skills/`	Les agents consultent ces skills avant de coder
Infrastructure	VPS, domaine, Discord, GitHub	Contexte technique pour les deploiements et configs

Hierarchie d'injection : Global CLAUDE.md → Projet CLAUDE.md → Agent definition → Skills → Memory. Chaque couche s'ajoute au contexte, elle ne remplace pas la precedente.

2. CLAUDE.md par projet (6 fichiers)

Chaque projet a son propre CLAUDE.md qui specialise l'agent quand il travaille dans ce repertoire.

Projet	Agent	Mission	Stack
`monkey-bulkorder`	Atlas-Monkey-BulkOrder	Commandes en masse sur marketplaces	Python
`monkeybot`	Expert Go / Amazon API	ACO multi-marketplace (FR/DE/ES/IT)	Go PostgreSQL Redis
`thesaurus`	Atlas-Thesaurus	Catalogue BD pour mediatheques	Python Flask
`atlas-veille`	Atlas-Veille	Veille techno, creation de skills	Python
`eanmaster`	Atlas-EanMASTER	Conversion SKU/EAN multi-sites	Python SQLite
`flashmonkey`	(Extension Chrome)	Extension navigateur pour MonkeyBot	JS

3. Arborescence `/root/.claude/`

Ce repertoire EST un repo git (github.com/zzatar/.claude). Il centralise toute la configuration des agents.

/root/.claude/ CLAUDE.md # Identite globale (injectee partout) settings.json # Config Claude Code (model, plugins, permissions) settings.local.json # Overrides locaux agents/ # 29 definitions d'agents specialises techlead.md # Chef d'orchestre (opus, 50 turns) dev-backend.md # Dev backend (opus, 40 turns, worktree) dev-web.md # Dev frontend (opus, 40 turns, worktree) security.md # Auditeur secu (sonnet, 25 turns) testeur.md # QA (sonnet, 30 turns) engineering-*.md # 24 agents engineering specialises skills/ # Competences partagees entre agents git-workflow/ # Regles git obligatoires product-verification/ # Checklist avant PR learned/ # Skills creees par atlas-veille cloakbrowser-stealth-chromium.md scrapling-adaptive-scraping.md commands/ # Slash commands personnalisees commit-push-pr.md # /commit-push-pr status.md # /status review.md # /review channels/ # Config des 6 channels Discord discord/ # Channel principal discord-wazzatar/ # Channel agent wazzatar discord-monkeymon/ # Channel agent monkeymon discord-psg/ # Channel agent psg discord-thesaurus/ # Channel agent thesaurus discord-veille/ # Channel veille techno projects/ # Memoire par projet plugins/ # Discord, Superpowers, Everything CC homunculus/ # Systeme d'evolution/apprentissage todos/ # 63+ fichiers de taches sessions/ # Historique des sessions plans/ # Plans de travail

4. Les agents : roles et relations

Agents "core" (equipe de dev)

Agent	Model	Turns	Isolation	Role
techlead	opus	50	standard	Chef d'orchestre. Planifie, dispatche aux agents, review et livre via Discord
dev-backend	opus	40	worktree	Dev backend. API, BDD, logique metier. Travaille en copie isolee du repo
dev-web	opus	40	worktree	Dev frontend. UI, composants, responsive. Travaille en copie isolee
security	sonnet	25	standard	Audit OWASP, secrets, auth, injections
testeur	sonnet	30	standard	Tests unitaires, integration, E2E, build

Flux de travail typique

Discord message

→

techlead analyse

→

dispatche dev-backend / dev-web

→

code en worktree isole

→

testeur valide

→

security audit

→

techlead review & PR

Agents Discord (6 bots actifs)

Bot	Channel	Projet	Fonction
atlas-wazzatar	#wazzatar	wazzzatar	Agent general polyvalent
atlas-monkeymon	#monkeymon	monkeymon	Agent general polyvalent
atlas-thesaurus	#thesaurus	thesaurus	Gestion catalogue mediatheque
atlas-psg	#psg	psg	Agent general polyvalent
atlas-veille	#veille-setup	atlas-veille	Veille techno, cree des skills
atlas-eanmaster	#eanmaster	eanmaster	Scraping/conversion SKU↔EAN

24 agents engineering specialises

Disponibles a la demande via le tool Agent. Utilises par le techlead ou directement par les agents projets.

AI Engineer

ML, RAG, LLM integration

Backend Architect

System design, microservices

Code Reviewer

Review constructive

Database Optimizer

PostgreSQL, indexing

Data Engineer

ETL, pipelines, Spark

DevOps Automator

CI/CD, Terraform, K8s

Frontend Developer

React/Vue, Web Vitals

Git Workflow Master

Branching, commits

Security Engineer

Threat modeling, OWASP

SRE

SLOs, observability

Technical Writer

Docs, API refs

Rapid Prototyper

MVP, proof of concept

Mobile Builder

iOS/Android, Flutter

Embedded Firmware

ESP32, STM32, RTOS

Solidity Engineer

Smart contracts, DeFi

Incident Commander

Post-mortem, on-call

Threat Detection

SIEM, MITRE ATT&CK

Senior Developer

Laravel, Three.js

Software Architect

DDD, ADRs

AI Data Remediation

Self-healing pipelines

Autonomous Optimizer

Shadow testing, cost guard

WeChat Developer

Mini programs

Feishu Developer

Lark integration

Senior Developer

Laravel/Livewire/Flux

5. Comment les agents pushent sur Git

Regles globales (skill git-workflow)

Jamais git add . — toujours cibler les fichiers un par un
Conventional commits : feat:, fix:, refactor:, chore:
Branches : feat/<description-courte>
Jamais de secrets commites
Tester avant PR (skill product-verification)

Identites git par agent

Agent	Nom Git	Email
techlead	techlead-agent	techlead@agents.dev
dev-web	dev-web-agent	dev-web@agents.dev
dev-backend	dev-backend-agent	dev-backend@agents.dev

Flux git typique

git checkout dev && git pull

→

git checkout -b feat/xxx

→

code + tests

→

go build / npm run build

→

git add fichiers cibles

→

git commit -m "feat: ..."

→

git push origin feat/xxx

→

gh pr create --base dev

Hooks de securite (plugin everything-claude-code)

Hook	Type	Action
block-no-verify	PreToolUse (Bash)	Bloque `--no-verify` et `--no-gpg-sign`
auto-tmux-dev	PreToolUse (Bash)	Lance les serveurs dev dans tmux
pre-bash-git-push-reminder	PreToolUse (Bash)	Rappel avant git push de reviewer les changements

Repos actifs et leur etat

Projet	Remote	Branch	Etat
monkeybot	github.com/zzatar/monkeybot	main	Clean
flashmonkey	github.com/zzatar/Flashmonkey	main	Clean
eanmaster	github.com/zzatar/ean-master	main	Clean
thesaurus	github.com/zzatar/THESAURUS	main	Clean
monkeymon	github.com/zzatar/monkeymon	main	Clean
monkey-bulkorder	—	—	Pas de repo git

monkey-bulkorder n'est pas initialise comme repo git malgre son CLAUDE.md qui mentionne des commits. A corriger.

6. Skills

Skills globales

Skill	Role
`git-workflow`	Regles git obligatoires, identites par agent
`product-verification`	Checklist tsc/build/test avant PR
`veille-technologique`	Process d'analyse et scoring des liens

Skills apprises (par atlas-veille)

Skill	Role
`cloakbrowser`	Stealth Chromium, antibot evasion
`scrapling`	Framework scraping adaptatif Python

Cycle de creation : atlas-veille recoit un lien → analyse → score ≥7 → cree un .md dans skills/learned/ → commit + push sur github.com/zzatar/.claude → tous les agents y ont acces.

7. Slash commands & Plugins

Commande	Action
`/commit-push-pr`	Commit, push et cree une PR
`/status`	Resume rapide de l'etat du projet
`/review`	Review complete d'une PR

Plugins actifs

Plugin	Role
Discord	Interface de controle des agents
Superpowers	Capacites etendues
Everything CC	Hooks, tmux, git safety

8. Infrastructure web (nginx + SSL)

Domaine	Backend	Port	SSL	Cert expiry
thesaurus.devzzs.com	Python Flask	5000	Let's Encrypt	2026-06-21
ean-master.devzzs.com	Python Flask	5050	Let's Encrypt	2026-06-24
monkeybulkorder.devzzs.com	Go binary	8080	Let's Encrypt	2026-06-24
monkeymon.devzzs.com	Node.js	3001	Let's Encrypt	2026-06-22
wazzatar.devzzs.com	Binary	5003	Let's Encrypt	2026-06-22
psg.devzzs.com	Backend	5002	HTTP only	—
devzzs.com (diagnostic)	Static HTML	—	Let's Encrypt	2026-06-21

9. Schema global des relations

Discord (serveur DEVZ) | |-- #general ---------> atlas (agent principal) |-- #wazzatar -------> atlas-wazzatar --------> /root/projets/wazzzatar/ |-- #monkeymon ------> atlas-monkeymon -------> /root/projets/monkeymon/ |-- #thesaurus ------> atlas-thesaurus -------> /root/projets/thesaurus/ |-- #psg ------------> atlas-psg -------------> /root/projets/psg/ |-- #veille-setup ---> atlas-veille ----------> /root/projets/atlas-veille/ |-- #eanmaster ------> atlas-eanmaster -------> /root/projets/eanmaster/ |-- #bulkorder ------> atlas-monkey-bulkorder -> /root/projets/monkey-bulkorder/ | v Chaque agent charge : 1. /root/.claude/CLAUDE.md (identite globale) 2. /root/projets/XXX/CLAUDE.md (mission specifique) 3. /root/.claude/agents/*.md (agents specialises disponibles) 4. /root/.claude/skills/** (competences partagees) 5. /root/.claude/projects/XXX/memory (memoire persistante) | v Git workflow : Agent code -> git add [fichiers] -> commit (conventional) -> push origin feat/xxx -> gh pr create Identite git specifique par agent (techlead@agents.dev, dev-web@agents.dev, etc.) Auth via gh CLI (OAuth GitHub)

10. Points d'attention

Sujet	Statut	Detail
monkey-bulkorder sans git	A corriger	Le projet a un CLAUDE.md qui parle de commits mais n'est pas un repo git
psg.devzzs.com sans SSL	A surveiller	Seul sous-domaine en HTTP pur, pas de certificat Let's Encrypt
Pas de hooks git actifs	A surveiller	Tous les repos n'ont que des .sample hooks. Les regles de commit dependent uniquement des plugins Claude Code
Identite git incomplete	A surveiller	Seul monkeybot a un user.email local. Les autres heritent du global (non defini dans .gitconfig)
atlas-veille pas de users approuves	A surveiller	Le channel discord-veille n'a pas encore d'utilisateurs approuves
Services en user claude	OK	Bonne pratique de ne pas tourner en root
SSL certificates	OK	Tous valides jusqu'a juin 2026 (86-89 jours)
Agent Teams experimental	Experimental	CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS active dans settings.json

Diagnostic Atlas Infrastructure