v2.0: pivot AI Code Debugger & Learning Tutor

.github/copilot-instructions.md

@@ -0,0 +1,6 @@
+# Kuro Rules - GitHub Copilot
+# DO NOT EDIT. Edit AGENTS.md instead (master: ~/Documents/kuro-rules/AGENTS.md)
+
+You MUST read AGENTS.md at the start of every session before any other action.
+AGENTS.md contains all mandatory rules (R1-R81). It is a CONTRACT, not a suggestion.
+After reading it, confirm: "I have read AGENTS.md and will enforce all rules."

.github/workflows/build.yml

@@ -9,6 +9,9 @@ jobs:
   sonarqube:
     name: SonarQube
     runs-on: windows-latest
+    # Scan non bloquant : le secret SONAR_TOKEN n'est pas configure sur ce repo.
+    # Ajoutez le secret pour rendre l'analyse bloquante.
+    continue-on-error: true
     steps:
       - uses: actions/checkout@v4
         with:

.github/workflows/kuro-compliance.yml

@@ -0,0 +1,76 @@
+# Kuro Rules Compliance — déployé automatiquement par sync-rules.ps1, NE PAS EDITER
+# Force: fraîcheur des règles (R11/R105), fichiers protégés (R76),
+# split PLAN/ROADMAP (R106), nommage de branche (R30).
+name: kuro-rules-compliance
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  compliance:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: R76/R106 - fichiers prives non tracks
+        run: |
+          FAIL=0
+          for f in PLAN.md SESSION_SUMMARY.md acquisition_tracker.md decision-memo.md LAUNCH_POSTS.md .env; do
+            if git ls-files --error-unmatch "$f" >/dev/null 2>&1; then
+              echo "::error file=$f::Fichier protege tracke (R76): git rm --cached $f"
+              FAIL=1
+            fi
+          done
+          if git ls-files --error-unmatch PLAN.md >/dev/null 2>&1; then
+            echo "::error file=PLAN.md::PLAN.md doit rester PRIVE (R106)"
+            FAIL=1
+          fi
+          exit $FAIL
+
+      - name: Regles AGENTS.md presentes et non alterees (manifest)
+        run: |
+          if [ ! -f AGENTS.md ]; then
+            echo "::error::AGENTS.md absent - lancer sync-rules.ps1 depuis kuro-rules"
+            exit 1
+          fi
+          if [ ! -f .kuro/rules-manifest.json ]; then
+            echo "::warning::Pas de manifest .kuro/rules-manifest.json - synchro ancienne, fraicheur non verifiable"
+            exit 0
+          fi
+          EXPECTED=$(python3 -c "import json;print(json.load(open('.kuro/rules-manifest.json'))['agentsSha256'])")
+          EXPECTED_COUNT=$(python3 -c "import json;print(json.load(open('.kuro/rules-manifest.json'))['ruleCount'])")
+          ACTUAL=$(sha256sum AGENTS.md | cut -d' ' -f1)
+          ACTUAL_COUNT=$(grep -c '^\- \*\*rule_' AGENTS.md || true)
+          if [ "$ACTUAL" != "$EXPECTED" ]; then
+            echo "::error::AGENTS.md a derive du dernier manifest de synchro (edition locale ou synchro manquee). Relancer sync-rules.ps1."
+            exit 1
+          fi
+          if [ "$ACTUAL_COUNT" != "$EXPECTED_COUNT" ]; then
+            echo "::error::Index de regles incoherent ($ACTUAL_COUNT vs $EXPECTED_COUNT attendues)."
+            exit 1
+          fi
+          echo "OK: $ACTUAL_COUNT regles, hash conforme au manifest."
+
+      - name: R30 - nommage de branche (PR uniquement)
+        if: github.event_name == 'pull_request'
+        run: |
+          BR="${GITHUB_HEAD_REF}"
+          if echo "$BR" | grep -qE '^(main|master|develop|feat/|fix/|infra/|ceo/|sec/|chore/|docs/|test/)'; then
+            echo "OK: branche '$BR' conforme (R30)."
+          else
+            echo "::error title=R30::Branche '$BR' viole la convention. Valides: main, master, develop, feat/*, fix/*, infra/*, ceo/*, sec/*, chore/*, docs/*, test/*"
+            exit 1
+          fi
+
+      - name: R106 - ROADMAP.md public present (avertissement)
+        run: |
+          if [ ! -f ROADMAP.md ]; then
+            echo "::warning::ROADMAP.md absent (R106) - creer un roadmap public."
+          else
+            echo "OK: ROADMAP.md present."
+          fi

.github/workflows/test.yml

@@ -0,0 +1,26 @@
+name: tests
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        node: [18, 20, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+      - run: npm install
+      - run: npm test

.gitignore

@@ -4,11 +4,14 @@ WEAKNESSES.md
 CODING.md
 IDEAS.md
 LINKEDIN.md
+PLAN.md
 
 # Protected files (Rule 10 - NEVER commit)
 mom_test_results.md
 mom_test_script.md
 decision.md
+acquisition_tracker.md
+decision-memo.md
 
 # Dependencies
 node_modules/
@@ -116,3 +119,24 @@ temp/
 Thumbs.db
 ehthumbs.db
 Desktop.ini
+
+# --- kuro-rules private research ---
+mom_test_results.md
+mom_test_script.md
+decision.md
+ideas.md
+architecture_notes.md
+concept/
+research/private/
+research/raw/
+research/interviews/
+research/contact-lists/
+research/contact-lists/
+notes-private.md
+contacts.csv
+leads.csv
+prospects.csv
+# --- end kuro-rules private research ---
+
+# Metatron project-local learning memory
+.metatron/

.kuro/rules-manifest.json

@@ -0,0 +1,6 @@
+{
+    "syncedAt":  "2026-08-26T08:44:34.9385622Z",
+    "generator":  "sync-rules.ps1",
+    "agentsSha256":  "f907386079f6db86f086e8f41af0f8582c84f144cfcfa593713ac9740e8cb9db",
+    "ruleCount":  52
+}

.windsurfrules

@@ -0,0 +1,6 @@
+# Kuro Rules - Windsurf
+# DO NOT EDIT. Edit AGENTS.md instead (master: ~/Documents/kuro-rules/AGENTS.md)
+
+You MUST read AGENTS.md at the start of every session before any other action.
+AGENTS.md contains all mandatory rules (R1-R81). It is a CONTRACT, not a suggestion.
+After reading it, confirm: "I have read AGENTS.md and will enforce all rules."