Fonctionnement

Comment Reviewz transforme le volume de PR en actions humaines de review sûres.

Reviewz se place avant la review GitHub. Il observe les faits GitHub, construit des briefs de review advisory et route les humains vers la prochaine étape de vérification sûre.

Workflow

Reviewz s'insère autour de votre flow de review GitHub.

Connecter des repositories sélectionnés

Installez la GitHub App Reviewz, autorisez des repositories sélectionnés, puis activez Reviewz seulement là où vous voulez de la guidance.

Observer les faits GitHub

Reviewz lit les signaux observables de pull request : état PR, draft status, head SHA, fichiers changés, checks, branch context, stack context et signaux de policy repository disponibles.

Construire une action sûre

Chaque PR reçoit une action primaire : inspect draft, ouvrir un brief de review, vérifier dans GitHub, suivre une guidance spécialiste ou utiliser seulement le contexte historique.

Commencer avec le contexte

Reviewz montre pourquoi la PR compte, à quelle profondeur reviewer, où commencer et quelles preuves ne sont pas visibles.

Décider dans GitHub

Les humains lisent toujours le diff, commentent, marquent les fichiers comme vus, approuvent, request changes ou mergent dans GitHub.

Anatomie d'une action sûre

Ce qu'une action de review sûre contient.

Advisory · Pas une décision de merge. Exemple illustratif, pas des données client. La review finale reste dans GitHub.

PR #1842 — Review approfondie recommandée

Décision à prendre
Ce changement de session-policy peut-il être reviewé avec confiance sans couverture de régression revoked-session ?
Start here
src/auth/session_policy.ts — ce fichier porte la décision de review.
Puis vérifier
tests/auth/session_policy.test.ts — vérifier la couverture revoked-session.
GitHub confirme
La PR est ouverte.Head SHA observé.Statut CI observé.Les required checks restent finaux dans GitHub.
Reviewz infère
Le comportement auth/session a changé.Un chemin sensible est touché.La preuve de régression semble limitée.
Non visible pour Reviewz
Aucun test de régression visible ne couvre refresh token expiré + session révoquée.
Prochaine action sûre
Ouvrir la PR GitHub, reviewer d'abord le changement de session policy, puis vérifier ou demander la couverture de régression manquante.

Action recommandée

Inspect draft, ouvrir un brief de review, vérifier dans GitHub, suivre une guidance spécialiste ou utiliser seulement le contexte historique.

Pourquoi maintenant

Chemins sensibles, gros diffs, impact dépendance, signaux d'update et écarts de preuve expliquent pourquoi la PR mérite l'attention.

Profondeur de review

Quick, standard, deep, specialist, draft inspection ou vérification GitHub.

Start here

Un fichier ou une zone qui porte la décision de review, pas seulement le plus gros diff.

GitHub confirme

État ouvert, head SHA, fichiers changés, checks observés et autres faits visibles pour Reviewz.

Non visible pour Reviewz

Les écarts de preuve sont nommés comme non visibles au lieu d'être sur-affirmés.

États lifecycle

Même état, même sens, action sûre.

Guidance actuelle

Utiliser le brief Reviewz actif comme contexte reviewer, puis finir la décision dans GitHub.

Draft

Les drafts sont inspect-only. La review formelle attend que la PR soit ready for review.

Stale

Si le head change, la guidance précédente sert seulement d'orientation et le reviewer retourne dans GitHub.

Vérifier dans GitHub

Reviewz renvoie vers GitHub quand GitHub doit confirmer l'état courant.

Outside guidance

Une PR sans guidance Reviewz reste visible avec une raison et une action sûre.

Historique

Les PR fermées ou mergées peuvent fournir du contexte, mais ne sont pas des tâches de review actives.

Modèle de preuve

La preuve est séparée de l'inférence.

Faits GitHub

Les faits observés depuis GitHub restent séparés de l'interprétation Reviewz.

Inférence Reviewz

Le risque, la profondeur et le start-target sont des signaux advisory pour le reviewer.

Non visible

Reviewz dit ce qu'il ne peut pas voir au lieu d'affirmer un fait qu'il ne peut pas prouver.

Enrichissement IA

Quand l'enrichissement IA est activé, le contexte du diff PR est envoyé à Anthropic.

Fallback

Si l'enrichissement est indisponible, Reviewz revient à une guidance déterministe et rend cet état visible.

Command Palette

Sauter d'un numéro de PR, d'un repository ou d'un fichier de départ à la prochaine action sûre.

Confiance

GitHub reste final.

Fichiers et diff

GitHub reste la surface finale pour lire les fichiers changés et marquer les fichiers comme vus.

Reviews

Commentaires, approvals, request changes et décisions de merge restent dans GitHub.

Required checks

Reviewz peut observer le statut des checks, mais les required checks doivent être vérifiés dans GitHub avant décision finale.

Check Runs advisory

Les Check Runs Reviewz sont une guidance de review advisory, pas une approval ni une merge readiness.

Contrôle repository

L'autorisation GitHub et l'enablement Reviewz sont séparés. Reviewz s'exécute seulement sur les repositories que vous activez.

Aucune autorité de merge

Aucun personal access token requis. Aucun changement de code ou de branche. Aucune autorité de merge.

FAQ

FAQ workflow détaillée

Les réponses longues derrière la home plus courte.

Reviewz est-il un AI code reviewer ?

Non. Reviewz est une couche de décision de review pour humains.

Il peut utiliser l'IA pour enrichir la guidance de review, mais son rôle n'est pas d'approuver le code ni de remplacer les reviewers.

Son rôle est de dire aux reviewers quelle vérification humaine est nécessaire ensuite, où commencer et quelles preuves doivent encore être vérifiées dans GitHub.

Reviewz remplace-t-il la code review humaine ?

Non.

Reviewz prépare le chemin de review.

Les humains lisent toujours le diff, commentent, approuvent, request changes et mergent dans GitHub.

Reviewz peut-il approuver ou bloquer une pull request ?

Non.

Reviewz n'approuve pas, ne request changes pas, ne bloque pas les merges et ne revendique pas une merge readiness.

La guidance Reviewz est advisory.

Que se passe-t-il quand Reviewz est incertain ?

Reviewz rend l'incertitude visible.

Une PR peut être marquée comme nécessitant une vérification GitHub, stale guidance, outside guidance, fallback déterministe ou contexte historique.

Que se passe-t-il si une PR est draft ?

Les draft PRs sont inspect-only.

Reviewz peut aider les reviewers à comprendre le risque ou le contexte, mais ne présente pas les drafts comme prêtes pour review formelle.

Installer la GitHub App rend-il notre code public ?

Non.

Installer la GitHub App donne accès à Reviewz seulement aux repositories que vous sélectionnez. Cela ne rend pas vos repositories publics et n'expose pas le code source Reviewz.

Reviewz envoie-t-il le code à un LLM ?

Reviewz peut utiliser l'enrichissement IA pour améliorer la guidance de review quand il est activé.

Quand l'enrichissement IA est activé, le contexte du diff PR est envoyé à Anthropic.

Les faits GitHub et les garde-fous déterministes restent la couche de base.

Si l'enrichissement est indisponible, Reviewz revient à une guidance déterministe et rend cet état visible.

Peut-on commencer avec des repositories sélectionnés seulement ?

Oui.

L'autorisation GitHub et l'enablement Reviewz sont séparés.

Vous choisissez quels repositories GitHub autorise, puis quels repositories Reviewz active.

Reviewz s'exécute seulement sur les repositories que vous activez.

Et si une PR n'a pas de guidance Reviewz ?

Reviewz montre cet état au lieu de le cacher.

La PR peut apparaître sans guidance Reviewz active, stale, historique ou nécessitant une vérification GitHub, avec une action sûre vers GitHub.

Pourquoi ne pas utiliser seulement GitHub ?

GitHub reste la source de vérité et la surface finale de review.

Reviewz se place avant GitHub pour aider les reviewers à décider ce qui demande l'attention en premier, à quelle profondeur reviewer, où commencer et quelles preuves vérifier.

Que signifie Advisory ?

Advisory signifie que Reviewz fournit une guidance de review, pas une approval ni une merge readiness.

Les Check Runs Reviewz sont une guidance de review advisory.

GitHub reste la source de vérité pour checks, reviews, approvals, request changes et merge.

Demander l'accès beta