1

.gitignore

@@ -25,9 +25,9 @@ wheels/
 venv/
 ENV/
 env/
-
-# Environment Variables
-.env  # Actual secrets - never commit
+ 
+# Environment Variables # Actual secrets - never commit
+.env  
 # .env.example IS committed as a template - do not exclude it
 
 # Database and Logs

agents/base_agent.py

@@ -145,10 +145,21 @@ class LLMAgent(BaseAgent):
             from config import config
             from agents.llm_adapter import get_llm_adapter
             
+            # Get API key dynamically (supports HF Spaces Secrets)
+            api_key = config.llm.get_api_key()
+            
+            if not api_key:
+                raise ValueError(
+                    "Missing API key! To use the Google AI API, provide api_key via:\n"
+                    "  1. GOOGLE_API_KEY environment variable (HF Spaces Secrets)\n"
+                    "  2. GENAI_API_KEY environment variable (fallback)\n"
+                    "  3. Set in .env file (local development)"
+                )
+            
             self._adapter = get_llm_adapter(
                 provider=config.llm.provider,
                 model=config.llm.model,
-                api_key=config.llm.api_key
+                api_key=api_key
             )
         return self._adapter
         

app.py

@@ -20,6 +20,13 @@ import requests
 import time
 from typing import Optional, List, Dict, Any
 
+# Load environment variables from .env file (for local development)
+try:
+    from dotenv import load_dotenv
+    load_dotenv()
+except ImportError:
+    pass
+
 # Note: Gradio 6.0 doesn't support custom CSS in gr.Blocks()
 # UI styles module available but not used in this version
 
@@ -221,6 +228,32 @@ def quick_build_circuit(template: str, num_qubits: int) -> str:
     except Exception as e:
         logger.error(f"Quick build error: {e}")
         return f"# Error: {str(e)}"
+# =============================================================================
+# EXAMPLE QUESTIONS FOR UI
+# =============================================================================
+
+EXAMPLE_QUESTIONS = [
+    # Basic circuits
+    {"category": "🌟 Beginner", "question": "Create a Bell state circuit", "description": "Classic 2-qubit entanglement"},
+    {"category": "🌟 Beginner", "question": "Put a qubit in superposition", "description": "Single Hadamard gate"},
+    {"category": "🌟 Beginner", "question": "Create a simple NOT gate on qubit 0", "description": "X gate application"},
+    
+    # Entanglement
+    {"category": "🔗 Entanglement", "question": "Generate a 3-qubit GHZ state", "description": "Greenberger-Horne-Zeilinger state"},
+    {"category": "🔗 Entanglement", "question": "Create a 4-qubit GHZ state with measurements", "description": "GHZ with classical bits"},
+    {"category": "🔗 Entanglement", "question": "Build a W state for 3 qubits", "description": "Another entangled state type"},
+    
+    # Algorithms
+    {"category": "⚙️ Algorithms", "question": "Create a 4-qubit QFT circuit", "description": "Quantum Fourier Transform"},
+    {"category": "⚙️ Algorithms", "question": "Build a 2-qubit Grover search circuit", "description": "Quantum search algorithm"},
+    {"category": "⚙️ Algorithms", "question": "Generate a quantum teleportation circuit", "description": "State teleportation protocol"},
+    
+    # Custom circuits
+    {"category": "🔧 Custom", "question": "Apply H gate to qubit 0, then CNOT from 0 to 1", "description": "Step-by-step gates"},
+    {"category": "🔧 Custom", "question": "Create a circuit with Rx(π/4) on qubit 0 and Ry(π/2) on qubit 1", "description": "Rotation gates"},
+    {"category": "🔧 Custom", "question": "Build a circuit that swaps qubit 0 and qubit 1", "description": "SWAP operation"},
+]
+
 # =============================================================================
 # GRADIO INTERFACE
 # =============================================================================
