Jorgo69 · Sep 14, 2026 · Sep 14, 2026 · Sep 14, 2026 · Sep 14, 2026 · Sep 16, 2026
@@ -1,78 +1,78 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
-  "name": "aidd-framework",
+  "name": "jorgo-ai-framework",
   "version": "5.10.0",
-  "description": "Official plugin marketplace for the AI-Driven Development framework",
+  "description": "Personal fork of the AI-Driven Development framework, adapted by Jorgo69",
   "owner": {
-    "name": "AI-Driven Dev"
+    "name": "Jorgo69"
   },
   "plugins": [
     {
-      "name": "aidd-context",
-      "source": "./plugins/aidd-context",
+      "name": "jai-context",
+      "source": "./plugins/jai-context",
       "description": "Knowledge production: project bootstrap, project init, generation of context artifacts (skills, agents, rules, commands, hooks), mermaid diagrams, learn, discovery",
       "strict": true,
       "metadata": {
         "recommended": true
       }
     },
     {
-      "name": "aidd-dev",
-      "source": "./plugins/aidd-dev",
+      "name": "jai-dev",
+      "source": "./plugins/jai-dev",
       "description": "Code transformation: plan, implement, assert, audit, review, test, refactor, debug, for-sure. Hosts engineering agents.",
       "strict": true,
       "metadata": {
         "recommended": true
       }
     },
     {
-      "name": "aidd-vcs",
-      "source": "./plugins/aidd-vcs",
+      "name": "jai-vcs",
+      "source": "./plugins/jai-vcs",
       "description": "External artifacts: commit, pull-request, release-tag, issue-create",
       "strict": true,
       "metadata": {
         "recommended": true
       }
     },
     {
-      "name": "aidd-pm",
-      "source": "./plugins/aidd-pm",
+      "name": "jai-pm",
+      "source": "./plugins/jai-pm",
       "description": "Product backlog artifacts, refinement, Product Briefs, Epics, User Stories, Tasks, Spikes, Defects, requirements, and specs.",
       "strict": true,
       "metadata": {
         "recommended": true
       }
     },
     {
-      "name": "aidd-orchestrator",
-      "source": "./plugins/aidd-orchestrator",
+      "name": "jai-orchestrator",
+      "source": "./plugins/jai-orchestrator",
       "description": "Orchestration: synchronous SDLC pipeline, async issue-to-PR automation, and product backlog.",
       "strict": true,
       "metadata": {
         "recommended": true
       }
     },
     {
-      "name": "aidd-refine",
-      "source": "./plugins/aidd-refine",
+      "name": "jai-refine",
+      "source": "./plugins/jai-refine",
       "description": "Meta-cognition: refine input through brainstorming, refine output through challenge, blind-spot scanning, and fact-checking.",
       "strict": true,
       "metadata": {
         "recommended": true
       }
     },
     {
-      "name": "aidd-ui",
-      "source": "./plugins/aidd-ui",
+      "name": "jai-ui",
+      "source": "./plugins/jai-ui",
       "description": "ALPHA, not ready for use. UI and UX concern: design, review, and improve frontend interfaces.",
       "strict": true,
       "metadata": {
         "recommended": false
       }
     },
     {
-      "name": "aidd-telemetry",
-      "source": "./plugins/aidd-telemetry",
+      "name": "jai-telemetry",
+      "source": "./plugins/jai-telemetry",
       "description": "Measurement: journals every session so a unit of work can be tied to what it cost. The hooks record on plain node; its three skills reach the `aidd` CLI to turn it on, answer and check.",
       "strict": true,
       "metadata": {

@@ -13,15 +13,15 @@
     ]
   },
   "enabledPlugins": {
-    "aidd-context@aidd-framework": true,
-    "aidd-dev@aidd-framework": true,
-    "aidd-vcs@aidd-framework": true,
-    "aidd-pm@aidd-framework": true,
-    "aidd-orchestrator@aidd-framework": true,
-    "aidd-refine@aidd-framework": true
+    "jai-context@jorgo-ai-framework": true,
+    "jai-dev@jorgo-ai-framework": true,
+    "jai-vcs@jorgo-ai-framework": true,
+    "jai-pm@jorgo-ai-framework": true,
+    "jai-orchestrator@jorgo-ai-framework": true,
+    "jai-refine@jorgo-ai-framework": true
   },
   "extraKnownMarketplaces": {
-    "aidd-framework": {
+    "jorgo-ai-framework": {
       "source": {
         "source": "directory",
         "path": "."

@@ -0,0 +1,124 @@
+# Guide des commandes — jorgo-ai-framework
+
+Référence pratique de toutes les commandes disponibles, le temps de prendre le framework en main. Ce fichier vit ici, dans le fork — un seul endroit à jour, consultable depuis n'importe quel projet puisque les plugins sont installés globalement (`scope: user`).
+
+## Par où commencer
+
+Dans un projet, la toute première commande à lancer :
+
+```
+/jai-context:00-onboard
+```
+
+Elle lit le projet, explique où il en est dans le flow, et propose la prochaine étape logique — adapté aux plugins installés. À relancer à tout moment si tu ne sais plus quoi faire ensuite.
+
+Pour une feature de bout en bout sans piloter chaque étape toi-même :
+
+```
+/jai-orchestrator:01-sdlc "description de ce que tu veux livrer"
+```
+
+Elle enchaîne cadrage → plan (validation obligatoire) → implémentation → tests → commit (validation obligatoire) → revue → PR draft. Pas besoin de connaître les autres commandes pour commencer — celle-ci les orchestre pour toi.
+
+---
+
+## jai-context — connaissance du projet
+
+| Commande | Rôle | Quand l'utiliser |
+|---|---|---|
+| `/jai-context:00-onboard` | Explique où en est le projet, propose la prochaine étape | Point d'entrée, à chaque fois que tu ne sais pas par où commencer |
+| `/jai-context:01-bootstrap` | Imagine et valide l'architecture technique d'un nouveau SaaS (Q&A, comparaison de stacks, audit multi-agent, `INSTALL.md`) | Tout début d'un projet greenfield |
+| `/jai-context:02-project-memory` | Initialise/rafraîchit la mémoire du projet | Après un gros changement d'archi, ou périodiquement |
+| `/jai-context:03-context-generate` | Génère des artefacts (skills, agents, règles, commandes, hooks, plugins) | Quand tu veux créer un nouveau skill/agent perso pour ce projet |
+| `/jai-context:09-mermaid` | Génère des diagrammes Mermaid depuis du markdown | Documentation visuelle |
+| `/jai-context:10-learn` | Capture les leçons apprises (conversation ou historique git) et les route vers mémoire/décision/règle/skill | En fin de tâche, pour capitaliser |
+| `/jai-context:11-explore` | Explore le projet (tooling, contexte, code) et pointe vers ce qui correspond le mieux à un objectif | Pour se repérer dans un projet inconnu |
+| `/jai-context:12-cook` | Gère des "recettes" projet (liste, recherche, création, application) | Procédures répétitives documentées |
+
+---
+
+## jai-dev — transformation de code
+
+Pipeline typique : `plan` → `implement` → `assert` → `review`/`test` → (`refactor`/`debug` au besoin).
+
+| Commande | Rôle | Quand l'utiliser |
+|---|---|---|
+| `/jai-dev:01-plan` | Transforme une demande/ticket/fichier en plan d'implémentation phasé | Avant tout développement non trivial |
+| `/jai-dev:02-implement` | Exécute un plan phase par phase jusqu'à complétude | Après validation du plan |
+| `/jai-dev:03-assert` | Vérifie que le travail fonctionne (assertions générales, conformité archi, UI) | Après implémentation |
+| `/jai-dev:04-audit` | Audit read-only en 7 axes qualité, rapport classé | Diagnostic de dette technique |
+| `/jai-dev:05-review` | Revue d'un diff sur 3 axes : qualité code, comportement vs plan, pertinence | Avant de livrer un changement |
+| `/jai-dev:06-test` | Écrit et itère des tests jusqu'à ce qu'ils passent, ou valide un parcours utilisateur en navigateur | Ajout de couverture, validation E2E |
+| `/jai-dev:07-refactor` | Améliore le code (nettoyage, perf, sécurité, archi) | Amélioration ciblée, pas pour ajouter des tests |
+| `/jai-dev:08-debug` | Reproduit et corrige un bug via hypothèses et TDD | Bug identifié ou cause inconnue |
+| `/jai-dev:09-for-sure` | Boucle autonome jusqu'à une condition de succès vérifiable — **ne committe/pousse jamais seule**, un commit interactif unique à la fin | Tâche longue à faire "tourner" sans supervision constante |
+| `/jai-dev:10-todo` | Découpe une demande en todos indépendants, exécute en parallèle | Demandes multi-parties indépendantes |
+| `/jai-dev:11-browser-qa` | Enregistre de courtes vidéos QA d'un parcours navigateur | Preuve de non-régression visuelle |
+
+---
+
+## jai-vcs — opérations git/plateforme
+
+| Commande | Rôle | Quand l'utiliser |
+|---|---|---|
+| `/jai-vcs:00-repo-init` | Initialise un repo (git init, branche par défaut, commit bootstrap **avec confirmation**, `CONTRIBUTING.md`, remote optionnel) | Tout début d'un nouveau repo |
+| `/jai-vcs:01-commit` | Commit avec message conventionnel — **mode interactif par défaut**, confirme avant de committer | Après chaque unité de travail cohérente |
+| `/jai-vcs:02-pull-request` | Crée une PR/MR en draft depuis la branche courante | Branche prête à être revue |
+| `/jai-vcs:03-release-tag` | Tag semver annoté + notes de release — demande toujours validation avant de tagger | Moment de release |
+| `/jai-vcs:04-issue-create` | Crée une issue dans l'outil de ticketing configuré — attend toujours ton approbation avant création | Signaler un bug/besoin |
+
+---
+
+## jai-pm — gestion produit
+
+| Commande | Rôle | Quand l'utiliser |
+|---|---|---|
+| `/jai-pm:01-ticket-info` | Récupère et affiche les infos d'un ticket | Contexte rapide sur un ticket existant |
+| `/jai-pm:02-user-stories` | Découpe et affine des User Stories ordonnées | Backlog produit |
+| `/jai-pm:03-prd` | Génère un PRD structuré | Nouvelle feature majeure |
+| `/jai-pm:04-spec` | Génère/affine une spec (contrat immuable qu'un plan consomme) | Avant `/jai-dev:01-plan` sur une feature ambiguë |
+| `/jai-pm:05-spike` | Enregistre/investigue une incertitude bloquant l'estimation | Question technique ouverte |
+| `/jai-pm:06-product-brief` | Produit un Product Brief basé sur preuves | Cadrage produit |
+| `/jai-pm:07-epic` | Cadre et gère un Epic orienté résultat | Regroupement de features |
+| `/jai-pm:08-three-amigos` | Évalue un Epic/Story sous 3 angles (produit, delivery, qualité) | Avant de valider un refinement |
+| `/jai-pm:09-defect` | Enregistre, évalue, vérifie un écart produit observé | Bug côté produit (pas côté code) |
+| `/jai-pm:10-task` | Enregistre/gère une tâche technique ou fonctionnelle bornée | Travail délimité, hors Epic |
+
+---
+
+## jai-orchestrator — orchestration
+
+| Commande | Rôle | Quand l'utiliser |
+|---|---|---|
+| `/jai-orchestrator:01-sdlc` | Orchestre tout : cadrage → plan (validation) → livraison → commit (validation) → revue indépendante → PR draft | Livrer une feature de bout en bout |
+| `/jai-orchestrator:02-backlog` | Route intake/triage/refinement/lifecycle/revue sur le backlog produit | Gestion globale du backlog |
+| `/jai-orchestrator:00-async-dev` | Pipeline bot asynchrone sur issues/PR GitHub (setup/run/review) | **Non utilisé pour l'instant** — laissé de côté volontairement |
+
+---
+
+## jai-refine — méta-cognition
+
+| Commande | Rôle | Quand l'utiliser |
+|---|---|---|
+| `/jai-refine:01-brainstorm` | Clarifie une intention floue par découverte progressive | Idée pas encore assez précise pour agir |
+| `/jai-refine:02-challenge` | Recontrôle un travail déjà fait par rapport au plan validé | Après une implémentation, avant de considérer que c'est fini |
+| `/jai-refine:03-shadow-areas` | Scanne un artefact écrit pour trouver les angles morts | Relecture de spec/PRD avant validation |
+| `/jai-refine:04-fact-check` | Vérifie des affirmations factuelles contre des sources, cite ou nuance | Contenu qui cite des faits externes |
+
+---
+
+## Non installés (à la demande seulement)
+
+- `jai-ui` — alpha, un seul skill smoke-test, pas encore de vraies capacités UI/UX.
+- `jai-telemetry` — suivi coût/usage, volontairement opt-in (données personnelles).
+
+```
+claude plugin install jai-ui@jorgo-ai-framework
+claude plugin install jai-telemetry@jorgo-ai-framework
+```
+
+## Points de vigilance déjà corrigés dans ce fork
+
+- `01-sdlc` et `09-for-sure` ne committent/poussent jamais sans validation explicite (corrigé par rapport à l'original `ai-driven-dev/framework`).
+- `00-repo-init` demande confirmation même pour son commit bootstrap vide.
+- Tous les autres skills touchant à un artefact visible (PR, issue, tag) demandaient déjà confirmation nativement.
@@ -1,62 +1,44 @@
-# Contributing to the AIDD Framework
-
-## 👥 How to contribute
-
-One path, open to everyone ([roles](./GOVERNANCE.md#-roles)). 
-
-```mermaid
-flowchart LR
-    Start(["Something to share?"]) -->|"just a question"| Discussion["💬 Discussions"]
-    Start --> Bug["🐛 Bug"]
-    Start --> Quick["🌱 Quick<br/>problem + solution"]
-    Start --> Detailed["📋 Detailed<br/>scope + acceptance criteria"]
-    Bug --> Validate["✅ Get validated"]
-    Quick --> Validate
-    Detailed --> Validate
-    Validate --> Setup["🔧 Set up"] --> Changes["✏️ Changes"] --> PR["🔀 Open PR"] --> Review["🛡️ Review"] --> Merge["✅ Merged"]
-```
-
-1. Just a question? → [Discussions](https://github.com/ai-driven-dev/framework/discussions).
-2. **Open an issue** — [🐛 Bug Report](https://github.com/ai-driven-dev/framework/issues/new?template=bug_report.yml), [🌱 Quick Contribution](https://github.com/ai-driven-dev/framework/issues/new?template=quick_contribution.yml), or [📋 Detailed Contribution](https://github.com/ai-driven-dev/framework/issues/new?template=detailed_contribution.yml).
-3. **Get it validated** — a Certified Member or Maintainer moves it to `Todo`. Green light.
-4. **Want to build it yourself?** → [Set up](#-set-up). Anyone can pick up a validated issue, not just the person who opened it.
-5. **Open your PR** → [Open a pull request](#-open-a-pull-request).
+# Contributing to jorgo-ai-framework
 
-## 📜 Principles
+This is a personal fork, maintained solo by [Jorgo69](https://github.com/Jorgo69). No issue-triage team, no "Certified Member" roles, no separate `next` branch — one branch (`main`), protected, changed only through pull requests.
 
-What holds for every contribution, whatever you're building:
+## 🔀 The only path: branch → PR → merge
 
-- **No slop** — read every line before proposing it.
-- **Spend tokens like they cost something.**
-- **Claude Code syntax only** — skills, agents, and rules are authored in Claude Code syntax (the [CLI](./cli/) adapts a per-tool archive at release).
-- **Follow the skill structure** → [`ARCHITECTURE.md`](docs/ARCHITECTURE.md), use the `/aidd-context:04-skill-generate`.
-- **Evolve the memory** → [`aidd_docs/memory/`](aidd_docs/memory/).
+`main` is protected on GitHub: **no direct push, not even for the owner**. Every change, including a one-line fix, goes through this flow:
 
-## 🔧 Set up
+```bash
+# 1. Branch off main
+git checkout main && git pull
+git checkout -b fix/short-description     # or feat/, docs/, chore/...
 
-Requires **Node 22.12+**, **pnpm**, **jq**, **python3**, **pipx**.
+# 2. Work, commit normally
+git add <files>
+git commit -m "<type>(<scope>): description"   # Conventional Commits
 
-```bash
-make setup   # deps, git hooks, registers the marketplace, installs plugins into Claude + Codex
-```
+# 3. Push the branch (never main directly — GitHub will refuse it anyway)
+git push -u origin fix/short-description
 
-`make` lists every target; `make doctor` checks your environment, `make check` runs the pre-commit checks.
+# 4. Open the PR
+gh pr create --fill
 
-## ✏️ Make your change
+# 5. Merge it yourself once you're satisfied — no external approval is required
+#    (branch protection only requires a PR to exist, not a review from someone else)
+gh pr merge --squash
+```
 
-- **Follow the [Principles](#-principles).**
-- **Test locally** — run `make reload`, restart your session(s). Test in Claude *and* one other tool (e.g. Codex).
-- **Commit** — `<type>(<scope>): description`, one scope per commit → [convention](aidd_docs/memory/vcs.md#commits).
+`--squash` keeps `main`'s history at one commit per PR. Use `--merge` instead if you want every commit preserved.
 
-## 🔀 Open a pull request
+## 📜 Principles
 
-- **Branch off `next`, target `next`** → [routing table](aidd_docs/memory/vcs.md#branches).
-- **Fill the [PR template](.github/PULL_REQUEST_TEMPLATE.md)** — what changed, how you solved it.
-- **A Maintainer review gates every merge** → [`GOVERNANCE.md`](./GOVERNANCE.md#-code-decisions).
+- **No slop** — read every line before proposing it.
+- **Spend tokens like they cost something.**
+- **Claude Code syntax only** — skills, agents, and rules are authored in Claude Code syntax.
+- **Follow the skill structure** → [`ARCHITECTURE.md`](docs/ARCHITECTURE.md), use `/jai-context:04-skill-generate` to scaffold a new one.
+- **One concern per commit** — Conventional Commits format, imperative mood.
 
 ## 📚 Reference
 
-[`ARCHITECTURE.md`](docs/ARCHITECTURE.md) · [`CREATE_PLUGIN.md`](docs/CREATE_PLUGIN.md) · [`GLOSSARY.md`](docs/GLOSSARY.md)
+[`ARCHITECTURE.md`](docs/ARCHITECTURE.md) · [`CREATE_PLUGIN.md`](docs/CREATE_PLUGIN.md) · [`GLOSSARY.md`](docs/GLOSSARY.md) · [`COMMANDS.md`](COMMANDS.md) — quick reference for every `jai-*` skill.
 
 ---
 

@@ -1,6 +1,7 @@
 MIT License
 
 Copyright (c) 2026 AI-Driven Dev contributors
+Copyright (c) 2026 Jorgo69 (jorgo-ai-framework, fork and adaptation)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal