Skip to content

feat(framework): add review checklist consumed by the reviewer agent#253

Open
alexsoyes wants to merge 1 commit into
mainfrom
feat/review-checklist
Open

feat(framework): add review checklist consumed by the reviewer agent#253
alexsoyes wants to merge 1 commit into
mainfrom
feat/review-checklist

Conversation

@alexsoyes

Copy link
Copy Markdown
Contributor

🎯 What & why

Lors des reviews, les mêmes défauts reviennent (duplication d'info, incohérences, over-engineering). On ajoute une checklist personnalisable que l'agent reviewer applique automatiquement sur chaque review de code, avec un socle par défaut.

🛠️ How it works

  • Nouveau fichier aidd_docs/review-checklist.md (review-only, pas dans memory/ qui est auto-injecté partout) : socle de règles transverses + bloc ## Project-specific rules éditable.
  • L'agent reviewer (reviewer.md) charge ce fichier quand l'artefact est du code/diff, en plus du validator reçu. Fallback propre si absent ; n'altère pas le quality_score des validators YAML (specs). Les actions 01/02 restent inchangées — c'est l'agent qui porte la checklist.
  • Diffusion downstream : template livré par aidd-context:02-project-init (02-scaffold-docs.md) avec étape idempotente (préserve les règles projet au re-run), sinon le reviewer pointerait vers un fichier inexistant.

🧪 How to verify

  • test -f aidd_docs/review-checklist.md && echo ok
  • Lancer aidd-dev:05-review (01-review-code) sur un diff contenant une duplication / de l'over-engineering → le reviewer remonte ces points en findings.

⚠️ Heads-up

L'arbre de structure dans aidd_docs/README.md ne liste pas (encore) review-checklist.md — laissé hors périmètre.

✅ I certify

  • I DO CERTIFY I READ EACH LINE OF THE PULL REQUEST BECAUSE I AM A SOFTWARE ENGINEER, NOT A AI PUPPY.

🤖 Generated with Claude Code

@alexsoyes alexsoyes force-pushed the feat/review-checklist branch 4 times, most recently from 63a6cf2 to 794bd29 Compare June 7, 2026 13:51
Add aidd_docs/review-checklist.md (review-only baseline, not in memory/).

The reviewer agent loads it on code/diff reviews, alongside the validator;

02-project-init scaffolds it idempotently so downstream projects get the baseline.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: alexsoyes <contact.alexsoyes@gmail.com>
@alexsoyes alexsoyes force-pushed the feat/review-checklist branch from 794bd29 to 2e7a67d Compare June 7, 2026 14:00
@alexsoyes

Copy link
Copy Markdown
Contributor Author

@blafourcade je trouve ça over-engineered de dingue pour si peu. Tu en dis quoi ?

@blafourcade

Copy link
Copy Markdown
Contributor

@blafourcade je trouve ça over-engineered de dingue pour si peu. Tu en dis quoi ?

@alexsoyes On ajoute un nouveau document encore à maintenir, pourquoi tu as voulu ajouter ça exactement ? Tu parles de default qui reviennent mais j'ai du mal à comprendre le cas de base ?

@alexsoyes

alexsoyes commented Jun 7, 2026

Copy link
Copy Markdown
Contributor Author

@blafourcade En gros souvent on doit balancer des :

  • y'a des doublons ? des incohérences ? etc en boucle...

J'aimerais que ça se fasse en auto, surtout pour gérer la création de skill ou les doublons l'IA adore :)

@alexsoyes alexsoyes marked this pull request as ready for review June 7, 2026 21:28
@alexsoyes alexsoyes requested a review from a team as a code owner June 7, 2026 21:28
@@ -0,0 +1,11 @@
# Review Checklist

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ce fichier semble identique à ‎aidd_docs/review-checklist.md.
On a pas moyen d'en avoir qu'un seul?
S'il faut vraiment physiquement les deux on a pas moyen de scaffolder à partir d'une source plutôt que d'avoir 2 sources?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

En fait c'est le Skill actuel de Alex qui le met dans le aidd_docs justement ! @jdm-web

@blafourcade

Copy link
Copy Markdown
Contributor

@blafourcade En gros souvent on doit balancer des :

  • y'a des doublons ? des incohérences ? etc en boucle...

J'aimerais que ça se fasse en auto, surtout pour gérer la création de skill ou les doublons l'IA adore :)

Et VS le mettre dans le Prompt de l'Agent ? Trop de contenu qui risque de dilluer le context ?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants