ShamoX Agent

Agent codeur autonome GitLab CI/CD + MLX local.

Architecture

Issue GitLab + commentaire @shamox-codeur
    ↓
Webhook GitLab → trigger pipeline CI
    ↓
Job `codeur` (Qwen3-Coder-30B via mlx_lm)
  - lit l'issue et l'historique des commentaires
  - produit les modifications de fichiers en XML
  - commit + push sur feature/issue-NNN
    ↓
Job `agent-git` (Qwen3.5-4B via mlx_lm)
  - analyse le diff
  - génère la description de MR
  - crée la MR et assigne le reviewer
    ↓
Review manuelle + merge

Variables CI/CD requises

Variable	Description
SHAMOX_BOT_ID	ID GitLab du compte de service shamox-bot
SHAMOX_BOT_API_TOKEN	Project Access Token avec scope api
SHAMOX_REVIEWER_ID	ID GitLab numérique du reviewer

Intégration dans un projet

Dans le .gitlab-ci.yml du projet cible, inclure :

include:
  - project: 'rlaures.pro/shamox-agent'
    ref: main
    file: '.gitlab-ci.yml'

Stack

• Ruby stdlib uniquement (pas de gems externes)
• mlx_lm sur Apple Silicon (M1/M4)
• GitLab CI/CD Runners headless (chacana, hecaton-macmini-001)