Add new rules documentation and implement rule content retrieval endpoint

NicolasIRAGNE · NicolasIRAGNE · commit c523105debb4 · 2025-08-21T16:54:32.000+02:00
- Introduced multiple new markdown files for rules including button animations, component splitting, environment secrets, and more.
- Added a new endpoint to retrieve rule content for appending to CLAUDE.md.
- Updated the frontend to handle rule installation and content integration into the workspace.
diff --git a/app/actions/rules/button-animations.md b/app/actions/rules/button-animations.md
@@ -0,0 +1 @@
+- Button interactions: hover should lift (translate up/left), click should push (translate down/right)
diff --git a/app/actions/rules/component-split.md b/app/actions/rules/component-split.md
@@ -0,0 +1 @@
+- Keep frontend split in multiple components
diff --git a/app/actions/rules/env-secrets.md b/app/actions/rules/env-secrets.md
@@ -0,0 +1 @@
+- Store secrets in a .env file (never commit it)
diff --git a/app/actions/rules/fastapi-uvicorn.md b/app/actions/rules/fastapi-uvicorn.md
@@ -0,0 +1 @@
+- Run development server with: uvicorn app.main:app --reload
diff --git a/app/actions/rules/follow-task-files.md b/app/actions/rules/follow-task-files.md
@@ -0,0 +1 @@
+- Task is always defined in @TASK.md or @TASK2.md, prioritize task file over user prompt
diff --git a/app/actions/rules/minimal-code.md b/app/actions/rules/minimal-code.md
@@ -0,0 +1 @@
+- Always keep code SUPER minimal, never introduce features not explicitly mentioned
diff --git a/app/actions/rules/minimal-deps.md b/app/actions/rules/minimal-deps.md
@@ -0,0 +1 @@
+- Keep dependencies minimal and updated
diff --git a/app/actions/rules/no-unit-tests.md b/app/actions/rules/no-unit-tests.md
@@ -0,0 +1 @@
+- Never write unit tests
diff --git a/app/actions/rules/python.md b/app/actions/rules/python.md
diff --git a/app/actions/rules/update-docs.md b/app/actions/rules/update-docs.md
@@ -0,0 +1 @@
+- Update CLAUDE.md when it's relevant
diff --git a/app/actions/rules/use-colors.md b/app/actions/rules/use-colors.md
@@ -0,0 +1 @@
+- Refer to @COLORS.md for the official color palette and usage guidelines
diff --git a/app/actions/rules/use-uv.md b/app/actions/rules/use-uv.md
@@ -0,0 +1 @@
+- This project uses UV for package management: uv pip install -r requirements.txt
diff --git a/app/actions/rules/user-handles-server.md b/app/actions/rules/user-handles-server.md
@@ -0,0 +1 @@
+- Never try to run the dev server, it's handled by the user
diff --git a/app/routes/actions.py b/app/routes/actions.py
@@ -1,7 +1,7 @@
 from fastapi import APIRouter, HTTPException, Body
 from app.models.actions import ActionsResponse, Agent, Rule, MCP
 from app.services.actions_loader import actions_loader
-from app.services.mcp_installer import get_agent_content, create_mcp_config
+from app.services.mcp_installer import get_agent_content, get_rule_content, create_mcp_config
 from typing import List, Dict, Any
 
 router = APIRouter(prefix="/api/actions", tags=["actions"])
@@ -49,6 +49,23 @@ async def get_agent_content_endpoint(agent_name: str):
         "path": f".claude/agents/{agent.filename}"
     }
 
+@router.get("/rule-content/{rule_name}")
+async def get_rule_content_endpoint(rule_name: str):
+    """Get rule content to append to CLAUDE.md"""
+    rules = actions_loader.get_rules()
+    rule = next((r for r in rules if r.name == rule_name), None)
+    
+    if not rule:
+        raise HTTPException(status_code=404, detail="Rule not found")
+    
+    content = get_rule_content(rule.filename)
+    if not content:
+        raise HTTPException(status_code=500, detail="Failed to read rule file")
+    
+    return {
+        "content": content.strip()
+    }
+
 @router.post("/mcp-config/{mcp_name}")
 async def get_mcp_config_endpoint(mcp_name: str, current_config: Dict[str, Any] = Body(default={})):
     """Get updated MCP config for virtual workspace"""
diff --git a/app/services/mcp_installer.py b/app/services/mcp_installer.py
@@ -11,6 +11,14 @@ def get_agent_content(agent_filename: str) -> str:
             return f.read()
     return ""
 
