Skip to content

Instantly share code, notes, and snippets.

View gtko's full-sized avatar

gtko gtko

View GitHub Profile
@gtko
gtko / build-api-docs.js
Created January 21, 2026 12:46
Générateur de Documentation API Optimisée pour les LLMs
/*
Ce projet contient un script Node.js (build-api-docs.js) conçu pour transformer un fichier de spécification OpenAPI (v3) monolithique en une arborescence de documentation Markdown.
Le Problème
Les fichiers OpenAPI, bien qu'excellents pour les machines, sont souvent très volumineux. Pour un agent d'intelligence artificielle (LLM), analyser un fichier de plusieurs milliers de lignes pour
comprendre comment utiliser un seul endpoint est inefficace et coûteux en contexte. Cela ralentit sa capacité à raisonner sur l'API et à interagir avec elle de manière pertinente.
La Solution
Ce script résout ce problème en décomposant l'information en une structure de fichiers et de dossiers logique et facilement navigable, optimisée pour une exploration par une IA.
#!/usr/bin/env bash
# ============================================================
# 🔔 Claude Code Notifications - Installation Script
# ============================================================
# Installe le système de notifications macOS pour Claude Code
# Usage: curl -sL URL | bash OU ./install-notifications.sh
# ============================================================
set -euo pipefail