@@ -235,22 +268,137 @@ with gr.Blocks(title="QAgents - Quantum Circuit Assistant") as demo:
     """)
     
     with gr.Tabs():
+        # =================================================================
+        # TAB 0: GETTING STARTED (NEW)
+        # =================================================================
+        with gr.TabItem("🚀 Getting Started"):
+            gr.Markdown("""
+## 👋 Welcome to QAgents!
+
+QAgents is an AI-powered assistant that generates **quantum circuits** from natural language descriptions.
+Just describe what you want, and the agent will produce valid **OpenQASM 2.0** code.
+
+---
+
+### 🎯 What Can I Ask?
+
+| Category | What You Can Request | Example |
+|----------|---------------------|---------|
+| **Basic Gates** | Single qubit operations | *"Apply a Hadamard gate to qubit 0"* |
+| **Entanglement** | Bell states, GHZ states | *"Create a Bell state"* |
+| **Algorithms** | QFT, Grover, Teleportation | *"Build a 4-qubit QFT"* |
+| **Custom Circuits** | Step-by-step gate sequences | *"Apply H to q0, then CNOT from q0 to q1"* |
+| **Measurements** | Circuits with classical output | *"Create a GHZ state with measurements"* |
+
+---
+
+### 📝 How to Write Good Prompts
+
+**✅ Be Specific:**
+- ✅ *"Create a 3-qubit GHZ state"* → Clear qubit count
+- ❌ *"Make something entangled"* → Too vague
+
+**✅ Mention Qubit Numbers:**
+- ✅ *"Apply CNOT from qubit 0 to qubit 1"* → Clear targets
+- ❌ *"Do a CNOT"* → Which qubits?
+
+**✅ Include Parameters for Rotation Gates:**
+- ✅ *"Apply Rx(π/4) to qubit 0"* → Clear angle
+- ❌ *"Rotate qubit 0"* → What angle?
+
+---
+
+### 🔧 Output Format
+
+The agent returns **OpenQASM 2.0** code that can be:
+- Copied and used in Qiskit, Cirq, or other quantum frameworks
+- Simulated on IBM Quantum, Amazon Braket, or local simulators
+- Validated and scored using the **Quick Build** or **MCP Health** tabs
+
+---
+
+### ⚡ Quick Tips
+
+| Tip | Description |
+|-----|-------------|
+| 💬 Type `help` | Show available commands |
+| 📊 Type `status` | Check MCP server connection |
+| 🛠️ Use Quick Build | Generate circuits from templates without typing |
+| 🔗 Check MCP Health | Verify backend tools are available |
+
+---
+
+### 🎮 Try These Examples
+
+Click any example below to copy it, then paste in the **Chat** tab:
+            """)
+            
+            # Display example questions in a nice format
+            with gr.Accordion("🌟 Beginner Examples", open=True):
+                gr.Markdown("""
+| Example Prompt | What It Does |
+|---------------|--------------|
+| `Create a Bell state circuit` | Creates the classic 2-qubit entangled state |
+| `Put a qubit in superposition` | Single Hadamard gate on qubit 0 |
+| `Create a simple NOT gate on qubit 0` | Applies X gate to flip the qubit |
+| `Apply Hadamard gates to qubits 0 and 1` | Parallel superposition |
+                """)
+            
+            with gr.Accordion("🔗 Entanglement Examples", open=False):
+                gr.Markdown("""
+| Example Prompt | What It Does |
+|---------------|--------------|
+| `Generate a 3-qubit GHZ state` | Creates a 3-qubit maximally entangled state |
+| `Create a 4-qubit GHZ state with measurements` | GHZ state + measurement on all qubits |
+| `Build a W state for 3 qubits` | Alternative entangled state with different properties |
+| `Create an entangled pair of qubits` | Simple Bell state (synonym) |
+                """)
+            
+            with gr.Accordion("⚙️ Algorithm Examples", open=False):
+                gr.Markdown("""
+| Example Prompt | What It Does |
+|---------------|--------------|
+| `Create a 4-qubit QFT circuit` | Quantum Fourier Transform for 4 qubits |
+| `Build a 2-qubit Grover search circuit` | Amplitude amplification algorithm |
+| `Generate a quantum teleportation circuit` | 3-qubit state teleportation protocol |
+| `Create an inverse QFT for 3 qubits` | Inverse Quantum Fourier Transform |
+                """)
+            
+            with gr.Accordion("🔧 Custom Circuit Examples", open=False):
+                gr.Markdown("""
+| Example Prompt | What It Does |
+|---------------|--------------|
+| `Apply H gate to qubit 0, then CNOT from 0 to 1` | Step-by-step gate application |
+| `Create a circuit with Rx(π/4) on qubit 0` | Rotation around X-axis |
+| `Build a circuit that swaps qubit 0 and qubit 1` | SWAP gate implementation |
+| `Apply T gate to qubit 0 and S gate to qubit 1` | Phase gates |
+| `Create a Toffoli gate on qubits 0, 1, 2` | Controlled-controlled-NOT |
+                """)
+            
+            gr.Markdown("""
+---
+
+### 🚀 Ready to Start?
+
+Head to the **💬 Chat** tab and try your first prompt!
+            """)
+        
         # =================================================================
         # TAB 1: CHAT INTERFACE
         # =================================================================
         with gr.TabItem("💬 Chat"):
-            gr.Markdown("### Chat with Quantum Circuit Agent")
-            gr.Markdown("Ask me to create quantum circuits! Try: *'Create a Bell state'* or *'Generate a 3-qubit GHZ state'*")
+            gr.Markdown("### 💬 Chat with Quantum Circuit Agent")
+            gr.Markdown("Describe the quantum circuit you want to create in plain English!")
             
             chatbot = gr.Chatbot(
                 value=[],
-                height=400,
+                height=350,
                 label="Quantum Circuit Agent"
             )
             
             with gr.Row():
                 msg_input = gr.Textbox(
-                    placeholder="Ask me to create a quantum circuit...",
+                    placeholder="e.g., 'Create a Bell state' or 'Build a 3-qubit GHZ state'",
                     label="Your Message",
                     scale=4,
                     lines=1
@@ -262,6 +410,22 @@ with gr.Blocks(title="QAgents - Quantum Circuit Assistant") as demo:
                 help_btn = gr.Button("❓ Help", size="sm")
                 status_btn = gr.Button("📊 Status", size="sm")
             
+            # Example buttons section
+            gr.Markdown("---")
+            gr.Markdown("### ⚡ Quick Examples (click to use)")
+            
+            with gr.Row():
+                ex1_btn = gr.Button("🔔 Bell State", size="sm")
+                ex2_btn = gr.Button("🌀 GHZ State (3q)", size="sm")
+                ex3_btn = gr.Button("📐 QFT (4q)", size="sm")
+                ex4_btn = gr.Button("🔍 Grover (2q)", size="sm")
+            
+            with gr.Row():
+                ex5_btn = gr.Button("🌊 Superposition", size="sm")
+                ex6_btn = gr.Button("📡 Teleportation", size="sm")
+                ex7_btn = gr.Button("🔄 SWAP Gate", size="sm")
+                ex8_btn = gr.Button("🎛️ Custom CNOT", size="sm")
+            
             # Chat handlers
             def respond(message: str, chat_history: List):
                 if not message.strip():
@@ -284,11 +448,28 @@ with gr.Blocks(title="QAgents - Quantum Circuit Assistant") as demo:
                 chat_history.append({"role": "assistant", "content": status_text})
                 return chat_history
             
+            # Example button handlers - each returns the example text and triggers the chat
+            def use_example(example_text: str, chat_history: List):
+                bot_response = chat_response(example_text, chat_history)
+                chat_history.append({"role": "user", "content": example_text})
+                chat_history.append({"role": "assistant", "content": bot_response})
+                return chat_history
+            
             send_btn.click(respond, [msg_input, chatbot], [msg_input, chatbot])
             msg_input.submit(respond, [msg_input, chatbot], [msg_input, chatbot])
             clear_btn.click(lambda: [], outputs=[chatbot])
             help_btn.click(show_help, [chatbot], [chatbot])
             status_btn.click(show_status, [chatbot], [chatbot])
+            
+            # Wire up example buttons
+            ex1_btn.click(lambda h: use_example("Create a Bell state circuit", h), [chatbot], [chatbot])
+            ex2_btn.click(lambda h: use_example("Generate a 3-qubit GHZ state", h), [chatbot], [chatbot])
+            ex3_btn.click(lambda h: use_example("Create a 4-qubit QFT circuit", h), [chatbot], [chatbot])
+            ex4_btn.click(lambda h: use_example("Build a 2-qubit Grover search circuit", h), [chatbot], [chatbot])
+            ex5_btn.click(lambda h: use_example("Put 2 qubits in superposition", h), [chatbot], [chatbot])
+            ex6_btn.click(lambda h: use_example("Generate a quantum teleportation circuit", h), [chatbot], [chatbot])
+            ex7_btn.click(lambda h: use_example("Build a circuit that swaps qubit 0 and qubit 1", h), [chatbot], [chatbot])
+            ex8_btn.click(lambda h: use_example("Apply H gate to qubit 0, then CNOT from 0 to 1", h), [chatbot], [chatbot])
         
         # =================================================================
         # TAB 2: MCP ENDPOINTS HEALTH
@@ -364,29 +545,87 @@ with gr.Blocks(title="QAgents - Quantum Circuit Assistant") as demo:
             build_btn.click(quick_build_circuit, [template_select, qubits_slider], [qasm_output])
         
         # =================================================================
-        # TAB 4: ABOUT
+        # TAB 5: ABOUT
         # =================================================================
         with gr.TabItem("ℹ️ About"):
             gr.Markdown("""
