Update agents, instructions and more

Author: ashleyshaw

.github/agents/agent.md

@@ -1,10 +1,10 @@
 ---
-title: Multi-Block Plugin Agents Index
-description: Main index of automation agents for multi-block plugin scaffold
-category: Agent
-type: Agent Index
-audience: Developers, AI Agents
-date: 2025-12-01
+name: "Multi-Block Plugin Agents Index"
+description: "Main index of automation agents for multi-block plugin scaffold"
+category: "Agent"
+type: "Agent Index"
+audience: "Developers, AI Agents"
+date: "2025-12-01"
 ---
 
 # Multi-Block Plugin Scaffold: Main Agent Index

.github/agents/code-quality.agent.md

@@ -1,11 +1,7 @@
 ---
 name: Code Quality Agent
 description: An agent that runs repository-wide linting, formatting, testing, and other quality checks.
-tools:
-  - run_in_terminal
-  - read_file
-  - grep_search
-  - file_search
+tools: ["run_in_terminal", "read_file", "grep_search", "file_search"]
 ---
 
 # Code Quality Agent

.github/agents/generate-plugin.agent.md

@@ -526,6 +526,55 @@ node .github/agents/scaffold-generator.agent.js
 
 ---
 
+## Logging
+
+The plugin generator creates per-project log files in JSON format:
+
+**Log File Location:**
+```
+logs/generate-plugin-{{slug}}.log
+```
+
+**Log Format:**
+```json
+[
+  {
+    "timestamp": "2025-12-12T10:30:00.000Z",
+    "level": "INFO",
+    "message": "Plugin generator starting",
+    "data": {
+      "nodeVersion": "v20.10.0",
+      "workingDirectory": "/path/to/scaffold",
+      "mode": "generator"
+    }
+  },
+  {
+    "timestamp": "2025-12-12T10:30:01.000Z",
+    "level": "INFO",
+    "message": "Configuration validated successfully",
+    "data": {
+      "slug": "my-plugin",
+      "name": "My Plugin",
+      "version": "1.0.0"
+    }
+  }
+]
+```
+
+**What Gets Logged:**
+- User interactions and prompts
+- Configuration validation results
+- Plugin generation progress
+- File operations
+- Errors and warnings
+
+**Log Retention:**
+- Logs are stored per-project (by slug)
+- New runs append to existing log file
+- Manual cleanup recommended for old projects
+
+---
+
 ## Related Files
 
 - [Generate Plugin Prompt](../prompts/generate-plugin.prompt.md) - Interactive generation workflow