npm - @atlashub/smartstack-cli - Versions diffs - 4.80.0 → 5.0.0 - Mend

@atlashub/smartstack-cli 4.80.0 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1008) hide show

package/.documentation/ralph-loop.html CHANGED Viewed

@@ -1,35 +1,29 @@
 <!DOCTYPE html>
+<!--
+  AUTO-GENERATED by scripts/generate-docs — do not edit by hand.
+  Edit docs-src/ralph-loop.md (or templates/skills/<skill>/SKILL.md for skill data)
+  and run `npm run build:docs`. CI enforces drift via `npm run docs:check`.
+-->
 <html lang="fr">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Ralph Loop - SmartStack CLI</title>
+    <title>Ralph Loop — boucle de développement itératif - SmartStack CLI</title>
     <link rel="stylesheet" href="css/styles.css">
 </head>
 <body>
     <div class="app-container">
-        <!-- Global Header -->
+        <!-- Global Header (single unified element) -->
         <header class="global-header">
             <div class="logo">SS</div>
             <span class="site-title">SmartStack CLI</span>
-            <span class="version-badge">v3.34.0</span>
+            <span class="version-badge">v5.0.0</span>
             <div class="header-divider"></div>
             <span class="page-title">Ralph Loop</span>
-            <nav class="breadcrumb">
-                <a href="index.html">
-                    <span data-lang="fr">Accueil</span>
-                    <span data-lang="en">Home</span>
-                </a>
-                <span class="breadcrumb-separator">&#8250;</span>
-                <span data-lang="fr">Workflows</span>
-                <span data-lang="en">Workflows</span>
-                <span class="breadcrumb-separator">&#8250;</span>
-                <span class="breadcrumb-current">Ralph Loop</span>
-            </nav>
             <!-- Language Select -->
             <select class="lang-select" id="lang-select" onchange="setLanguage(this.value); localStorage.setItem('doc-language', this.value);">
-                <option value="fr">FR</option>
-                <option value="en">EN</option>
+                <option value="fr">🇫🇷 FR</option>
+                <option value="en">🇬🇧 EN</option>
             </select>
             <!-- Search -->
             <div class="header-search">
@@ -42,640 +36,149 @@
             </div>
         </header>
-        <!-- App Body -->
         <div class="app-body">
             <!-- Sidebar -->
             <aside class="sidebar">
                 <button class="sidebar-toggle" title="Toggle sidebar">
-                    <span class="toggle-icon-collapse">&#171;</span>
-                    <span class="toggle-icon-expand">&#187;</span>
+                    <span class="toggle-icon-collapse">«</span>
+                    <span class="toggle-icon-expand">»</span>
                 </button>
                 <nav class="sidebar-nav">
                 <div class="nav-section">
                     <div class="nav-section-title">
-                        <span data-lang="fr">Demarrage</span>
-                        <span data-lang="en">Getting Started</span>
+<span data-lang="fr">Démarrage</span><span data-lang="en">Getting Started</span>
                     </div>
                     <a href="index.html" class="nav-item">
-                        <span class="icon">&#127968;</span>
-                        <span class="nav-text" data-lang="fr">Accueil</span>
-                        <span class="nav-text" data-lang="en">Home</span>
+                        <span class="icon">🏠</span>
+<span class="nav-text" data-lang="fr">Accueil</span><span class="nav-text" data-lang="en">Home</span>
                     </a>
                     <a href="installation.html" class="nav-item">
-                        <span class="icon">&#128230;</span>
-                        <span class="nav-text">Installation</span>
-                    </a>
-                    <a href="license.html" class="nav-item">
-                        <span class="icon">&#128274;</span>
-                        <span class="nav-text" data-lang="fr">Licence</span>
-                        <span class="nav-text" data-lang="en">License</span>
+                        <span class="icon">📦</span>
+<span class="nav-text" data-lang="fr">Installation</span><span class="nav-text" data-lang="en">Installation</span>
                     </a>
                     <a href="init.html" class="nav-item">
-                        <span class="icon">&#128640;</span>
-                        <span class="nav-text">Projet Client</span>
+                        <span class="icon">🚀</span>
+<span class="nav-text" data-lang="fr">Projet Client</span><span class="nav-text" data-lang="en">Client Project</span>
+                    </a>
+                    <a href="license.html" class="nav-item">
+                        <span class="icon">🔐</span>
+<span class="nav-text" data-lang="fr">Licence</span><span class="nav-text" data-lang="en">License</span>
                     </a>
                 </div>
                 <div class="nav-section">
-                    <div class="nav-section-title">Workflows</div>
+                    <div class="nav-section-title">
+<span data-lang="fr">Workflows</span><span data-lang="en">Workflows</span>
+                    </div>
                     <a href="gitflow.html" class="nav-item">
