Digital Access Kit

Garde-fous agent-agnostiques pour apprendre le vibecoding pro sur une vraie stack — sans laisser l'IA produire du god code ni des erreurs graves. Conçu pour le programme Digital Access for Women (Abidjan), 48h, débutantes.

Forké de l'esprit d'iroko, mais porté sur AGENTS.md + git hooks + SKILL.md pour tourner nativement sur Codex (et aussi Claude Code, Cursor, Copilot — c'est un standard ouvert).

Le principe directeur

L'humain authentifie. L'agent exécute.

La participante ne fait qu'une chose technique : se logger (gh, convex, vercel, codex). Ensuite l'agent IA fait tout le reste via CLI — créer le repo, installer, câbler, déployer. Il a interdiction de renvoyer la débutante vers une manip qu'il peut faire lui-même (voir la règle cli-first-autonomy dans AGENTS.md).

La compétence enseignée n'est pas « taper du code » — l'agent le tape. C'est diriger et juger un agent : prompt scopé, lire le diff, refuser le god code.

La stack (versions épinglées, prouvées en prod)

Extraites de filon, une app réelle qui tourne sur cette stack. On épingle parce que les agents IA, entraînés sur des versions plus anciennes, inventent des API mortes.

| Brique | Rôle | Version | |---|---|---| | TanStack Start | full-stack React (routing, SSR) | ^1.121.34 | | Convex | base de données réactive + backend | ^1.39.1 | | Better Auth | authentification | ^1.6.11 | | @convex-dev/better-auth | la couture auth ↔ Convex | ^0.12.2 | | shadcn/ui (Radix + Tailwind v4) | composants UI | Tailwind ^4.1.4 | | Vercel | hébergement / déploiement | — |

Recette de câblage complète et fichiers de référence : docs/STACK-REFERENCE.md.

Comment on s'en sert (zéro install)

1. Fork ce repo (ou le repo-template du programme).
2. Open in Codespace → le .devcontainer installe Node, pnpm, Codex CLI, gh. Rien à télécharger.
3. La participante s'authentifie sur les CLI (une fois).
4. L'agent prend la main : codex lit AGENTS.md, suit les garde-fous, construit.
5. Chaque commit passe la gate god-code (.githooks/pre-commit) — en français, pédagogique.

Ce que contient le kit

Structure correcte pour les deux agents : Codex lit .agents/skills/ + AGENTS.md + .codex/ ; Claude Code lit .claude/ + CLAUDE.md. Détails et sources dans docs/AGENT-CONFIG-REFERENCE.md.

digital-access-kit/
├── AGENTS.md                      # SOURCE des règles — Codex natif (+ Claude via CLAUDE.md)
├── CLAUDE.md                      # @AGENTS.md (compat Claude Code)
├── .agents/skills/                # skills CANONIQUES (Codex) : explique-moi, nouvelle-feature, deploie
├── .codex/config.toml             # config Codex : Context7 MCP, project_doc_max_bytes
├── .mcp.json                      # Context7 MCP pour Claude Code
├── .claude/
│   ├── rules/                     # rappels path-scopés (convex-coutures, ssr-vite)
│   ├── settings.json              # hook PostToolUse → gate en session
│   ├── hooks/check-file.sh        # vérif god-code immédiate (exit 2 = bloque)
│   ├── agents/critic.md           # sous-agent relecteur (PROCEED/RETHINK/REJECT)
│   └── skills/                    # COPIE générée de .agents/skills (gitignoré)
├── .githooks/pre-commit           # gate anti-god-code (FR) — Codex + Claude + humains
├── scripts/sync-skills.sh         # .agents/skills → .claude/skills
├── .devcontainer/                 # Codespaces : Node 22, pnpm, Codex CLI, jq, hooks, sync
├── docs/
│   ├── STACK-REFERENCE.md         # câblage prouvé (filon) + 3 pièges de couture
│   └── AGENT-CONFIG-REFERENCE.md  # où vit chaque config Codex/Claude (digest officiel)
└── SETUP.md                       # bootstrap : humain auth → agent build

Règle DRY des skills : édite toujours .agents/skills/ (source), puis sh scripts/sync-skills.sh régénère .claude/skills/. Le postCreate du devcontainer le fait automatiquement.