Our review

This skill automatically explores a codebase to understand existing patterns related to a feature, launching parallel agents without user interaction.

Strengths

Fully automated exploration phase requiring no user interaction
Parallel analysis with 2-3 specialized agents covering different aspects (similar features, architecture, integrations)
Structured consolidation of results and workflow state updates

Limitations

Requires a pre-existing workflow state file to be present
Depends on the quality of underlying exploration agents
Does not handle cases where exploration requires human decisions

When to use it

When you need to quickly and reproducibly analyze a codebase to understand patterns and key files before implementing a new feature.

When not to use it

When exploration requires creative choices or contextual understanding that agents cannot provide, or when the codebase is too small to justify automated exploration.

Examples

Explore codebase for user authentication feature

Run dev:auto:explore for feature 'user authentication' in the current codebase, using the existing workflow state from issue #42.

Analyze patterns for payment integration

Execute the automated code exploration workflow for feature 'payment integration', focusing on finding similar features and mapping the architecture.

Discover integration points for notification system

Launch the auto-explore skill for feature 'notification system', with emphasis on integration points and event communication patterns.

name: dev:auto:explore description: Explorer le codebase automatiquement - Mode AUTO (Phase 2) model: sonnet allowed-tools:

Task
Read
Glob
Grep output-style: bullet-points version: 1.0.0 license: MIT

Objectif

Instructions à Exécuter

IMPORTANT : Exécute ce workflow étape par étape :

Phase 2 du workflow automatisé : explorer le codebase pour comprendre les patterns existants SANS interaction.

Instructions

1. Lire le contexte

Déterminer le chemin du workflow state :

workflow_state_file=".claude/data/workflows/issue-${issue_number}-dev-workflow-state.json"

Lire le workflow state pour connaître la feature en cours
Si le fichier n'existe pas, exit avec erreur code 1

2. Lancer les agents d'exploration

Lancer 2-3 agents code-explorer en parallèle avec des focus différents :

Agent 1 : Features similaires

Trouve des features similaires à "{feature}" dans le codebase.
Trace leur implémentation de bout en bout.
Retourne les 5-10 fichiers clés à lire.

Agent 2 : Architecture

Mappe l'architecture et les abstractions pour la zone concernée par "{feature}".
Identifie les patterns utilisés (repositories, services, events, etc.).
Retourne les 5-10 fichiers clés à lire.

Agent 3 : Intégrations (si pertinent)

Analyse les points d'intégration existants (APIs, events, commands).
Identifie comment les features communiquent entre elles.
Retourne les 5-10 fichiers clés à lire.

3. Consolider les résultats

Fusionner les listes de fichiers identifiés
Lire les fichiers clés pour construire une compréhension profonde
Identifier les patterns récurrents

4. Mettre à jour le workflow state

{
  "currentPhase": 2,
  "phases": {
    "2": {
      "status": "completed",
      "completedAt": "{ISO timestamp}",
      "durationMs": {durée},
      "keyFiles": ["{liste des fichiers clés}"],
      "patterns": ["{patterns identifiés}"],
      "findings": "{résumé des découvertes}"
    }
  }
}

Règles

✅ Mode automatique : aucune interaction
✅ Lancer agents en parallèle si disponibles
✅ Documenter les patterns trouvés
❌ Jamais demander confirmation (exit 1 si erreur, continuer sinon)
✅ Consolider les résultats pour Phase 3

Automated codebase exploration

Recommended for