-                        <span class="icon">&#128256;</span>
-                        <span class="nav-text">GitFlow</span>
+                        <span class="icon">🔀</span>
+<span class="nav-text" data-lang="fr">GitFlow</span><span class="nav-text" data-lang="en">GitFlow</span>
                     </a>
                     <a href="efcore.html" class="nav-item">
-                        <span class="icon">&#128452;</span>
-                        <span class="nav-text">EF Core</span>
+                        <span class="icon">🗄️</span>
+<span class="nav-text" data-lang="fr">EF Core</span><span class="nav-text" data-lang="en">EF Core</span>
                     </a>
                     <a href="business-analyse.html" class="nav-item">
-                        <span class="icon">&#128202;</span>
-                        <span class="nav-text">Business Analyse</span>
+                        <span class="icon">📊</span>
+<span class="nav-text" data-lang="fr">Business Analyse</span><span class="nav-text" data-lang="en">Business Analysis</span>
                     </a>
-                    <div class="nav-item-with-toc">
-                        <a href="ralph-loop.html" class="active">
-                            <span class="icon">&#128260;</span>
-                            <span class="nav-text">Ralph Loop</span>
-                            <button class="toc-toggle">&#9654;</button>
-                        </a>
-                        <nav class="sidebar-toc">
-                            <a href="#introduction" class="sidebar-toc-link">Introduction</a>
-                            <a href="#architecture" class="sidebar-toc-link">
-                                <span data-lang="fr">Architecture</span>
-                                <span data-lang="en">Architecture</span>
-                            </a>
-                            <a href="#commands" class="sidebar-toc-link">
-                                <span data-lang="fr">Commandes</span>
-                                <span data-lang="en">Commands</span>
-                            </a>
-                            <a href="#workflow" class="sidebar-toc-link">
-                                <span data-lang="fr">Workflow</span>
-                                <span data-lang="en">Workflow</span>
-                            </a>
-                            <a href="#file-structure" class="sidebar-toc-link">File Structure</a>
-                            <a href="#when-to-use" class="sidebar-toc-link">
-                                <span data-lang="fr">Quand utiliser</span>
-                                <span data-lang="en">When to use</span>
-                            </a>
-                        </nav>
-                    </div>
-                    <a href="apex.html" class="nav-item">
-                        <span class="icon">&#9881;</span>
-                        <span class="nav-text">APEX</span>
+                    <a href="ba-develop.html" class="nav-item nav-item-child">
+                        <span class="icon">⚙️</span>
+<span class="nav-text" data-lang="fr">BA Develop</span><span class="nav-text" data-lang="en">BA Develop</span>
+                    </a>
+                    <a href="ralph-loop.html" class="nav-item active">
+                        <span class="icon">🔄</span>
+<span class="nav-text" data-lang="fr">Ralph Loop</span><span class="nav-text" data-lang="en">Ralph Loop</span>
                     </a>
                 </div>
                 <div class="nav-section">
                     <div class="nav-section-title">
-                        <span data-lang="fr">Outils</span>
-                        <span data-lang="en">Tools</span>
+<span data-lang="fr">Annuaire</span><span data-lang="en">Directory</span>
                     </div>
+                    <a href="commands.html" class="nav-item">
+                        <span class="icon">⚡</span>
+<span class="nav-text" data-lang="fr">Commandes Claude</span><span class="nav-text" data-lang="en">Claude Commands</span>
+                    </a>
                     <a href="cli-commands.html" class="nav-item">
-                        <span class="icon">&#128187;</span>
-                        <span class="nav-text" data-lang="fr">CLI SmartStack</span>
-                        <span class="nav-text" data-lang="en">SmartStack CLI</span>
+                        <span class="icon">💻</span>
+<span class="nav-text" data-lang="fr">CLI SmartStack</span><span class="nav-text" data-lang="en">SmartStack CLI</span>
                     </a>
-                    <a href="agents.html" class="nav-item">
-                        <span class="icon">&#129302;</span>
-                        <span class="nav-text">Agents</span>
+                    <a href="ba-skills.html" class="nav-item">
+                        <span class="icon">📋</span>
+<span class="nav-text" data-lang="fr">Skills BA</span><span class="nav-text" data-lang="en">BA Skills</span>
                     </a>
-                    <a href="commands.html" class="nav-item">
-                        <span class="icon">&#9889;</span>
-                        <span class="nav-text" data-lang="fr">Commandes Claude</span>
-                        <span class="nav-text" data-lang="en">Claude Commands</span>
+                    <a href="agents.html" class="nav-item">
+                        <span class="icon">🤖</span>
+<span class="nav-text" data-lang="fr">Agents</span><span class="nav-text" data-lang="en">Agents</span>
                     </a>
                     <a href="hooks.html" class="nav-item">