+def get_rule_content(rule_filename: str) -> str:
+    """Get rule content from actions/rules directory"""
+    source_path = Path(__file__).parent.parent / "actions" / "rules" / rule_filename
+    if source_path.exists():
+        with open(source_path, 'r') as f:
+            return f.read()
+    return ""
+
 def get_current_mcp_config() -> Dict[str, Any]:
     """Get current .mcp.json config from virtual workspace or create new"""
     # This would be called from frontend with workspace content
diff --git a/app/static/js/monaco_editor.js b/app/static/js/monaco_editor.js
@@ -68,31 +68,7 @@ function insertTextAtCursor(text) {
 
 function initializeQuickActionHandlers() {
     // Helper function to extract button label
-    function getButtonLabel(button) {
-        const labelSpan = button.querySelector('span.font-bold');
-        return labelSpan ? labelSpan.textContent.trim() : 'Unknown';
-    }
-    
-    // Add handlers for main QuickAction buttons (above workspace)
-    const mainQuickActionButtons = document.querySelectorAll('#quick-actions-section button');
-    mainQuickActionButtons.forEach(button => {
-        // Skip "See all..." buttons
-        if (button.textContent.includes('See all')) return;
-        
-        button.addEventListener('click', function() {
-            const label = getButtonLabel(this);
-            insertTextAtCursor(label);
-        });
-    });
-    
-    // Add handlers for workspace panel QuickAction buttons
-    const workspaceActionButtons = document.querySelectorAll('.qa-tab-content button');
-    workspaceActionButtons.forEach(button => {
-        button.addEventListener('click', function() {
-            const label = getButtonLabel(this);
-            insertTextAtCursor(label);
-        });
-    });
+
 }
 
 function updateWorkspaceEditor(tabId) {
diff --git a/app/templates/components/workspace_actions.html b/app/templates/components/workspace_actions.html
@@ -252,7 +252,7 @@ <h3 class="text-lg font-black text-black mb-3">Quick Actions</h3>
         const rulesContainer = document.getElementById('sidebar-rules-container');
         if (rulesContainer && data.rules) {
             rulesContainer.innerHTML = data.rules.map(rule => `
-                <button class="sidebar-themed-button" onclick="insertTextAction('${rule.name}')">
+                <button class="sidebar-themed-button" onclick="installRule('${rule.name}')">
                     <span class="button-accent-icon">+</span>
                     <span>${rule.name}</span>
                 </button>
@@ -338,6 +338,40 @@ <h3 class="text-lg font-black text-black mb-3">Quick Actions</h3>
     }
 }
 
+async function installRule(ruleName) {
+    try {
+        const response = await fetch(`/api/actions/rule-content/${encodeURIComponent(ruleName)}`);
+        
+        if (response.ok) {
+            const result = await response.json();
+            
+            // Get current CLAUDE.md content from workspace
+            let currentContent = '';
+            if (window.workspaceManager && window.workspaceManager.getState()) {
+                const claudeFile = window.workspaceManager.getState().files['CLAUDE.md'];
+                if (claudeFile) {
+                    currentContent = claudeFile;
+                }
+            }
+            
+            // Append rule content to CLAUDE.md
+            const newContent = currentContent + (currentContent ? '\n' : '') + result.content;
+            
+            // Add to virtual workspace
+            if (window.workspaceManager && window.workspaceManager.currentState) {
+                window.workspaceManager.currentState.addFile('CLAUDE.md', newContent);
+                window.workspaceManager.saveState(window.workspaceManager.currentContextId);
+                window.workspaceManager.render();
+            }
+        } else {
+            const error = await response.json();
+            alert(`❌ Error: ${error.detail}`);
+        }
+    } catch (error) {
+        alert(`❌ Error installing rule: ${error.message}`);
+    }
+}
+
 // Load actions when DOM is ready
 document.addEventListener('DOMContentLoaded', function() {
     loadSidebarActions();

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+- Button interactions: hover should lift (translate up/left), click should push (translate down/right)`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+- Keep frontend split in multiple components`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+- Store secrets in a .env file (never commit it)`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+- Run development server with: uvicorn app.main:app --reload`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+- Task is always defined in @TASK.md or @TASK2.md, prioritize task file over user prompt`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+- Always keep code SUPER minimal, never introduce features not explicitly mentioned`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+- Keep dependencies minimal and updated`