From 86b01563fc02b518625012138b4dc2193e340d94 Mon Sep 17 00:00:00 2001
From: Nicolas Cantu <nicolas.cantu@pm.me>
Date: Thu, 28 Aug 2025 11:23:38 +0200
Subject: [PATCH] =?UTF-8?q?[skip=20ci]=20chore(ci):=20CI=5FSKIP=20par=20d?=
 =?UTF-8?q?=C3=A9faut=20et=20documentation=20mise=20=C3=A0=20jour?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitea/workflows/ci.yml        | 20 +++++++++++++++++---
 docs/project/AGENTS_RUNTIME.md |  1 +
 docs/project/CONFIGURATION.md  |  4 ++++
 3 files changed, 22 insertions(+), 3 deletions(-)

diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
index bd5f628..1787dce 100644
--- a/.gitea/workflows/ci.yml
+++ b/.gitea/workflows/ci.yml
@@ -11,12 +11,14 @@ on:
 env:
   RUST_VERSION: '1.70'
   DOCKER_COMPOSE_VERSION: '2.20.0'
+  CI_SKIP: 'true'
 
 jobs:
   # Job de vérification du code
   code-quality:
     name: Code Quality
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     steps:
     - name: Checkout code
@@ -65,6 +67,7 @@ jobs:
   unit-tests:
     name: Unit Tests
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     steps:
     - name: Checkout code
@@ -101,6 +104,7 @@ jobs:
   integration-tests:
     name: Integration Tests
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     services:
       docker:
@@ -148,6 +152,7 @@ jobs:
   security-tests:
     name: Security Tests
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     steps:
     - name: Checkout code
@@ -185,6 +190,7 @@ jobs:
   docker-build:
     name: Docker Build & Test
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     services:
       docker:
@@ -228,6 +234,7 @@ jobs:
   documentation-tests:
     name: Documentation Tests
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     steps:
     - name: Checkout code
@@ -243,6 +250,7 @@ jobs:
   markdownlint:
     name: Markdown Lint
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
     steps:
       - name: Checkout code
         uses: actions/checkout@v3
@@ -273,6 +281,7 @@ jobs:
   bash-required:
     name: Bash Requirement
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
     steps:
       - name: Checkout code
         uses: actions/checkout@v3
@@ -290,6 +299,7 @@ jobs:
   agents-smoke:
     name: Agents Smoke (no AI)
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
     steps:
       - name: Checkout code
         uses: actions/checkout@v3
@@ -310,7 +320,7 @@ jobs:
   openia-agents:
     name: Agents with OpenIA
     runs-on: [self-hosted, linux]
-    if: ${{ secrets.OPENAI_API_KEY != '' }}
+    if: ${{ env.CI_SKIP != 'true' && secrets.OPENAI_API_KEY != '' }}
     env:
       OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
       OPENAI_MODEL: ${{ vars.OPENAI_MODEL }}
@@ -334,6 +344,7 @@ jobs:
   deployment-checks:
     name: Deployment Checks
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
     steps:
       - name: Checkout code
         uses: actions/checkout@v3
@@ -351,6 +362,7 @@ jobs:
   security-audit:
     name: Security Audit
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
     steps:
       - name: Checkout code
         uses: actions/checkout@v3
@@ -370,6 +382,7 @@ jobs:
     name: Release Guard
     runs-on: [self-hosted, linux]
     needs: [code-quality, unit-tests, documentation-tests, markdownlint, security-audit, deployment-checks, bash-required]
+    if: ${{ env.CI_SKIP != 'true' }}
     steps:
     - name: Checkout code
       uses: actions/checkout@v3
@@ -401,7 +414,7 @@ jobs:
     name: Create Release (Gitea API)
     runs-on: ubuntu-latest
     needs: [release-guard]
-    if: startsWith(github.ref, 'refs/tags/')
+    if: ${{ env.CI_SKIP != 'true' && startsWith(github.ref, 'refs/tags/') }}
     env:
       RELEASE_TOKEN: ${{ secrets.RELEASE_TOKEN }}
       BASE_URL: ${{ vars.BASE_URL }}
@@ -431,6 +444,7 @@ jobs:
   performance-tests:
     name: Performance Tests
     runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     steps:
     - name: Checkout code
@@ -457,7 +471,7 @@ jobs:
     name: Notify
     runs-on: [self-hosted, linux]
     needs: [code-quality, unit-tests, integration-tests, security-tests, docker-build, documentation-tests]
-    if: always()
+    if: ${{ env.CI_SKIP != 'true' && always() }}
 
     steps:
     - name: Notify success
diff --git a/docs/project/AGENTS_RUNTIME.md b/docs/project/AGENTS_RUNTIME.md
index f63c5d7..94ec9b4 100644
--- a/docs/project/AGENTS_RUNTIME.md
+++ b/docs/project/AGENTS_RUNTIME.md
@@ -77,3 +77,4 @@ Ce guide décrit comment utiliser et intégrer les agents de conformité (qualit
 - Exécuter les agents avant chaque PR
 - Archiver les rapports significatifs
 - Documenter les décisions dans le changelog et la doc
+- Si contrôle local complet: activer `CI_SKIP=true` côté dépôt pour ne pas consommer la CI; ajouter au besoin `[skip ci]` dans les commits automatisés
diff --git a/docs/project/CONFIGURATION.md b/docs/project/CONFIGURATION.md
index 543ba0c..366ffcc 100644
--- a/docs/project/CONFIGURATION.md
+++ b/docs/project/CONFIGURATION.md
@@ -9,6 +9,10 @@
 - **Runner unifié**:
   - `RUNNER_MODE` = `agents` | `runner` | `both` (par défaut: `agents`)
   - `REGISTRATION_TOKEN` (requis si `RUNNER_MODE=runner` ou `both` sans config existante)
+- **Flag de gel CI**:
+  - `CI_SKIP` (défaut `true` dans le template): quand `true`, les jobs CI sont court‑circuités
+  - Définir à `false` pour réactiver la CI côté dépôt
+  - Alternative ponctuelle: commit message `[skip ci]`
 
 ## Variables d’environnement (agents)