cto-review

Présentation de la skill cto-review

Ce que fait cto-review

cto-review est une skill de revue stratégique d’ingénierie conçue pour mettre à l’épreuve les décisions d’architecture, de passage à l’échelle, de dette technique, de recrutement et d’arbitrage build-vs-buy avant qu’elles ne deviennent des engagements coûteux. Elle repose sur le modèle de commande /cs:cto-review <plan> et pose des questions de type CTO : où le système va céder, quelle dette devient bloquante, si l’équipe peut absorber le plan, et si acheter est plus rationnel que construire.

Cas d’usage idéaux pour les décisions de Strategic Planning

La skill cto-review est surtout utile lorsque vous avez déjà un plan concret, et non une simple idée vague. Les bons cas d’usage incluent l’approbation d’une nouvelle base de données, la préparation à une multiplication du trafic par 10, la décision de reconstruire un système legacy, l’évaluation d’une migration de plateforme ou la préparation d’une revue de stratégie technique pour la direction. Elle est particulièrement pertinente pour le Strategic Planning lorsque les choix d’ingénierie ont un impact sur le budget, le recrutement, la fiabilité et le risque d’exécution à long terme.

Ce qui la distingue d’un prompt générique

Un prompt IA générique peut produire des conseils d’architecture assez larges. cto-review cadre la discussion autour de six questions de décision qui font ressortir les seuils de rupture au passage à l’échelle, le coût hebdomadaire de la dette technique, les contraintes de montée en charge de l’équipe et le coût total de possession sur trois ans. Cette structure la rend plus adaptée à une revue exécutive, à une validation d’architecture et à une analyse de risque avant engagement qu’à une séance de brainstorming ouverte.

Points importants avant adoption

Le chemin du dépôt contient un seul fichier SKILL.md pour cette skill, sans README.md, metadata.json, règles, ressources ni scripts d’assistance inclus localement dans le dossier de la skill. La source référence des scripts d’analyse via des chemins relatifs situés dans une zone plus large cto-advisor; vérifiez donc leur disponibilité dans votre environnement installé avant de vous appuyer sur ces commandes. La valeur principale de cto-review est son cadre de revue ; l’automatisation peut nécessiter une configuration supplémentaire.

Comment utiliser la skill cto-review

Installation de cto-review et vérification du dépôt

Installez-la depuis la collection de skills GitHub avec votre gestionnaire de skills, par exemple :

npx skills add alirezarezvani/claude-skills --skill cto-review

Après l’installation, ouvrez :

c-level-advisor/c-level-agents/skills/cto-review/SKILL.md

Lisez ce fichier en premier : il contient la commande, les conditions de déclenchement et les six questions CTO. Inspectez aussi le reste du dépôt si votre environnement d’agent conserve les chemins relatifs, car la skill référence des scripts situés en dehors du dossier local, comme cto-advisor/scripts/tech_debt_analyzer.py et cto-advisor/scripts/team_scaling_calculator.py.

Informations à fournir à la skill cto-review

Pour tirer le meilleur parti de cto-review, fournissez un plan avec suffisamment de détails opérationnels pour que la skill puisse challenger les hypothèses. Incluez :

• Échelle actuelle : utilisateurs, requêtes par seconde, volume de données, tenants, régions ou nombre de transactions
• Échelle cible : croissance attendue, scénario x10, événement de lancement, expansion enterprise ou échéance de migration
• Architecture : services, choix de datastores, queues, dépendances, modèle de déploiement et objectifs de fiabilité
• Contraintes : budget, taille de l’équipe, plan de recrutement, conformité, limites fournisseurs, délais et SLOs
• Décision à examiner : approuver, repousser, acheter, construire, reconstruire, migrer ou lancer une expérimentation

Entrée faible : « Review our new architecture. »

Entrée plus solide : « Use cto-review for Strategic Planning. We are moving from a monolith on PostgreSQL to event-driven services before expanding from 50k to 500k monthly active users. Current p95 API latency is 700ms during peak, writes are concentrated on one primary DB, the team has 8 engineers and plans to hire 4 more. Review scaling cliffs, tech debt cost, team ramp risk, and whether managed event streaming is better than building our own platform. »

Workflow pratique avec cto-review

Commencez par coller le plan après le format de commande utilisé par la skill :

/cs:cto-review <your plan>

Demandez une sortie orientée décision, pas une dissertation générale. Les formats de réponse utiles incluent :

• « List the top 5 approval blockers. »
• « Identify the first scaling cliff and the evidence needed to confirm it. »
• « Compare build vs buy over three years. »
• « Separate reversible experiments from irreversible commitments. »
• « Give the questions I should ask the engineering lead before approval. »

Si la première réponse est trop spéculative, ajoutez les informations manquantes plutôt que de demander au modèle de « try again ». La skill est conçue pour interroger un plan ; elle devient plus utile à mesure que vous fournissez des données réelles de charge, des estimations de coûts, des hypothèses de staffing et un historique d’incidents.

Fichiers et commandes à vérifier en premier

Le seul fichier de skill confirmé est SKILL.md. Il inclut des exemples d’appels de scripts, mais le dossier précis de cette skill ne contient pas de scripts locaux. Avant d’intégrer ces scripts à votre workflow, vérifiez si ces chemins existent après l’installation :

../../../skills/cto-advisor/scripts/tech_debt_analyzer.py

../../../skills/cto-advisor/scripts/team_scaling_calculator.py

S’ils sont absents, vous pouvez tout de même utiliser le guide cto-review manuellement en fournissant dans le prompt votre propre inventaire de dette technique et vos hypothèses de montée en charge de l’équipe.

FAQ de la skill cto-review

cto-review convient-elle aux débutants ?

Oui, si l’utilisateur a une décision d’ingénierie concrète à examiner. Ce n’est pas un tutoriel débutant sur le system design, l’architecture cloud ou le choix d’une base de données. Un fondateur junior ou un responsable produit peut l’utiliser efficacement en fournissant les objectifs business et en demandant à l’agent de traduire les risques techniques en questions de décision, mais le jugement final devrait impliquer un ingénieur expérimenté.

Quand faut-il éviter cto-review ?

N’utilisez pas cto-review pour de petits choix d’implémentation, une revue de code routinière, du grooming de tickets ou le débogage d’un défaut très ciblé. Elle est également mal adaptée lorsqu’aucun plan n’existe encore. Utilisez-la lorsque le coût d’une mauvaise décision est significatif : migration de plateforme, décision fournisseur coûteuse, investissement de passage à l’échelle, refonte de fiabilité, plan de recrutement ou proposition de reconstruction.

Comparaison avec un prompt de revue d’architecture

Un prompt de revue d’architecture vérifie souvent les design patterns, les composants et les compromis. La skill cto-review ajoute une pression de niveau exécutif : coût hebdomadaire de la dette, capacité de l’équipe à scaler, seuils de défaillance et économie du build-vs-buy. Elle est donc plus adaptée à une revue go/no-go qu’à la production ex nihilo d’une architecture de référence complète.

cto-review nécessite-t-elle les scripts référencés ?

Non. Le cœur de la skill cto-review est une méthode de revue structurée dans SKILL.md. Les scripts référencés peuvent enrichir l’analyse s’ils sont disponibles, mais la skill peut fonctionner avec de simples prompts. Considérez la prise en charge par scripts comme optionnelle tant que vous n’avez pas confirmé l’existence des fichiers dans votre installation locale.

Comment améliorer la skill cto-review

Améliorer les entrées cto-review avant de demander un avis

Le mode d’échec le plus fréquent consiste à demander une revue CTO sans chiffres. Ajoutez même des fourchettes approximatives : « current write rate is 2k/min », « expected peak is 10x after launch », « vendor quote is $180k/year » ou « team has two backend engineers with no Kafka experience ». Ces détails permettent à cto-review d’identifier de vrais seuils de rupture au passage à l’échelle plutôt que des risques génériques.

Demander les preuves manquantes, pas seulement des recommandations

Un bon guide cto-review doit vous dire ce qui doit être mesuré avant approbation. Demandez : « What evidence is missing? » ou « Which assumptions need a load test, cost model, prototype, or vendor reference call? » Cela transforme la sortie en plan d’action et réduit la fausse confiance que peuvent donner des conseils d’architecture plausibles mais non vérifiés.

Itérer avec des contraintes de décision

Après la première revue, resserrez la décision. Par exemple : « Assume we cannot hire until Q3 », « Assume downtime must stay under 30 minutes » ou « Assume build-vs-buy must be justified over three years ». Les contraintes obligent la skill à prioriser les compromis qui comptent pour la direction, plutôt que de lister toutes les préoccupations techniques possibles.

Adapter la skill à votre organisation

Pour améliorer cto-review dans un contexte d’équipe, ajoutez des checklists internes pour les SLOs, l’historique d’incidents, les seuils de coûts cloud, les fournisseurs approuvés, les exigences de sécurité et les modèles d’architecture decision record. Si vous utilisez les scripts d’analyse référencés, documentez leurs chemins et leurs entrées attendues à proximité de la skill afin que les futurs utilisateurs ne soient pas bloqués par des fichiers relatifs manquants.