Merge main into branch

Author: danielholanda

.github/workflows/test-playbooks.yml

@@ -0,0 +1,19 @@
+name: Test Playbooks
+
+on:
+  workflow_dispatch:
+    inputs:
+      playbook_id:
+        description: 'Specific playbook ID to test (leave empty to test all changed playbooks)'
+        required: false
+        type: string
+  pull_request:
+    paths:
+      - 'playbooks/**'
+
+jobs:
+  test-placeholder-job:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Placeholder
+        run: echo "Placeholder test job"

playbooks/README.md

@@ -84,23 +84,31 @@ Linux-only content
 
 Content outside `@os` tags is always shown. Keep blocks focused—only tag the parts that differ.
 
-### Pre-installed Software Dropdowns
+### Shared Content Tags
 
-For software that comes pre-installed on the AMD Halo Developer Platform, use the `@require` tag to reference installation instructions from the central `dependencies/` folder:
+Use these tags to pull in shared content from `playbooks/dependencies/`. Both reference items defined in `registry.json`.
+
+| Tag | Purpose | Display |
+|-----|---------|---------|
+| `@require` | Pre-installed software | Collapsible dropdown (optional info) |
+| `@setup` | System configuration steps | Displayed directly (required steps) |
+
+**Pre-installed software** — Use `@require` for software that comes pre-installed on the AMD Halo Developer Platform:
 
 ```markdown
 <!-- @require:comfyui -->
+<!-- @require:comfyui,pytorch -->   <!-- multiple dependencies in one dropdown -->
 ```
 
-For multiple dependencies, use comma-separated IDs to combine them into a **single dropdown**:
+Displays a green checkmark with "Already pre-installed on your AMD Halo Developer Platform!" that expands to show manual installation instructions.
+
+**System setup** — Use `@setup` for configuration steps users need to perform:
 
 ```markdown
-<!-- @require:comfyui,pytorch -->
+<!-- @setup:memory_config -->
 ```
 
-Available dependencies are defined in `playbooks/dependencies/registry.json`. Each dependency has its own markdown file with OS-specific installation instructions.
-
-The dropdown displays with a green checkmark and the text "Already pre-installed on your AMD Halo Developer Platform!" When expanded, it shows a notice explaining the software is pre-configured, followed by manual installation instructions.
+Content displays directly since these are required steps, not optional reference info.
 
 ### Writing Tips
 
@@ -169,4 +177,4 @@ npm install    # first time only
 npm run dev
 ```
 
-Visit `http://localhost:3000/playbooks/<playbook-id>` to preview your playbook.
+Visit `http://localhost:3000/playbooks/<playbook-id>` to preview your playbook.

playbooks/backup/dify-ai-agents/README.md

@@ -0,0 +1,3 @@
+# Build Node Based AI Agents and RAG Workflows with Dify
+
+<!-- Playbook content goes here -->

playbooks/backup/dify-ai-agents/playbook.json

@@ -0,0 +1,12 @@
+{
+  "id": "dify-ai-agents",
+  "title": "Build Node Based AI Agents and RAG Workflows with Dify",
+  "description": "Create AI agents and RAG workflows using Dify's visual node editor with llama.cpp on your STX Halo™",
+  "time": 60,
+  "platforms": ["linux", "windows"],
+  "difficulty": "intermediate",
+  "isNew": false,
+  "isFeatured": false,
+  "published": true,
+  "tags": ["dify", "agents", "rag", "llamacpp", "workflows"]
+}

playbooks/backup/gguf-quantization-export/README.md

@@ -0,0 +1,3 @@
+# Quantize and Export Models to GGUF
+
+<!-- Playbook content goes here -->

playbooks/backup/gguf-quantization-export/playbook.json

@@ -0,0 +1,12 @@
+{
+  "id": "gguf-quantization-export",
+  "title": "Quantize and Export Models to GGUF",
+  "description": "Learn how to quantize and export models to GGUF format using llama.cpp on your STX Halo™",
+  "time": 60,
+  "platforms": ["linux", "windows"],
+  "difficulty": "intermediate",
+  "isNew": false,
+  "isFeatured": false,
+  "published": true,
+  "tags": ["gguf", "quantization", "llamacpp", "model-export"]
+}

…plemental/clustering-two-halos/README.md playbooks/backup/local-foundry/README.mdplaybooks/supplemental/clustering-two-halos/README.md renamed to playbooks/backup/local-foundry/README.md playbooks/supplemental/clustering-two-halos/README.md renamed to playbooks/backup/local-foundry/README.md

@@ -1,3 +1,3 @@
-# Clustering with two Halos
+# Local Foundry
 
 <!-- Playbook content goes here -->

playbooks/backup/local-foundry/playbook.json

@@ -0,0 +1,12 @@
+{
+  "id": "local-foundry",
+  "title": "Local Foundry",
+  "description": "Set up and use Local Foundry on your STX Halo™",
+  "time": 60,
+  "platforms": ["linux", "windows"],
+  "difficulty": "intermediate",
+  "isNew": true,
+  "isFeatured": false,
+  "published": true,
+  "tags": ["foundry", "local", "llm"]
+}

playbooks/backup/mcp-research-agent/README.md

@@ -0,0 +1,3 @@
+# Building a Research Agent Using MCP
+
+<!-- Playbook content goes here -->

playbooks/backup/mcp-research-agent/playbook.json

@@ -0,0 +1,12 @@
+{
+  "id": "mcp-research-agent",
+  "title": "Building a Research Agent Using MCP",
+  "description": "Build a research agent using the Model Context Protocol (MCP) on your STX Halo™",
+  "time": 60,
+  "platforms": ["linux", "windows"],
+  "difficulty": "intermediate",
+  "isNew": true,
+  "isFeatured": false,
+  "published": true,
+  "tags": ["mcp", "agents", "research", "llm"]
+}