Workflow Optimal
Semantiq ne remplace pas Glob, Grep et Read. Il les complète. Voici quand utiliser quoi.
Les compromis
| Semantiq | Outils natifs | |
|---|---|---|
| Trouve des concepts | Oui | Non |
| Support regex | Non | Oui |
| Classe les résultats | Oui (scores) | Non |
| Graphe de dépendances | Automatique | Manuel |
| Contenu complet | Non | Oui |
| Patterns glob | Non | Oui |
| Vitesse | ~45ms | ~15ms |
Aucun n'est meilleur. Ils résolvent des problèmes différents.
Guide rapide
| Tu veux... | Utilise |
|---|---|
Trouver des fichiers *.tsx | Glob |
Trouver exactement TODO: | Grep |
| Lire un fichier | Read |
| Trouver "du code lié à l'auth" | semantiq_search |
| Comprendre une fonction | semantiq_explain |
| Voir ce qui importe un fichier | semantiq_deps |
| Renommer sans casser | semantiq_find_refs |
Comparaisons d'outils
semantiq_search vs Grep
Grep gagne quand tu connais le texte exact :
Grep("TODO:") → tous les TODOs, rapidesemantiq_search gagne quand tu connais le concept :
semantiq_search("error handling")
→ trouve try/catch, error middleware, exception classesGrep aurait besoin que tu saches déjà que ces termes existent.
semantiq_explain vs Read
Read te donne tout — le fichier complet.
semantiq_explain te donne l'essentiel — signature, docs, ce qui est connecté.
Utilise explain d'abord pour voir si c'est ce que tu cherches. Puis Read si tu veux les détails.
semantiq_deps vs traçage manuel
Comprendre manuellement "ce qui dépend de ce fichier" :
- Lire le fichier
- Noter ses exports
- Grep les imports
- Répéter pour chaque match
Ou juste :
semantiq_deps("src/utils/token.ts")
→ 2 imports, 8 dépendants, terminésemantiq_find_refs vs Grep
Grep trouve tous les matchs textuels. Y compris commentaires, strings, et variables sans rapport qui ont le même nom.
semantiq_find_refs comprend le scope. Il sépare définitions et utilisations et ignore le bruit.
Workflows
Explorer du nouveau code
Tu viens de cloner un truc. Par où commencer ?
11. Glob("**/*.{ts,tsx}")2 → voir la structure342. semantiq_search("main entry point")5 → trouver où ça démarre673. semantiq_deps("src/index.ts")8 → voir ce que ça tire9104. semantiq_search("config")11 → trouver les patterns de configRefactorer en sécurité
Avant de renommer UserService :
11. semantiq_find_refs("UserService")2 → 12 refs dans 8 fichiers. ok.342. semantiq_deps("src/services/user.ts")5 → voir ce qui casse si tu y touches673. Read("src/routes/users.ts")8 → checker l'usage compliqué9104. Faire les modifs11125. semantiq_find_refs("UserServiceV2")13 → vérifier que le rename a marché partoutComprendre une feature
Comment marche l'auth ici ?
11. semantiq_search("authentication login")2 → trouve handler.ts, middleware.ts, routes.ts342. semantiq_explain("handleAuth")5 → signature, symboles liés673. semantiq_deps("src/auth/handler.ts")8 → ce qu'il utilise, ce qui l'utilise9104. Read("src/auth/handler.ts")11 → maintenant lire le codeDébugger
Quelque chose lance AuthenticationError :
11. Grep("AuthenticationError")2 → src/utils/errors.ts:23 (défini)3 → src/auth/handler.ts:45 (lancé)452. semantiq_find_refs("handleAuth")6 → voir tous les call sites783. Read("src/auth/handler.ts", lignes 40-60)9 → voir la condition exacte du throwLe pattern
1DÉCOUVRIR → COMPRENDRE2Glob, Grep semantiq_search34 ↓ ↓56 ANALYSER → LIRE7semantiq_deps Read tool8semantiq_explain910 ↓1112 REFACTORER13semantiq_find_refsOutils natifs pour la précision. Semantiq pour la compréhension. Combine les deux.
Voir aussi
- Guide d'utilisation - Exemples pratiques pour chaque outil
- Intégration MCP - Configurer avec les assistants IA