-            ## ℹ️ About QAgents
-            
-            **QAgents** is a multi-agent system for quantum circuit generation.
-            
-            ### 🏗️ How it Works
-            
-            1. **You ask** for a quantum circuit in natural language
-            2. **NAKED mode** uses an LLM to generate OpenQASM code directly
-            3. **MCP tools** validate and simulate your circuits
-            
-            ### 🔗 Architecture
-            
-            - **Frontend**: This Gradio app (QAgents-Workflows)
-            - **Backend**: QuantumArchitect-MCP on HuggingFace
-            - **LLM**: Gemini 2.5 Flash (configurable)
-            
-            ### 📝 License
-            
-            MIT License - Feel free to use and modify!
+## ℹ️ About QAgents
+
+**QAgents** is a multi-agent system for quantum circuit generation using natural language.
+
+---
+
+### 🏗️ How it Works
+
+```
+┌─────────────────┐     ┌──────────────┐     ┌─────────────────────┐
+│   Your Prompt   │ ──► │  LLM Agent   │ ──► │  OpenQASM 2.0 Code  │
+│  (Plain Text)   │     │ (NAKED Mode) │     │                     │
+└─────────────────┘     └──────────────┘     └─────────────────────┘
+                              │
+                              ▼
+                    ┌──────────────────┐
+                    │  MCP Tools       │
+                    │  - Validate      │
+                    │  - Simulate      │
+                    │  - Score         │
+                    └──────────────────┘
+```
+
+1. **You describe** the quantum circuit you want in natural language
+2. **NAKED mode** uses an LLM to generate valid OpenQASM 2.0 code directly
+3. **MCP tools** can validate, simulate, and score your circuits
+
+---
+
+### 🎯 Capabilities
+
+| Feature | Description |
+|---------|-------------|
+| **Circuit Generation** | Create circuits from descriptions |
+| **Standard Gates** | H, X, Y, Z, S, T, Rx, Ry, Rz, CNOT, CZ, SWAP, Toffoli |
+| **Templates** | Bell states, GHZ, QFT, Grover, Teleportation |
+| **Output Format** | OpenQASM 2.0 (compatible with Qiskit, Cirq, etc.) |
+| **Validation** | Syntax and semantic validation via MCP |
+
+---
+
+### 🔗 Architecture
+
+| Component | Technology | Purpose |
+|-----------|------------|---------|
+| **Frontend** | Gradio 6.0 | This UI you're using |
+| **Orchestrator** | QAgents-Workflows | Agent coordination |
+| **LLM** | Gemini 2.5 Flash | Code generation |
+| **Backend** | QuantumArchitect-MCP | Validation & simulation |
+
+---
+
+### 📖 Supported Quantum Operations
+
+**Single-Qubit Gates:**
+- `H` (Hadamard), `X`, `Y`, `Z` (Pauli gates)
+- `S`, `T`, `Sdg`, `Tdg` (Phase gates)
+- `Rx(θ)`, `Ry(θ)`, `Rz(θ)` (Rotation gates)
+
+**Multi-Qubit Gates:**
+- `CNOT/CX` (Controlled-NOT)
+- `CZ` (Controlled-Z)
+- `SWAP` (Swap two qubits)
+- `CCX/Toffoli` (Controlled-Controlled-NOT)
+
+---
+
+### 📝 License
+
+MIT License - Feel free to use and modify!
+
+---
+
+### 🔗 Links
+
+- **QAgents-Workflows**: Frontend orchestration
+- **QuantumArchitect-MCP**: Backend quantum tools
             """)
 
 # Launch for HuggingFace Spaces

config.py

@@ -13,6 +13,15 @@ from dataclasses import dataclass, field
 from typing import Optional, List, Dict
 import os
 
+# Load environment variables from .env file
+try:
+    from dotenv import load_dotenv
+    load_dotenv()
+except ImportError:
+    # If python-dotenv is not installed, continue without loading .env
+    # (it will use system environment variables only)
+    pass
+
 # Paths
 PROJECT_ROOT = Path(__file__).parent
 QUANTUM_MCP_ROOT = PROJECT_ROOT.parent / "QuantumArchitect-MCP"
@@ -162,7 +171,8 @@ class LLMConfig:
     # Model identifier - reads from LLM_MODEL env var, falls back to "gemini-2.5-flash-lite"
     model: str = field(default_factory=lambda: os.getenv("LLM_MODEL", "gemini-2.5-flash-lite"))
     # API key - tries GOOGLE_API_KEY first (Gemini), then GENAI_API_KEY as fallback
-    api_key: Optional[str] = field(default_factory=lambda: os.getenv("GOOGLE_API_KEY") or os.getenv("GENAI_API_KEY"))
+    # Use None as default and fetch dynamically to support HuggingFace Spaces
+    api_key: Optional[str] = None
     temperature: float = 0.2
     max_tokens: int = 2000
 
@@ -174,6 +184,17 @@ class LLMConfig:
     enable_fallback: bool = True  # Enable automatic model switching on rate limit
     fallback_on_error: bool = True  # Also fallback on API errors
 
+    def __post_init__(self):
+        """Initialize API key from environment if not set."""
+        if self.api_key is None:
+            # Try GOOGLE_API_KEY first, then GENAI_API_KEY
+            self.api_key = os.getenv("GOOGLE_API_KEY") or os.getenv("GENAI_API_KEY")
+
+    def get_api_key(self) -> Optional[str]:
+        """Get current API key, checking environment on each call for HF Spaces."""
+        # Always check environment first to support dynamic Secrets in HF Spaces
+        return os.getenv("GOOGLE_API_KEY") or os.getenv("GENAI_API_KEY") or self.api_key
+
     @property
     def model_string(self) -> str:
         """Get full model string for API calls."""

orchestrators/orchestrator.py

@@ -379,9 +379,21 @@ class NakedOrchestrator(BaseOrchestrator):
         if self._llm is None:
             from agents.llm_adapter import get_llm_adapter
             from config import config
+            
+            # Get API key dynamically (supports HF Spaces Secrets)
+            api_key = config.llm.get_api_key()
+            
+            if not api_key:
+                raise ValueError(
+                    "Missing API key! To use the Google AI API, provide api_key via:\n"
+                    "  1. GOOGLE_API_KEY environment variable (HF Spaces Secrets)\n"
+                    "  2. GENAI_API_KEY environment variable (fallback)\n"
+                    "  3. Set in .env file (local development)"
+                )
+            
             self._llm = get_llm_adapter(
                 provider="gemini",
-                api_key=config.llm.api_key,
+                api_key=api_key,
                 enable_fallback=True
             )
         return self._llm

orchestrators/quasar_orchestrator.py

@@ -76,9 +76,21 @@ class QuasarOrchestrator:
         if self._llm is None:
             from agents.llm_adapter import get_llm_adapter
             from config import config
+            
+            # Get API key dynamically (supports HF Spaces Secrets)
+            api_key = config.llm.get_api_key()
+            
+            if not api_key:
+                raise ValueError(
+                    "Missing API key! To use the Google AI API, provide api_key via:\n"
+                    "  1. GOOGLE_API_KEY environment variable (HF Spaces Secrets)\n"
+                    "  2. GENAI_API_KEY environment variable (fallback)\n"
+                    "  3. Set in .env file (local development)"
+                )
+            
             self._llm = get_llm_adapter(
                 provider="gemini",
-                api_key=config.llm.api_key,
+                api_key=api_key,
                 enable_fallback=True
             )
         return self._llm

tasks-project-state.json

@@ -1,20 +1,22 @@
 {
   "project": "QAgents-Workflows",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "Multi-agent quantum circuit optimization system with chat UI and MCP integration",
   "last_updated": "2025-11-30",
-  "status": "MCP_CLIENT_TIMEOUT_FIX_APPLIED",
-  "notes": "Fixed MCP client timeout issues for HuggingFace Space cold starts. Increased timeouts (90s initial, 120s result), added retry logic with exponential backoff, added server warm-up function. Chat UI and MCP health monitor working. Local validation fallback for fast syntax checks.",
+  "status": "API_KEY_LOADING_FIXED",
+  "notes": "Fixed API key loading for HuggingFace Spaces. Now supports dynamic environment variable reading for Secrets. Added better error messages. Enhanced landing page with Getting Started tab, example questions, and clickable quick examples.",
 
   "recent_changes": {
     "2025-11-30": [
-      "Fixed timeout errors in mcp_client.py for HuggingFace Space cold starts",
-      "Increased INITIAL_TIMEOUT to 90s, RESULT_TIMEOUT to 120s",
-      "Added MAX_RETRIES=3 with exponential backoff",
-      "Added warm_up_server() method to MCPClient",
-      "Updated validate_syntax() to use local fallback first (faster)",
-      "Updated app.py health check functions with extended timeouts",
-      "Improved error messages to indicate cold start situations"
+      "Fixed API key loading issue - now dynamically reads from HF Space Secrets",
+      "Added get_api_key() method in LLMConfig for dynamic environment reading",
+      "Updated base_agent.py, orchestrator.py, quasar_orchestrator.py to use dynamic API key loading",
+      "Added clear error messages when API key is missing",
+      "Added new 'Getting Started' tab with comprehensive user guide",
+      "Added example questions organized by category (Beginner, Entanglement, Algorithms, Custom)",
+      "Added 8 clickable quick example buttons in Chat tab",
+      "Enhanced About tab with architecture diagram and detailed capabilities",
+      "Added prompt writing tips and output format documentation"
     ]
   },
 
@@ -42,13 +44,34 @@
   },
 
   "app_features": {
+    "getting_started_tab": {
+      "description": "User onboarding and guide",
+      "features": [
+        "Welcome message and overview",
+        "Prompt categories table",
+        "How to write good prompts",
+        "Output format explanation",
+        "Quick tips",
+        "Collapsible example sections (Beginner, Entanglement, Algorithms, Custom)"
+      ]
+    },
     "chat_tab": {
       "description": "Interactive chat UI for quantum circuit generation",
       "features": [
         "Natural language circuit requests",
+        "8 quick example buttons",
         "Multiple orchestration modes (naked, quasar, hybrid, blackboard)",
-        "Difficulty level selection",
         "Help and status commands"
+      ],
+      "quick_examples": [
+        "Bell State",
+        "GHZ State (3q)",
+        "QFT (4q)",
+        "Grover (2q)",
+        "Superposition",
+        "Teleportation",
+        "SWAP Gate",
+        "Custom CNOT"
       ]
     },
     "mcp_endpoints_tab": {
@@ -63,10 +86,42 @@
     },
     "quick_build_tab": {
       "description": "Direct circuit template generation",
-      "templates": ["bell_state", "ghz_state", "qft", "grover", "vqe", "superposition"]
+      "templates": ["bell_state", "ghz_state", "qft", "grover", "superposition"]
+    },
+    "about_tab": {
+      "description": "Detailed system information",
+      "features": [
+        "Architecture diagram",
+        "Capabilities table",
+        "Supported quantum operations",
+        "Component stack details"
+      ]
     }
   },
 
+  "example_questions": {
+    "beginner": [
+      "Create a Bell state circuit",
+      "Put a qubit in superposition",
+      "Create a simple NOT gate on qubit 0"
+    ],
+    "entanglement": [
+      "Generate a 3-qubit GHZ state",
+      "Create a 4-qubit GHZ state with measurements",
+      "Build a W state for 3 qubits"
+    ],
+    "algorithms": [
+      "Create a 4-qubit QFT circuit",
+      "Build a 2-qubit Grover search circuit",
+      "Generate a quantum teleportation circuit"
+    ],
+    "custom": [
+      "Apply H gate to qubit 0, then CNOT from 0 to 1",
+      "Create a circuit with Rx(π/4) on qubit 0",
+      "Build a circuit that swaps qubit 0 and qubit 1"
+    ]
+  },
+
   "mcp_endpoints": [
     {"name": "create_circuit", "category": "Creation"},
     {"name": "parse_qasm", "category": "Creation"},
@@ -84,15 +139,6 @@
     {"name": "list_templates", "category": "Documentation"}
   ],
 
-  "comprehensive_test_results": {
-    "test_date": "2024-11-29",
-    "previous_results": {
-      "naked": {"success": "9/9 (100%)", "avg_time_ms": 3929},
-      "guided": {"success": "7/9 (78%)", "avg_time_ms": 23120},
-      "blackboard": {"success": "2/9 (22%)", "avg_time_ms": 13507}
-    }
-  },
-
   "architectures": {
     "naked": {
       "description": "Direct LLM-to-QASM generation",