-                        <span class="icon">&#128279;</span>
-                        <span class="nav-text">Hooks</span>
-                    </a>
-                    <a href="test-web.html" class="nav-item">
-                        <span class="icon">&#127760;</span>
-                        <span class="nav-text">Test Web</span>
+                        <span class="icon">🔗</span>
+<span class="nav-text" data-lang="fr">Hooks</span><span class="nav-text" data-lang="en">Hooks</span>
                     </a>
                 </div>
             </nav>
             </aside>
-            <!-- Main Content -->
             <main class="main-content">
-                <div class="content-full">
-                    <!-- Introduction -->
-                    <section id="introduction">
-                        <h2>Introduction</h2>
-                        <p data-lang="fr">
-                            <strong>Ralph Loop</strong> est un orchestrateur pur qui pilote le processus de developpement iteratif depuis des specifications (PRDs) jusqu'a la livraison du code.
-                        </p>
-                        <p data-lang="en">
-                            <strong>Ralph Loop</strong> is a pure orchestrator that drives iterative development from specifications (PRDs) to code delivery.
-                        </p>
-                        <div class="alert alert-info">
-                            <span class="alert-icon">&#128260;</span>
-                            <div class="alert-content">
-                                <h5 data-lang="fr">Architecture de delegation</h5>
-                                <h5 data-lang="en">Delegation Architecture</h5>
-                                <p data-lang="fr">
-                                    Ralph Load ne genere JAMAIS du code. Il:
-                                </p>
-                                <p data-lang="en">
-                                    Ralph Loop NEVER generates code. It:
-                                </p>
-                                <ul style="margin-top: 10px;">
-                                    <li data-lang="fr">Lit les PRDs depuis le handoff Business Analyse</li>
-                                    <li data-lang="en">Reads PRDs from Business Analyse handoff</li>
-                                    <li data-lang="fr">Resout les dependances et ordonne les modules</li>
-                                    <li data-lang="en">Resolves dependencies and module ordering</li>
-                                    <li data-lang="fr">Delegue TOUT generation de code a `/apex -d`</li>
-                                    <li data-lang="en">Delegates ALL code generation to `/apex -d`</li>
-                                    <li data-lang="fr">Suit la progression, valide les resultats, genere des rapports</li>
-                                    <li data-lang="en">Tracks progress, validates results, generates reports</li>
-                                </ul>
-                            </div>
-                        </div>
-                        <div class="alert alert-success">
-                            <span class="alert-icon">&#128160;</span>
-                            <div class="alert-content">
-                                <h5 data-lang="fr">Execution garantie</h5>
-                                <h5 data-lang="en">Execution Guarantee</h5>
-                                <p data-lang="fr">
-                                    Ralph Loop execute TOUTES les taches du debut a la fin sans interaction utilisateur. Il s'arrete seulement quand: toutes les taches sont completes, le max d'iterations est atteint, une impasse, ou Ctrl+C.
-                                </p>
-                                <p data-lang="en">
-                                    Ralph Loop executes ALL tasks from start to finish with no user interaction. It stops only when: all tasks complete, max iterations reached, dead-end, or Ctrl+C.
-                                </p>
-                            </div>
-                        </div>
-                    </section>
-                    <!-- Architecture -->
-                    <section id="architecture">
-                        <h2>
-                            <span data-lang="fr">Architecture</span>
-                            <span data-lang="en">Architecture</span>
-                        </h2>
-                        <h4 data-lang="fr">6 Etapes</h4>
-                        <h4 data-lang="en">6 Steps</h4>
-                        <div class="table-container">
-                            <table class="reference-table">
-                                <thead>
-                                    <tr>
-                                        <th data-lang="fr">Etape</th>
-                                        <th data-lang="en">Step</th>
-                                        <th data-lang="fr">Description</th>
-                                        <th data-lang="en">Description</th>
-                                    </tr>
-                                </thead>
-                                <tbody>
-                                    <tr>
-                                        <td><strong>00 - Init</strong></td>
-                                        <td><strong>00 - Init</strong></td>
-                                        <td data-lang="fr">Parse args (-m N, -c TEXT, -v, -r), verifie MCP, setup .ralph/, detecte multi-module</td>
-                                        <td data-lang="en">Parse args (-m N, -c TEXT, -v, -r), verify MCP, setup .ralph/, detect multi-module</td>
-                                    </tr>
-                                    <tr>
-                                        <td><strong>01 - Task Loading</strong></td>
-                                        <td><strong>01 - Task Loading</strong></td>
-                                        <td data-lang="fr">Charge/cree les taches depuis prd.json (format v3 unifie avec pre-calcul des taches)</td>
-                                        <td data-lang="en">Load/create tasks from prd.json (unified v3 format with pre-computed tasks)</td>
-                                    </tr>
-                                    <tr>
-                                        <td><strong>02 - Execute</strong></td>
-                                        <td><strong>02 - Execute</strong></td>
-                                        <td data-lang="fr">Delegue le module a `/apex -d .ralph/prd.json` (mode delegation)</td>
-                                        <td data-lang="en">Delegate module to `/apex -d .ralph/prd.json` (delegate mode)</td>
-                                    </tr>
-                                    <tr>
-                                        <td><strong>03 - Commit</strong></td>
-                                        <td><strong>03 - Commit</strong></td>
-                                        <td data-lang="fr">Valide changements, commit git, update prd.json/progress.txt</td>
-                                        <td data-lang="en">Validate changes, git commit, update prd.json/progress.txt</td>
-                                    </tr>
-                                    <tr>
-                                        <td><strong>04 - Check</strong></td>
-                                        <td><strong>04 - Check</strong></td>
-                                        <td data-lang="fr">Verifie completion, entre en COMPACT LOOP (voir compact-loop.md)</td>
-                                        <td data-lang="en">Check completion, enter COMPACT LOOP (see compact-loop.md)</td>
-                                    </tr>
-                                    <tr>
-                                        <td><strong>05 - Report</strong></td>
-                                        <td><strong>05 - Report</strong></td>
-                                        <td data-lang="fr">Genere rapports finaux dans .ralph/reports/</td>
-                                        <td data-lang="en">Generate final reports in .ralph/reports/</td>
-                                    </tr>
-                                </tbody>
-                            </table>
-                        </div>
-                        <h4 data-lang="fr">Delegation flow</h4>
-                        <h4 data-lang="en">Delegation flow</h4>
-                        <div class="svg-diagram">
-                            <svg viewBox="0 0 700 350" xmlns="http://www.w3.org/2000/svg" style="font-family: 'Inter', system-ui, sans-serif;">
-                                <defs>
-                                    <marker id="arrowFlow" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
-                                        <polygon points="0 0, 10 3.5, 0 7" fill="#3b82f6"/>
-                                    </marker>
-                                    <marker id="arrowApex" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
-                                        <polygon points="0 0, 10 3.5, 0 7" fill="#8b5cf6"/>
-                                    </marker>
-                                </defs>
-                                <!-- Ralph Loop Box -->
-                                <rect x="20" y="50" width="160" height="250" rx="8" fill="#f0f9ff" stroke="#3b82f6" stroke-width="2" stroke-dasharray="5,5"/>
-                                <text x="100" y="75" text-anchor="middle" fill="#1e40af" font-size="13" font-weight="700">Ralph Loop</text>
-                                <text x="100" y="92" text-anchor="middle" fill="#1e40af" font-size="11">(Orchestrator)</text>
-                                <!-- Ralph steps -->
-                                <rect x="30" y="105" width="140" height="35" rx="4" fill="#dbeafe" stroke="#3b82f6" stroke-width="1"/>
-                                <text x="100" y="128" text-anchor="middle" fill="#0c4a6e" font-size="10" font-weight="600">00 Init / 01 Load</text>
-                                <rect x="30" y="150" width="140" height="35" rx="4" fill="#dbeafe" stroke="#3b82f6" stroke-width="1"/>
-                                <text x="100" y="173" text-anchor="middle" fill="#0c4a6e" font-size="10" font-weight="600">03 Commit PRD</text>
-                                <rect x="30" y="195" width="140" height="35" rx="4" fill="#dbeafe" stroke="#3b82f6" stroke-width="1"/>
-                                <text x="100" y="218" text-anchor="middle" fill="#0c4a6e" font-size="10" font-weight="600">04 Check / 05 Report</text>
-                                <!-- Arrow Ralph -> Apex -->
-                                <path d="M170,125 L280,160" fill="none" stroke="#3b82f6" stroke-width="2.5" marker-end="url(#arrowFlow)"/>
-                                <text x="210" y="135" fill="#3b82f6" font-size="10" font-weight="600">/apex -d</text>
-                                <!-- Arrow Apex -> Ralph -->
-                                <path d="M280,210 L170,185" fill="none" stroke="#8b5cf6" stroke-width="2.5" marker-end="url(#arrowApex)"/>
-                                <text x="210" y="200" fill="#8b5cf6" font-size="10" font-weight="600">PRD state</text>
-                                <!-- Apex Box -->
-                                <rect x="280" y="70" width="160" height="230" rx="8" fill="#faf5ff" stroke="#8b5cf6" stroke-width="2" stroke-dasharray="5,5"/>
-                                <text x="360" y="95" text-anchor="middle" fill="#6b21a8" font-size="13" font-weight="700">APEX</text>
-                                <text x="360" y="112" text-anchor="middle" fill="#6b21a8" font-size="11">(Executor)</text>
-                                <!-- Apex steps -->
-                                <rect x="290" y="125" width="140" height="35" rx="4" fill="#e9d5ff" stroke="#8b5cf6" stroke-width="1"/>
-                                <text x="360" y="148" text-anchor="middle" fill="#4c1d95" font-size="10" font-weight="600">Analysis + Planning</text>
-                                <rect x="290" y="170" width="140" height="35" rx="4" fill="#e9d5ff" stroke="#8b5cf6" stroke-width="1"/>
-                                <text x="360" y="193" text-anchor="middle" fill="#4c1d95" font-size="10" font-weight="600">Code Generation</text>
-                                <!-- Arrow Apex to Code -->
-                                <path d="M440,190 L540,160" fill="none" stroke="#8b5cf6" stroke-width="2.5" marker-end="url(#arrowApex)"/>
-                                <!-- Code Box -->
-                                <rect x="540" y="60" width="140" height="200" rx="8" fill="#f0fdfa" stroke="#0d9488" stroke-width="2"/>
-                                <text x="610" y="85" text-anchor="middle" fill="#134e4a" font-size="13" font-weight="700">Generated Code</text>
-                                <!-- Code items -->
-                                <circle cx="555" cy="110" r="3" fill="#0d9488"/>
-                                <text x="570" y="115" fill="#134e4a" font-size="9">Entities</text>
+                <div class="content content-wide">
+<nav class="breadcrumb">
+    <span class="breadcrumb-item"><span data-lang="fr">Workflows</span><span data-lang="en">Workflows</span></span>
+    <span class="breadcrumb-sep">›</span>
+    <span class="breadcrumb-item current">Ralph Loop</span>
+</nav>
+<h1><span data-lang="fr">Ralph Loop</span><span data-lang="en">Ralph Loop</span></h1>
+<p><span data-lang="fr">Ralph est un orchestrateur incrémental qui boucle entre des commandes Claude Code (build, test, fix, commit) jusqu&#39;à atteindre un état stable. Idéal pour itérer sur de gros changements ou pour un développement autonome long.</span>
+<span data-lang="en">Ralph is an incremental orchestrator that loops between Claude Code commands (build, test, fix, commit) until reaching a stable state. Ideal for iterating on large changes or for long-running autonomous development.</span></p>
+<h2><span data-lang="fr">Commandes principales</span><span data-lang="en">Main commands</span></h2>
+<pre><code class="language-bash">ss ralph start                # démarre la boucle en arrière-plan
+ss ralph status               # état + dernière itération
+ss ralph logs                 # tail des logs
+ss ralph stop                 # arrête proprement
+</code></pre>
+<h2><span data-lang="fr">Cycle d&#39;une itération</span><span data-lang="en">Iteration cycle</span></h2>
+<p><span data-lang="fr">Chaque itération suit quatre étapes :</span>
+<span data-lang="en">Each iteration follows four steps:</span></p>
+<table>
+<thead>
+<tr>
+<th>#</th>
+<th><span data-lang="fr">Étape</span><span data-lang="en">Step</span></th>
+<th><span data-lang="fr">Effet</span><span data-lang="en">Effect</span></th>
+</tr>
+</thead>
+<tbody><tr>
+<td>1</td>
+<td><span data-lang="fr">Load context</span><span data-lang="en">Load context</span></td>
+<td><span data-lang="fr">Charge l&#39;état du repo + le dernier verdict</span><span data-lang="en">Loads the repo state + last verdict</span></td>
+</tr>
+<tr>
+<td>2</td>
+<td><span data-lang="fr">Invoke skill</span><span data-lang="en">Invoke skill</span></td>
+<td><span data-lang="fr">Exécute la skill cible (build, fix, scaffold, …)</span><span data-lang="en">Runs the target skill (build, fix, scaffold, …)</span></td>
+</tr>
+<tr>
+<td>3</td>
+<td><span data-lang="fr">Run gates</span><span data-lang="en">Run gates</span></td>
+<td><span data-lang="fr">Vérifie compile + tests</span><span data-lang="en">Verifies compile + tests</span></td>
+</tr>
+<tr>
+<td>4</td>
+<td><span data-lang="fr">Décision</span><span data-lang="en">Decision</span></td>
+<td><span data-lang="fr">GO → commit + itération suivante ; NO-GO → diagnostic + retry</span><span data-lang="en">GO → commit + next iteration; NO-GO → diagnose + retry</span></td>
+</tr>
+</tbody></table>
+<h2><span data-lang="fr">Configuration</span><span data-lang="en">Configuration</span></h2>
+<p><span data-lang="fr">La configuration vit dans <code>templates/ralph/</code> du repo CLI et est déployée à l&#39;installation. Voyez <code><del>/.claude/ralph/</code> dans votre poste.</span>
+<span data-lang="en">Configuration lives in <code>templates/ralph/</code> in the CLI repo and is deployed at install time. See <code></del>/.claude/ralph/</code> on your machine.</span></p>
-                                <circle cx="555" cy="135" r="3" fill="#0d9488"/>
-                                <text x="570" y="140" fill="#134e4a" font-size="9">Services</text>
-                                <circle cx="555" cy="160" r="3" fill="#0d9488"/>
-                                <text x="570" y="165" fill="#134e4a" font-size="9">Controllers</text>
-                                <circle cx="555" cy="185" r="3" fill="#0d9488"/>
-                                <text x="570" y="190" fill="#134e4a" font-size="9">Tests</text>
-                                <circle cx="555" cy="210" r="3" fill="#0d9488"/>
-                                <text x="570" y="215" fill="#134e4a" font-size="9">Frontend Pages</text>
-                                <!-- Bottom flow arrow -->
-                                <path d="M100,300 L100,320" fill="none" stroke="#3b82f6" stroke-width="2.5" marker-end="url(#arrowFlow)"/>
-                                <text x="100" y="340" text-anchor="middle" fill="#3b82f6" font-size="10" font-weight="600">Loop until complete</text>
-                            </svg>
-                        </div>
-                        <h4 data-lang="fr">Compact Loop (etape 04)</h4>
-                        <h4 data-lang="en">Compact Loop (step 04)</h4>
-                        <p data-lang="fr">
-                            Quand une boucle principale se termine, Ralph entre en Compact Loop pour finaliser les taches restantes:
-                        </p>
-                        <p data-lang="en">
-                            When a main loop finishes, Ralph enters Compact Loop to finalize remaining tasks:
-                        </p>
-                        <ol>
-                            <li data-lang="fr">Identifie les taches eligibles (dependances satisfaites)</li>
-                            <li data-lang="en">Find eligible tasks (dependencies satisfied)</li>
-                            <li data-lang="fr">Regroupe par categorie (max 5 par batch)</li>
-                            <li data-lang="en">Batch by category (max 5 per batch)</li>
-                            <li data-lang="fr">Delegue a `/apex -d`</li>
-                            <li data-lang="en">Delegate to `/apex -d`</li>
-                            <li data-lang="fr">Teste et valide</li>
-                            <li data-lang="en">Test and validate</li>
-                            <li data-lang="fr">Commit le PRD</li>
-                            <li data-lang="en">Commit PRD</li>
-                            <li data-lang="fr">Boucle jusqu'a completion</li>
-                            <li data-lang="en">Loop until completion</li>
-                        </ol>
-                    </section>
-                    <!-- Commands -->
-                    <section id="commands">
-                        <h2>
-                            <span data-lang="fr">Commandes</span>
-                            <span data-lang="en">Commands</span>
-                        </h2>
-                        <div class="command-card">
-                            <div class="command-header">
-                                <code class="command-name">/ralph-loop [description]</code>
-                                <span class="badge badge-green" data-lang="fr">Principal</span>
-                                <span class="badge badge-green" data-lang="en">Main</span>
-                            </div>
-                            <div class="command-body">
-                                <p data-lang="fr">
-                                    Demarre une nouvelle boucle Ralph avec une description de feature.
-                                </p>
-                                <p data-lang="en">
-                                    Start a new Ralph loop with a feature description.
-                                </p>
-                                <div class="code-block">
-                                    <button class="copy-btn">Copy</button>
-                                    <pre><code>/ralph-loop implement user authentication
-/ralph-loop -c "COMPLETE" -m 20 refactor cache
-/ralph-loop -v add payment processing</code></pre>
-                                </div>
-                                <h4>Flags</h4>
-                                <table class="reference-table">
-                                    <thead>
-                                        <tr>
-                                            <th data-lang="fr">Flag</th>
-                                            <th data-lang="en">Flag</th>
-                                            <th data-lang="fr">Description</th>
-                                            <th data-lang="en">Description</th>
-                                        </tr>
-                                    </thead>
-                                    <tbody>
-                                        <tr>
-                                            <td><code>-m N</code></td>
-                                            <td><code>-m N</code></td>
-                                            <td data-lang="fr">Max iterations avant arret (defaut: 50)</td>
-                                            <td data-lang="en">Max iterations before stop (default: 50)</td>
-                                        </tr>
-                                        <tr>
-                                            <td><code>-c TEXT</code></td>
-                                            <td><code>-c TEXT</code></td>
-                                            <td data-lang="fr">Completion promise text (optionnel)</td>
-                                            <td data-lang="en">Completion promise text (optional)</td>
-                                        </tr>
-                                        <tr>
-                                            <td><code>-v</code></td>
-                                            <td><code>-v</code></td>
-                                            <td data-lang="fr">Logging verbose</td>
-                                            <td data-lang="en">Verbose logging</td>
-                                        </tr>
-                                        <tr>
-                                            <td><code>-r</code></td>
-                                            <td><code>-r</code></td>
-                                            <td data-lang="fr">Resume session precedente</td>
-                                            <td data-lang="en">Resume previous session</td>
-                                        </tr>
-                                    </tbody>
-                                </table>
-                            </div>
-                        </div>
-                        <div class="command-card">
-                            <div class="command-header">
-                                <code class="command-name">/ralph-loop -r</code>
-                                <span class="badge badge-blue">Resume</span>
-                            </div>
-                            <div class="command-body">
-                                <p data-lang="fr">
-                                    Resume la derniere session Ralph en cours.
-                                </p>
-                                <p data-lang="en">
-                                    Resume the last Ralph session in progress.
-                                </p>
-                                <div class="code-block">
-                                    <button class="copy-btn">Copy</button>
-                                    <pre><code>/ralph-loop -r
-/ralph-loop -r -v
-/ralph-loop -r -m 10</code></pre>
-                                </div>
-                            </div>
-                        </div>
-                        <div class="command-card">
-                            <div class="command-header">
-                                <code class="command-name">/ralph-loop:cancel-ralph</code>
-                                <span class="badge badge-orange">Cancel</span>
-                            </div>
-                            <div class="command-body">
-                                <p data-lang="fr">
-                                    Annule la boucle Ralph active.
-                                </p>
-                                <p data-lang="en">
-                                    Cancel the active Ralph loop.
-                                </p>
-                                <div class="code-block">
-                                    <button class="copy-btn">Copy</button>
-                                    <pre><code>/ralph-loop:cancel-ralph</code></pre>
-                                </div>
-                            </div>
-                        </div>
-                    </section>
-                    <!-- Workflow -->
-                    <section id="workflow">
-                        <h2>
-                            <span data-lang="fr">Workflow</span>
-                            <span data-lang="en">Workflow</span>
-                        </h2>
-                        <h4 data-lang="fr">Cas 1: Module unique</h4>
-                        <h4 data-lang="en">Case 1: Single Module</h4>
-                        <p data-lang="fr">
-                            L'agent principal execute la Compact Loop directement (pas de sub-agents).
-                        </p>
-                        <p data-lang="en">
-                            Main agent runs Compact Loop directly (no sub-agents).
-                        </p>
-                        <ol>
-                            <li data-lang="fr">Init + Load tasks</li>
-                            <li data-lang="en">Init + Load tasks</li>
-                            <li data-lang="fr">Loop: delegue a /apex -d → valide → commit → prochain batch</li>
-                            <li data-lang="en">Loop: delegate to /apex -d → validate → commit → next batch</li>
-                            <li data-lang="fr">Report final</li>
-                            <li data-lang="en">Final report</li>
-                        </ol>
-                        <h4 data-lang="fr">Cas 2: Modules multiples</h4>
-                        <h4 data-lang="en">Case 2: Multi-Module</h4>
-                        <p data-lang="fr">
-                            Utilise Agent Teams pour parallelisation (2+ modules depuis BA handoff).
-                        </p>
-                        <p data-lang="en">
-                            Uses Agent Teams for parallelization (2+ modules from BA handoff).
-                        </p>
-                        <ul>
-                            <li data-lang="fr">Team Lead cree une team (TeamCreate)</li>
-                            <li data-lang="en">Team Lead creates team (TeamCreate)</li>
-                            <li data-lang="fr">Layer 0: modules fondation (spawned first)</li>
-                            <li data-lang="en">Layer 0: Foundation modules (spawned first)</li>
-                            <li data-lang="fr">Layer 1+: modules dependant de couches precedentes (spawned en parallel)</li>
-                            <li data-lang="en">Layer 1+: Modules depending on previous layers (spawned in parallel)</li>
-                            <li data-lang="fr">Verification cross-module → report final → TeamDelete</li>
-                            <li data-lang="en">Cross-module verification → final report → TeamDelete</li>
-                        </ul>
-                        <h4 data-lang="fr">Flux complet recommande</h4>
-                        <h4 data-lang="en">Recommended complete flow</h4>
-                        <div class="code-block">
-                            <button class="copy-btn">Copy</button>
-                            <pre><code># 1. Effectuer Business Analyse (interactive)
-/business-analyse MyFeature
-# 2. Attendre handoff - verifie que .ralph/prd.json est genere
-# 3. Lancer Ralph Loop pour implementation
-/ralph-loop -r
-# 4. Ou directement avec description
-/ralph-loop -m 50 implement MyFeature</code></pre>
-                        </div>
-                    </section>
-                    <!-- File Structure -->
-                    <section id="file-structure">
-                        <h2>File Structure</h2>
-                        <p data-lang="fr">
-                            Ralph cree et gere la structure .ralph/:
-                        </p>
-                        <p data-lang="en">
-                            Ralph creates and manages .ralph/ structure:
-                        </p>
-                        <div class="code-block">
-                            <button class="copy-btn">Copy</button>
-                            <pre><code>.ralph/
-├── prd.json                    # Active task list (unified v3 format)
-├── progress.txt                # Persistent memory / state
-├── modules-queue.json          # Multi-module tracking
-├── prd-{module}.json           # Per-module PRDs
-├── logs/
-│   ├── ralph-2026-02-16.log
-│   └── apex-2026-02-16.log
-└── reports/
-    ├── {feature}.md            # Final markdown report
-    └── {feature}.json          # Structured report data</code></pre>
-                        </div>
-                        <div class="alert alert-info">
-                            <span class="alert-icon">&#128187;</span>
-                            <div class="alert-content">
-                                <h5>prd.json format (v3)</h5>
-                                <p data-lang="fr">
-                                    Format unifie avec metadata, liste de taches pre-calculees, dependances, statuts.
-                                </p>
-                                <p data-lang="en">
-                                    Unified format with metadata, pre-computed task list, dependencies, statuses.
-                                </p>
-                            </div>
-                        </div>
-                    </section>
-                    <!-- When to Use -->
-                    <section id="when-to-use">
-                        <h2>
-                            <span data-lang="fr">Quand utiliser</span>
-                            <span data-lang="en">When to use</span>
-                        </h2>
-                        <div class="alert alert-success">
-                            <span class="alert-icon">&#9989;</span>
-                            <div class="alert-content">
-                                <h5 data-lang="fr">Recommande pour</h5>
-                                <h5 data-lang="en">Recommended for</h5>
-                                <ul style="margin-top: 10px;">
-                                    <li data-lang="fr">Implementation de features apres Business Analyse (recommended flow)</li>
-                                    <li data-lang="en">Implementing features after Business Analyse (recommended flow)</li>
-                                    <li data-lang="fr">Modules avec specifications completes en PRD</li>
-                                    <li data-lang="en">Modules with complete specifications in PRD</li>
-                                    <li data-lang="fr">Projets multi-modules avec dependances claires</li>
-                                    <li data-lang="en">Multi-module projects with clear dependencies</li>
-                                    <li data-lang="fr">Workflows iteratifs avec tests automatiques</li>
-                                    <li data-lang="en">Iterative workflows with automated tests</li>
-                                </ul>
-                            </div>
-                        </div>
-                        <div class="alert alert-warning">
-                            <span class="alert-icon">&#9888;</span>
-                            <div class="alert-content">
-                                <h5 data-lang="fr">Non recommande pour</h5>
-                                <h5 data-lang="en">Not recommended for</h5>
-                                <ul style="margin-top: 10px;">
-                                    <li data-lang="fr">Taches sans PRD predefini (utiliser /apex ou /business-analyse d'abord)</li>
-                                    <li data-lang="en">Tasks without predefined PRD (use /apex or /business-analyse first)</li>
-                                    <li data-lang="fr">Operations one-shot simples</li>
-                                    <li data-lang="en">Simple one-shot operations</li>
-                                    <li data-lang="fr">Decisions de design necessitant jugement humain</li>
-                                    <li data-lang="en">Design decisions requiring human judgment</li>
-                                </ul>
-                            </div>
-                        </div>
-                        <h4 data-lang="fr">Integration avec la pile SmartStack</h4>
-                        <h4 data-lang="en">Integration with SmartStack Stack</h4>
-                        <table class="reference-table">
-                            <thead>
-                                <tr>
-                                    <th data-lang="fr">Flux</th>
-                                    <th data-lang="en">Flow</th>
-                                    <th data-lang="fr">Outils</th>
-                                    <th data-lang="en">Tools</th>
-                                </tr>
-                            </thead>
-                            <tbody>
-                                <tr>
-                                    <td data-lang="fr">Specification</td>
-                                    <td data-lang="en">Specification</td>
-                                    <td><code>/business-analyse</code></td>
-                                    <td><code>/business-analyse</code></td>
-                                </tr>
-                                <tr>
-                                    <td data-lang="fr">Implementation</td>
-                                    <td data-lang="en">Implementation</td>
-                                    <td><code>/ralph-loop</code> → <code>/apex -d</code></td>
-                                    <td><code>/ralph-loop</code> → <code>/apex -d</code></td>
-                                </tr>
-                                <tr>
-                                    <td data-lang="fr">Validation</td>
-                                    <td data-lang="en">Validation</td>
-                                    <td><code>/validate-feature</code></td>
-                                    <td><code>/validate-feature</code></td>
-                                </tr>
-                                <tr>
-                                    <td data-lang="fr">Release</td>
-                                    <td data-lang="en">Release</td>
-                                    <td><code>/gitflow:10-start release</code></td>
-                                    <td><code>/gitflow:10-start release</code></td>
-                                </tr>
-                            </tbody>
-                        </table>
-                    </section>
                 </div>
             </main>
         </div>
     </div>
     <script src="js/app.js"></script>
 </body>
 </html>