Communitygithub.com

JahacksV1/day-one-agent-kit

Comprenez un dépôt rapidement sans en modifier l'architecture. À utiliser pour démarrer dans un dépôt inconnu, intégrer le code d'un client, ou créer une base de profil / stack.

Qu'est-ce que day-one-agent-kit ?

Cet agent est conçu pour analyser un dépôt de code inconnu et produire un profil concis, factuel et exploitable, sans toucher au code existant ni modifier l'architecture. L'agent inspecte les fichiers de configuration, les points d'entrée, les scripts, les dépendances et les patterns d'architecture pour cartographier les zones principales (frontend, backend, base de données, auth, IA, déploiement). Il identifie l'utilisation des variables d'environnement, les risques de production et les éléments manquants. Le résultat est un fichier `.ai/PROJECT_PROFILE.md` basé sur un template, qui sert de référence rapide pour le développeur ou l'équipe. L'outil est particulièrement utile pour l'onboarding sur un nouveau projet, la revue de code client, ou la création d'une ligne de base technique. Il suit une règle stricte de ne pas inventer d'information : si une zone n'est pas présente (ex. pas d'auth), elle est simplement marquée comme « Non applicable ».

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JahacksV1/day-one-agent-kit/tree/HEAD/skills/intake-repo

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Intake Repo

Utilisez ce workflow pour comprendre rapidement un dépôt avant de commencer l'implémentation.

Objectif

Produire un profil de dépôt court et factuel, incluant les risques et les prochaines étapes.

Résultat

  • .ai/PROJECT_PROFILE.md généré à partir de templates/PROJECT_PROFILE.md.

Règles

  • Ne modifiez pas le code produit.
  • Ne réécrivez pas l'architecture.
  • Préférez les patterns de code observés aux suppositions.
  • Gardez le profil concis et exploitable.
  • « Non applicable » est une réponse valide et attendue pour une zone principale. Par exemple, un site statique/portfolio sans backend n'a pas d'auth, de base de données ou de logique IA à renseigner. Marquez-la comme Non applicable plutôt que d'inventer du contenu, de deviner un besoin futur ou de la laisser vide/ambiguë.

Étapes

  1. Détecter le framework, le langage, le gestionnaire de paquets et la cible de déploiement.
  2. Lire les fichiers package/lock/config et les points d'entrée majeurs.
  3. Identifier les scripts disponibles : dev, typecheck, lint, test, build.
  4. Cartographier les zones : frontend, backend, base de données, auth, IA, déploiement.
  5. Identifier les patterns d'utilisation des variables d'environnement.
  6. Capturer les patterns d'architecture actuellement utilisés dans le code.
  7. Lister les éléments de production de base manquants évidents et les risques clés.
  8. Générer ou mettre à jour .ai/PROJECT_PROFILE.md.

Preuves minimales

Citez des fichiers concrets pour chaque constat. Exemples de catégories :

  • source des scripts (package.json, pyproject.toml, etc.)
  • source de déploiement (vercel.json, Docker, workflows CI)
  • source d'utilisation des variables d'environnement (process.env, NEXT_PUBLIC_, etc.)
  • limites d'auth/données (middleware, route handlers, fichiers de règle)

Vérification de fin

  • Le profil inclut la stack détectée, les scripts, les zones principales, les patterns, les risques.
  • Le résultat est suffisamment court pour être utile pendant les tâches de codage normales.

Skills associés