From b5d36865eea198f242aa01aec86f6c608e501bf5 Mon Sep 17 00:00:00 2001
From: lmiranda <leobmiranda@gmail.com>
Date: Wed, 28 Jan 2026 17:24:49 -0500
Subject: [PATCH] feat(plugins): add Visual Output headers to all other plugin
 commands
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add single-line visual headers to 66 command files across 10 plugins:
- clarity-assist (2 commands): 💬
- claude-config-maintainer (5 commands): ⚙️
- cmdb-assistant (11 commands): 🖥️
- code-sentinel (3 commands): 🔒
- contract-validator (5 commands): ✅
- data-platform (10 commands): 📊
- doc-guardian (5 commands): 📝
- git-flow (8 commands): 🔀
- pr-review (7 commands): 🔍
- viz-platform (10 commands): 🎨

Each command now displays a consistent header at execution start:
┌────────────────────────────────────────────────────────────────┐
│  [icon] PLUGIN-NAME · Command Description                       │
└────────────────────────────────────────────────────────────────┘

Addresses #275 (other plugin commands visual output)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 plugins/clarity-assist/commands/clarify.md           | 12 ++++++++++++
 plugins/clarity-assist/commands/quick-clarify.md     | 12 ++++++++++++
 plugins/claude-config-maintainer/commands/analyze.md | 12 ++++++++++++
 .../claude-config-maintainer/commands/config-diff.md | 12 ++++++++++++
 .../claude-config-maintainer/commands/config-lint.md | 12 ++++++++++++
 plugins/claude-config-maintainer/commands/init.md    | 12 ++++++++++++
 .../claude-config-maintainer/commands/optimize.md    | 12 ++++++++++++
 plugins/cmdb-assistant/commands/change-audit.md      | 12 ++++++++++++
 plugins/cmdb-assistant/commands/cmdb-audit.md        | 12 ++++++++++++
 plugins/cmdb-assistant/commands/cmdb-device.md       | 12 ++++++++++++
 plugins/cmdb-assistant/commands/cmdb-ip.md           | 12 ++++++++++++
 plugins/cmdb-assistant/commands/cmdb-register.md     | 12 ++++++++++++
 plugins/cmdb-assistant/commands/cmdb-search.md       | 12 ++++++++++++
 plugins/cmdb-assistant/commands/cmdb-site.md         | 12 ++++++++++++
 plugins/cmdb-assistant/commands/cmdb-sync.md         | 12 ++++++++++++
 plugins/cmdb-assistant/commands/cmdb-topology.md     | 12 ++++++++++++
 plugins/cmdb-assistant/commands/initial-setup.md     | 12 ++++++++++++
 plugins/cmdb-assistant/commands/ip-conflicts.md      | 12 ++++++++++++
 plugins/code-sentinel/commands/refactor-dry.md       | 12 ++++++++++++
 plugins/code-sentinel/commands/refactor.md           | 12 ++++++++++++
 plugins/code-sentinel/commands/security-scan.md      | 12 ++++++++++++
 plugins/contract-validator/commands/check-agent.md   | 12 ++++++++++++
 .../contract-validator/commands/dependency-graph.md  | 12 ++++++++++++
 plugins/contract-validator/commands/initial-setup.md | 12 ++++++++++++
 .../contract-validator/commands/list-interfaces.md   | 12 ++++++++++++
 .../commands/validate-contracts.md                   | 12 ++++++++++++
 plugins/data-platform/commands/data-quality.md       | 12 ++++++++++++
 plugins/data-platform/commands/dbt-test.md           | 12 ++++++++++++
 plugins/data-platform/commands/explain.md            | 12 ++++++++++++
 plugins/data-platform/commands/ingest.md             | 12 ++++++++++++
 plugins/data-platform/commands/initial-setup.md      | 12 ++++++++++++
 plugins/data-platform/commands/lineage-viz.md        | 12 ++++++++++++
 plugins/data-platform/commands/lineage.md            | 12 ++++++++++++
 plugins/data-platform/commands/profile.md            | 12 ++++++++++++
 plugins/data-platform/commands/run.md                | 12 ++++++++++++
 plugins/data-platform/commands/schema.md             | 12 ++++++++++++
 plugins/doc-guardian/commands/changelog-gen.md       | 12 ++++++++++++
 plugins/doc-guardian/commands/doc-audit.md           | 12 ++++++++++++
 plugins/doc-guardian/commands/doc-coverage.md        | 12 ++++++++++++
 plugins/doc-guardian/commands/doc-sync.md            | 12 ++++++++++++
 plugins/doc-guardian/commands/stale-docs.md          | 12 ++++++++++++
 plugins/git-flow/commands/branch-cleanup.md          | 12 ++++++++++++
 plugins/git-flow/commands/branch-start.md            | 12 ++++++++++++
 plugins/git-flow/commands/commit-merge.md            | 12 ++++++++++++
 plugins/git-flow/commands/commit-push.md             | 12 ++++++++++++
 plugins/git-flow/commands/commit-sync.md             | 12 ++++++++++++
 plugins/git-flow/commands/commit.md                  | 12 ++++++++++++
 plugins/git-flow/commands/git-config.md              | 12 ++++++++++++
 plugins/git-flow/commands/git-status.md              | 12 ++++++++++++
 plugins/pr-review/commands/initial-setup.md          | 12 ++++++++++++
 plugins/pr-review/commands/pr-diff.md                | 12 ++++++++++++
 plugins/pr-review/commands/pr-findings.md            | 12 ++++++++++++
 plugins/pr-review/commands/pr-review.md              | 12 ++++++++++++
 plugins/pr-review/commands/pr-summary.md             | 12 ++++++++++++
 plugins/pr-review/commands/project-init.md           | 12 ++++++++++++
 plugins/pr-review/commands/project-sync.md           | 12 ++++++++++++
 plugins/viz-platform/commands/accessibility-check.md | 12 ++++++++++++
 plugins/viz-platform/commands/breakpoints.md         | 12 ++++++++++++
 plugins/viz-platform/commands/chart-export.md        | 12 ++++++++++++
 plugins/viz-platform/commands/chart.md               | 12 ++++++++++++
 plugins/viz-platform/commands/component.md           | 12 ++++++++++++
 plugins/viz-platform/commands/dashboard.md           | 12 ++++++++++++
 plugins/viz-platform/commands/initial-setup.md       | 12 ++++++++++++
 plugins/viz-platform/commands/theme-css.md           | 12 ++++++++++++
 plugins/viz-platform/commands/theme-new.md           | 12 ++++++++++++
 plugins/viz-platform/commands/theme.md               | 12 ++++++++++++
 66 files changed, 792 insertions(+)

diff --git a/plugins/clarity-assist/commands/clarify.md b/plugins/clarity-assist/commands/clarify.md
index 13088cb..3069b36 100644
--- a/plugins/clarity-assist/commands/clarify.md
+++ b/plugins/clarity-assist/commands/clarify.md
@@ -1,5 +1,17 @@
 # /clarify - Full Prompt Optimization
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  💬 CLARITY-ASSIST · Prompt Optimization                         │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the workflow.
+
 ## Purpose
 
 Transform vague, incomplete, or ambiguous requests into clear, actionable specifications using the 4-D methodology with neurodivergent-friendly accommodations.
diff --git a/plugins/clarity-assist/commands/quick-clarify.md b/plugins/clarity-assist/commands/quick-clarify.md
index 47890cf..9f331b8 100644
--- a/plugins/clarity-assist/commands/quick-clarify.md
+++ b/plugins/clarity-assist/commands/quick-clarify.md
@@ -1,5 +1,17 @@
 # /quick-clarify - Rapid Clarification Mode
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  💬 CLARITY-ASSIST · Quick Clarify                               │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the workflow.
+
 ## Purpose
 
 Single-pass clarification for requests that are mostly clear but need minor disambiguation.
diff --git a/plugins/claude-config-maintainer/commands/analyze.md b/plugins/claude-config-maintainer/commands/analyze.md
index 03349de..df914a9 100644
--- a/plugins/claude-config-maintainer/commands/analyze.md
+++ b/plugins/claude-config-maintainer/commands/analyze.md
@@ -6,6 +6,18 @@ description: Analyze CLAUDE.md for optimization opportunities and plugin integra
 
 This command analyzes your project's CLAUDE.md file and provides a detailed report on optimization opportunities and plugin integration status.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  ⚙️ CONFIG-MAINTAINER · CLAUDE.md Analysis                       │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the analysis.
+
 ## What This Command Does
 
 1. **Read CLAUDE.md** - Locates and reads the project's CLAUDE.md file
diff --git a/plugins/claude-config-maintainer/commands/config-diff.md b/plugins/claude-config-maintainer/commands/config-diff.md
index b612518..c2372ae 100644
--- a/plugins/claude-config-maintainer/commands/config-diff.md
+++ b/plugins/claude-config-maintainer/commands/config-diff.md
@@ -6,6 +6,18 @@ description: Show diff between current CLAUDE.md and last commit
 
 This command shows differences between your current CLAUDE.md file and previous versions, helping track configuration drift and review changes before committing.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  ⚙️ CONFIG-MAINTAINER · CLAUDE.md Diff                           │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the diff.
+
 ## What This Command Does
 
 1. **Detect CLAUDE.md Location** - Finds the project's CLAUDE.md file
diff --git a/plugins/claude-config-maintainer/commands/config-lint.md b/plugins/claude-config-maintainer/commands/config-lint.md
index fd530fb..232efab 100644
--- a/plugins/claude-config-maintainer/commands/config-lint.md
+++ b/plugins/claude-config-maintainer/commands/config-lint.md
@@ -6,6 +6,18 @@ description: Lint CLAUDE.md for common anti-patterns and best practices
 
 This command checks your CLAUDE.md file against best practices and detects common anti-patterns that can cause issues with Claude Code.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  ⚙️ CONFIG-MAINTAINER · CLAUDE.md Lint                           │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the linting.
+
 ## What This Command Does
 
 1. **Parse Structure** - Validates markdown structure and hierarchy
diff --git a/plugins/claude-config-maintainer/commands/init.md b/plugins/claude-config-maintainer/commands/init.md
index 128e602..1f88107 100644
--- a/plugins/claude-config-maintainer/commands/init.md
+++ b/plugins/claude-config-maintainer/commands/init.md
@@ -6,6 +6,18 @@ description: Initialize a new CLAUDE.md file for a project
 
 This command creates a new CLAUDE.md file tailored to your project, gathering context and generating appropriate content.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  ⚙️ CONFIG-MAINTAINER · CLAUDE.md Initialization                 │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the initialization.
+
 ## What This Command Does
 
 1. **Gather Context** - Analyzes project structure and asks clarifying questions
diff --git a/plugins/claude-config-maintainer/commands/optimize.md b/plugins/claude-config-maintainer/commands/optimize.md
index 3c36128..1f13c4f 100644
--- a/plugins/claude-config-maintainer/commands/optimize.md
+++ b/plugins/claude-config-maintainer/commands/optimize.md
@@ -6,6 +6,18 @@ description: Optimize CLAUDE.md structure and content
 
 This command automatically optimizes your project's CLAUDE.md file based on best practices and identified issues.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  ⚙️ CONFIG-MAINTAINER · CLAUDE.md Optimization                   │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the optimization.
+
 ## What This Command Does
 
 1. **Analyze Current File** - Identifies all optimization opportunities
diff --git a/plugins/cmdb-assistant/commands/change-audit.md b/plugins/cmdb-assistant/commands/change-audit.md
index d84e607..1c4de44 100644
--- a/plugins/cmdb-assistant/commands/change-audit.md
+++ b/plugins/cmdb-assistant/commands/change-audit.md
@@ -4,6 +4,18 @@ description: Audit NetBox changes with filtering by date, user, or object type
 
 # CMDB Change Audit
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · Change Audit                                │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the audit.
+
 Query and analyze the NetBox audit log for change tracking and compliance.
 
 ## Usage
diff --git a/plugins/cmdb-assistant/commands/cmdb-audit.md b/plugins/cmdb-assistant/commands/cmdb-audit.md
index 4cf9929..0832484 100644
--- a/plugins/cmdb-assistant/commands/cmdb-audit.md
+++ b/plugins/cmdb-assistant/commands/cmdb-audit.md
@@ -4,6 +4,18 @@ description: Audit NetBox data quality and identify consistency issues
 
 # CMDB Data Quality Audit
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · Data Quality Audit                          │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the audit.
+
 Analyze NetBox data for quality issues and best practice violations.
 
 ## Usage
diff --git a/plugins/cmdb-assistant/commands/cmdb-device.md b/plugins/cmdb-assistant/commands/cmdb-device.md
index 13e6a2d..42dd7e5 100644
--- a/plugins/cmdb-assistant/commands/cmdb-device.md
+++ b/plugins/cmdb-assistant/commands/cmdb-device.md
@@ -1,5 +1,17 @@
 # CMDB Device Management
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · Device Management                           │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the operation.
+
 Manage network devices in NetBox - create, view, update, or delete.
 
 ## Usage
diff --git a/plugins/cmdb-assistant/commands/cmdb-ip.md b/plugins/cmdb-assistant/commands/cmdb-ip.md
index fc01a1e..f1826e7 100644
--- a/plugins/cmdb-assistant/commands/cmdb-ip.md
+++ b/plugins/cmdb-assistant/commands/cmdb-ip.md
@@ -1,5 +1,17 @@
 # CMDB IP Management
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · IP Management                               │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the operation.
+
 Manage IP addresses and prefixes in NetBox.
 
 ## Usage
diff --git a/plugins/cmdb-assistant/commands/cmdb-register.md b/plugins/cmdb-assistant/commands/cmdb-register.md
index bd8d62f..3cd4a1d 100644
--- a/plugins/cmdb-assistant/commands/cmdb-register.md
+++ b/plugins/cmdb-assistant/commands/cmdb-register.md
@@ -4,6 +4,18 @@ description: Register the current machine into NetBox with all running applicati
 
 # CMDB Machine Registration
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · Machine Registration                        │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the registration.
+
 Register the current machine into NetBox, including hardware info, network interfaces, and running applications (Docker containers, services).
 
 ## Usage
diff --git a/plugins/cmdb-assistant/commands/cmdb-search.md b/plugins/cmdb-assistant/commands/cmdb-search.md
index 7c4a5f4..b1ac8b2 100644
--- a/plugins/cmdb-assistant/commands/cmdb-search.md
+++ b/plugins/cmdb-assistant/commands/cmdb-search.md
@@ -1,5 +1,17 @@
 # CMDB Search
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · Search                                      │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the search.
+
 Search NetBox for devices, IPs, sites, or any CMDB object.
 
 ## Usage
diff --git a/plugins/cmdb-assistant/commands/cmdb-site.md b/plugins/cmdb-assistant/commands/cmdb-site.md
index d8421de..1b9dbf0 100644
--- a/plugins/cmdb-assistant/commands/cmdb-site.md
+++ b/plugins/cmdb-assistant/commands/cmdb-site.md
@@ -1,5 +1,17 @@
 # CMDB Site Management
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · Site Management                             │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the operation.
+
 Manage sites and locations in NetBox.
 
 ## Usage
diff --git a/plugins/cmdb-assistant/commands/cmdb-sync.md b/plugins/cmdb-assistant/commands/cmdb-sync.md
index 1311019..e5db01a 100644
--- a/plugins/cmdb-assistant/commands/cmdb-sync.md
+++ b/plugins/cmdb-assistant/commands/cmdb-sync.md
@@ -4,6 +4,18 @@ description: Synchronize current machine state with existing NetBox record
 
 # CMDB Machine Sync
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · Machine Sync                                │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the synchronization.
+
 Update an existing NetBox device record with the current machine state. Compares local system information with NetBox and applies changes.
 
 ## Usage
diff --git a/plugins/cmdb-assistant/commands/cmdb-topology.md b/plugins/cmdb-assistant/commands/cmdb-topology.md
index 427c067..9572370 100644
--- a/plugins/cmdb-assistant/commands/cmdb-topology.md
+++ b/plugins/cmdb-assistant/commands/cmdb-topology.md
@@ -4,6 +4,18 @@ description: Generate infrastructure topology diagrams from NetBox data
 
 # CMDB Topology Visualization
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · Topology                                    │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the visualization.
+
 Generate Mermaid diagrams showing infrastructure topology from NetBox.
 
 ## Usage
diff --git a/plugins/cmdb-assistant/commands/initial-setup.md b/plugins/cmdb-assistant/commands/initial-setup.md
index 7ceaec6..df189dc 100644
--- a/plugins/cmdb-assistant/commands/initial-setup.md
+++ b/plugins/cmdb-assistant/commands/initial-setup.md
@@ -4,6 +4,18 @@ description: Interactive setup wizard for cmdb-assistant plugin - configures Net
 
 # CMDB Assistant Setup Wizard
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · Setup Wizard                                │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the setup.
+
 This command sets up the cmdb-assistant plugin with NetBox integration.
 
 ## Important Context
diff --git a/plugins/cmdb-assistant/commands/ip-conflicts.md b/plugins/cmdb-assistant/commands/ip-conflicts.md
index 614b72d..1d8d437 100644
--- a/plugins/cmdb-assistant/commands/ip-conflicts.md
+++ b/plugins/cmdb-assistant/commands/ip-conflicts.md
@@ -4,6 +4,18 @@ description: Detect IP address conflicts and overlapping prefixes in NetBox
 
 # CMDB IP Conflict Detection
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🖥️ CMDB-ASSISTANT · IP Conflict Detection                       │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the analysis.
+
 Scan NetBox IPAM data to identify IP address conflicts and overlapping prefixes.
 
 ## Usage
diff --git a/plugins/code-sentinel/commands/refactor-dry.md b/plugins/code-sentinel/commands/refactor-dry.md
index 720923a..91dcc94 100644
--- a/plugins/code-sentinel/commands/refactor-dry.md
+++ b/plugins/code-sentinel/commands/refactor-dry.md
@@ -6,6 +6,18 @@ description: Preview refactoring changes without applying them
 
 Analyze and preview refactoring opportunities without making changes.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔒 CODE-SENTINEL · Refactor Preview                             │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the analysis.
+
 ## Usage
 ```
 /refactor-dry <target> [--all]
diff --git a/plugins/code-sentinel/commands/refactor.md b/plugins/code-sentinel/commands/refactor.md
index 095617c..319767e 100644
--- a/plugins/code-sentinel/commands/refactor.md
+++ b/plugins/code-sentinel/commands/refactor.md
@@ -6,6 +6,18 @@ description: Apply refactoring patterns to improve code structure and maintainab
 
 Apply refactoring transformations to specified code.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔒 CODE-SENTINEL · Refactor                                     │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the refactoring workflow.
+
 ## Usage
 ```
 /refactor <target> [--pattern=<pattern>]
diff --git a/plugins/code-sentinel/commands/security-scan.md b/plugins/code-sentinel/commands/security-scan.md
index f4a9571..a92ef9b 100644
--- a/plugins/code-sentinel/commands/security-scan.md
+++ b/plugins/code-sentinel/commands/security-scan.md
@@ -6,6 +6,18 @@ description: Full security audit of codebase - scans all files for vulnerability
 
 Comprehensive security audit of the project.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔒 CODE-SENTINEL · Security Scan                                │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the scan workflow.
+
 ## Process
 
 1. **File Discovery**
diff --git a/plugins/contract-validator/commands/check-agent.md b/plugins/contract-validator/commands/check-agent.md
index c6061be..15ca4b6 100644
--- a/plugins/contract-validator/commands/check-agent.md
+++ b/plugins/contract-validator/commands/check-agent.md
@@ -1,5 +1,17 @@
 # /check-agent - Validate Agent Definition
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  ✅ CONTRACT-VALIDATOR · Agent Check                              │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the validation.
+
 Validate a single agent's tool references and data flow.
 
 ## Usage
diff --git a/plugins/contract-validator/commands/dependency-graph.md b/plugins/contract-validator/commands/dependency-graph.md
index 01c1d0b..b7520ac 100644
--- a/plugins/contract-validator/commands/dependency-graph.md
+++ b/plugins/contract-validator/commands/dependency-graph.md
@@ -1,5 +1,17 @@
 # /dependency-graph - Generate Dependency Visualization
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  ✅ CONTRACT-VALIDATOR · Dependency Graph                         │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the visualization.
+
 Generate a Mermaid flowchart showing plugin dependencies, data flows, and tool relationships.
 
 ## Usage
diff --git a/plugins/contract-validator/commands/initial-setup.md b/plugins/contract-validator/commands/initial-setup.md
index d04c961..9b77f46 100644
--- a/plugins/contract-validator/commands/initial-setup.md
+++ b/plugins/contract-validator/commands/initial-setup.md
@@ -4,6 +4,18 @@ description: Interactive setup wizard for contract-validator plugin - verifies M
 
 # Contract-Validator Setup Wizard
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  ✅ CONTRACT-VALIDATOR · Setup Wizard                             │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the setup.
+
 This command sets up the contract-validator plugin for cross-plugin compatibility validation.
 
 ## Important Context
diff --git a/plugins/contract-validator/commands/list-interfaces.md b/plugins/contract-validator/commands/list-interfaces.md
index b9a9667..b2dd4cc 100644
--- a/plugins/contract-validator/commands/list-interfaces.md
+++ b/plugins/contract-validator/commands/list-interfaces.md
@@ -1,5 +1,17 @@
 # /list-interfaces - Show Plugin Interfaces
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  ✅ CONTRACT-VALIDATOR · List Interfaces                         │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the interface listing.
+
 Display what each plugin in the marketplace produces and accepts.
 
 ## Usage
diff --git a/plugins/contract-validator/commands/validate-contracts.md b/plugins/contract-validator/commands/validate-contracts.md
index a4f57b5..5d5067a 100644
--- a/plugins/contract-validator/commands/validate-contracts.md
+++ b/plugins/contract-validator/commands/validate-contracts.md
@@ -1,5 +1,17 @@
 # /validate-contracts - Full Contract Validation
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  ✅ CONTRACT-VALIDATOR · Full Validation                         │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the validation.
+
 Run comprehensive cross-plugin compatibility validation for the entire marketplace.
 
 ## Usage
diff --git a/plugins/data-platform/commands/data-quality.md b/plugins/data-platform/commands/data-quality.md
index 9d6cf3b..cfc8d3c 100644
--- a/plugins/data-platform/commands/data-quality.md
+++ b/plugins/data-platform/commands/data-quality.md
@@ -1,5 +1,17 @@
 # /data-quality - Data Quality Assessment
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📊 DATA-PLATFORM · Data Quality                                  │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the assessment.
+
 Comprehensive data quality check for DataFrames with pass/warn/fail scoring.
 
 ## Usage
diff --git a/plugins/data-platform/commands/dbt-test.md b/plugins/data-platform/commands/dbt-test.md
index 31f889a..a1b8f38 100644
--- a/plugins/data-platform/commands/dbt-test.md
+++ b/plugins/data-platform/commands/dbt-test.md
@@ -1,5 +1,17 @@
 # /dbt-test - Run dbt Tests
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📊 DATA-PLATFORM · dbt Tests                                     │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the tests.
+
 Execute dbt tests with formatted pass/fail results.
 
 ## Usage
diff --git a/plugins/data-platform/commands/explain.md b/plugins/data-platform/commands/explain.md
index 28a9c0a..2f149ae 100644
--- a/plugins/data-platform/commands/explain.md
+++ b/plugins/data-platform/commands/explain.md
@@ -1,5 +1,17 @@
 # /explain - dbt Model Explanation
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📊 DATA-PLATFORM · Model Explanation                             │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the explanation.
+
 Explain a dbt model's purpose, dependencies, and SQL logic.
 
 ## Usage
diff --git a/plugins/data-platform/commands/ingest.md b/plugins/data-platform/commands/ingest.md
index c21592b..c7b2067 100644
--- a/plugins/data-platform/commands/ingest.md
+++ b/plugins/data-platform/commands/ingest.md
@@ -1,5 +1,17 @@
 # /ingest - Data Ingestion
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📊 DATA-PLATFORM · Ingest                                        │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the ingestion.
+
 Load data from files or database into the data platform.
 
 ## Usage
diff --git a/plugins/data-platform/commands/initial-setup.md b/plugins/data-platform/commands/initial-setup.md
index cf6649c..9f9b623 100644
--- a/plugins/data-platform/commands/initial-setup.md
+++ b/plugins/data-platform/commands/initial-setup.md
@@ -4,6 +4,18 @@ description: Interactive setup wizard for data-platform plugin - configures MCP
 
 # Data Platform Setup Wizard
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📊 DATA-PLATFORM · Setup Wizard                                  │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the setup.
+
 This command sets up the data-platform plugin with pandas, PostgreSQL, and dbt integration.
 
 ## Important Context
diff --git a/plugins/data-platform/commands/lineage-viz.md b/plugins/data-platform/commands/lineage-viz.md
index 949e711..50bad3a 100644
--- a/plugins/data-platform/commands/lineage-viz.md
+++ b/plugins/data-platform/commands/lineage-viz.md
@@ -1,5 +1,17 @@
 # /lineage-viz - Mermaid Lineage Visualization
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📊 DATA-PLATFORM · Lineage Visualization                         │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the visualization.
+
 Generate Mermaid flowchart syntax for dbt model lineage.
 
 ## Usage
diff --git a/plugins/data-platform/commands/lineage.md b/plugins/data-platform/commands/lineage.md
index b41f4bb..496937d 100644
--- a/plugins/data-platform/commands/lineage.md
+++ b/plugins/data-platform/commands/lineage.md
@@ -1,5 +1,17 @@
 # /lineage - Data Lineage Visualization
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📊 DATA-PLATFORM · Lineage                                       │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the visualization.
+
 Show data lineage for dbt models or database tables.
 
 ## Usage
diff --git a/plugins/data-platform/commands/profile.md b/plugins/data-platform/commands/profile.md
index 5382c91..c8f85cd 100644
--- a/plugins/data-platform/commands/profile.md
+++ b/plugins/data-platform/commands/profile.md
@@ -1,5 +1,17 @@
 # /profile - Data Profiling
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📊 DATA-PLATFORM · Data Profile                                  │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the profiling.
+
 Generate statistical profile and quality report for a DataFrame.
 
 ## Usage
diff --git a/plugins/data-platform/commands/run.md b/plugins/data-platform/commands/run.md
index c80f6b5..0698a1f 100644
--- a/plugins/data-platform/commands/run.md
+++ b/plugins/data-platform/commands/run.md
@@ -1,5 +1,17 @@
 # /run - Execute dbt Models
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📊 DATA-PLATFORM · dbt Run                                       │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the execution.
+
 Run dbt models with automatic pre-validation.
 
 ## Usage
diff --git a/plugins/data-platform/commands/schema.md b/plugins/data-platform/commands/schema.md
index e79cf75..75c23ce 100644
--- a/plugins/data-platform/commands/schema.md
+++ b/plugins/data-platform/commands/schema.md
@@ -1,5 +1,17 @@
 # /schema - Schema Exploration
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📊 DATA-PLATFORM · Schema Explorer                               │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the exploration.
+
 Display schema information for database tables or DataFrames.
 
 ## Usage
diff --git a/plugins/doc-guardian/commands/changelog-gen.md b/plugins/doc-guardian/commands/changelog-gen.md
index 07ea113..381f058 100644
--- a/plugins/doc-guardian/commands/changelog-gen.md
+++ b/plugins/doc-guardian/commands/changelog-gen.md
@@ -6,6 +6,18 @@ description: Generate changelog from conventional commits in Keep-a-Changelog fo
 
 Generate a changelog entry from conventional commits.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📝 DOC-GUARDIAN · Changelog Generation                          │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the generation.
+
 ## Process
 
 1. **Identify Commit Range**
diff --git a/plugins/doc-guardian/commands/doc-audit.md b/plugins/doc-guardian/commands/doc-audit.md
index 20e4aed..c87d1fd 100644
--- a/plugins/doc-guardian/commands/doc-audit.md
+++ b/plugins/doc-guardian/commands/doc-audit.md
@@ -6,6 +6,18 @@ description: Full documentation audit - scans entire project for doc drift witho
 
 Perform a comprehensive documentation drift analysis.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📝 DOC-GUARDIAN · Documentation Audit                          │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the audit.
+
 ## Process
 
 1. **Inventory Documentation Files**
diff --git a/plugins/doc-guardian/commands/doc-coverage.md b/plugins/doc-guardian/commands/doc-coverage.md
index 500766e..286959c 100644
--- a/plugins/doc-guardian/commands/doc-coverage.md
+++ b/plugins/doc-guardian/commands/doc-coverage.md
@@ -6,6 +6,18 @@ description: Calculate documentation coverage percentage for functions and class
 
 Analyze codebase to calculate documentation coverage metrics.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📝 DOC-GUARDIAN · Documentation Coverage                        │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the analysis.
+
 ## Process
 
 1. **Scan Source Files**
diff --git a/plugins/doc-guardian/commands/doc-sync.md b/plugins/doc-guardian/commands/doc-sync.md
index 02803bf..5805a1f 100644
--- a/plugins/doc-guardian/commands/doc-sync.md
+++ b/plugins/doc-guardian/commands/doc-sync.md
@@ -6,6 +6,18 @@ description: Synchronize all pending documentation updates in a single commit
 
 Apply all pending documentation updates detected by doc-guardian hooks.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📝 DOC-GUARDIAN · Documentation Sync                            │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the sync.
+
 ## Process
 
 1. **Review Pending Queue**
diff --git a/plugins/doc-guardian/commands/stale-docs.md b/plugins/doc-guardian/commands/stale-docs.md
index fff8b8d..95dd004 100644
--- a/plugins/doc-guardian/commands/stale-docs.md
+++ b/plugins/doc-guardian/commands/stale-docs.md
@@ -6,6 +6,18 @@ description: Detect documentation files that are stale relative to their associa
 
 Identify documentation files that may be outdated based on commit history.
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  📝 DOC-GUARDIAN · Stale Documentation Check                     │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the check.
+
 ## Process
 
 1. **Map Documentation to Code**
diff --git a/plugins/git-flow/commands/branch-cleanup.md b/plugins/git-flow/commands/branch-cleanup.md
index ea1194d..fc4c19a 100644
--- a/plugins/git-flow/commands/branch-cleanup.md
+++ b/plugins/git-flow/commands/branch-cleanup.md
@@ -1,5 +1,17 @@
 # /branch-cleanup - Clean Merged and Stale Branches
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔀 GIT-FLOW · Branch Cleanup                                     │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the workflow.
+
 ## Purpose
 
 Remove branches that have been merged OR whose remote tracking branch no longer exists, both locally and optionally on remote.
diff --git a/plugins/git-flow/commands/branch-start.md b/plugins/git-flow/commands/branch-start.md
index ceb099f..d5d198c 100644
--- a/plugins/git-flow/commands/branch-start.md
+++ b/plugins/git-flow/commands/branch-start.md
@@ -1,5 +1,17 @@
 # /branch-start - Start New Branch
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔀 GIT-FLOW · Branch Start                                      │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the workflow.
+
 ## Purpose
 
 Create a new feature/fix/chore branch with consistent naming conventions.
diff --git a/plugins/git-flow/commands/commit-merge.md b/plugins/git-flow/commands/commit-merge.md
index c019af5..91ba960 100644
--- a/plugins/git-flow/commands/commit-merge.md
+++ b/plugins/git-flow/commands/commit-merge.md
@@ -1,5 +1,17 @@
 # /commit-merge - Commit and Merge
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔀 GIT-FLOW · Commit & Merge                                     │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the workflow.
+
 ## Purpose
 
 Commit current changes, then merge the current branch into a target branch.
diff --git a/plugins/git-flow/commands/commit-push.md b/plugins/git-flow/commands/commit-push.md
index 6255ca2..de552e8 100644
--- a/plugins/git-flow/commands/commit-push.md
+++ b/plugins/git-flow/commands/commit-push.md
@@ -1,5 +1,17 @@
 # /commit-push - Commit and Push
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔀 GIT-FLOW · Commit & Push                                      │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the workflow.
+
 ## Purpose
 
 Create a commit and push to the remote repository in one operation.
diff --git a/plugins/git-flow/commands/commit-sync.md b/plugins/git-flow/commands/commit-sync.md
index d177d23..d8ad0f1 100644
--- a/plugins/git-flow/commands/commit-sync.md
+++ b/plugins/git-flow/commands/commit-sync.md
@@ -1,5 +1,17 @@
 # /commit-sync - Commit, Push, and Sync
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔀 GIT-FLOW · Commit Sync                                        │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the workflow.
+
 ## Purpose
 
 Full sync operation: commit local changes, push to remote, sync with upstream/base branch, and clean up stale remote-tracking branches.
diff --git a/plugins/git-flow/commands/commit.md b/plugins/git-flow/commands/commit.md
index 86fb0df..abb96de 100644
--- a/plugins/git-flow/commands/commit.md
+++ b/plugins/git-flow/commands/commit.md
@@ -1,5 +1,17 @@
 # /commit - Smart Commit
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔀 GIT-FLOW · Smart Commit                                      │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the commit workflow.
+
 ## Purpose
 
 Create a git commit with an auto-generated conventional commit message based on staged changes.
diff --git a/plugins/git-flow/commands/git-config.md b/plugins/git-flow/commands/git-config.md
index 2699da9..a9d19fe 100644
--- a/plugins/git-flow/commands/git-config.md
+++ b/plugins/git-flow/commands/git-config.md
@@ -1,5 +1,17 @@
 # /git-config - Configure git-flow
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔀 GIT-FLOW · Configuration                                      │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the configuration.
+
 ## Purpose
 
 Configure git-flow settings for the current project.
diff --git a/plugins/git-flow/commands/git-status.md b/plugins/git-flow/commands/git-status.md
index 8617443..16786fa 100644
--- a/plugins/git-flow/commands/git-status.md
+++ b/plugins/git-flow/commands/git-status.md
@@ -1,5 +1,17 @@
 # /git-status - Enhanced Status
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔀 GIT-FLOW · Status                                             │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the status display.
+
 ## Purpose
 
 Show comprehensive git status with recommendations and insights.
diff --git a/plugins/pr-review/commands/initial-setup.md b/plugins/pr-review/commands/initial-setup.md
index 6be1847..32dc619 100644
--- a/plugins/pr-review/commands/initial-setup.md
+++ b/plugins/pr-review/commands/initial-setup.md
@@ -4,6 +4,18 @@ description: Interactive setup wizard for pr-review plugin - configures Gitea MC
 
 # PR Review Setup Wizard
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔍 PR-REVIEW · Setup Wizard                                      │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the setup.
+
 This command sets up the pr-review plugin. It shares the Gitea MCP server with projman, so if you've already run `/initial-setup` for projman, most of the work is done.
 
 ## Important Context
diff --git a/plugins/pr-review/commands/pr-diff.md b/plugins/pr-review/commands/pr-diff.md
index 346b02e..52ab643 100644
--- a/plugins/pr-review/commands/pr-diff.md
+++ b/plugins/pr-review/commands/pr-diff.md
@@ -1,5 +1,17 @@
 # /pr-diff - Annotated PR Diff Viewer
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔍 PR-REVIEW · Diff Viewer                                       │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the diff display.
+
 ## Purpose
 
 Display the PR diff with inline annotations from review comments, making it easy to see what feedback has been given alongside the code changes.
diff --git a/plugins/pr-review/commands/pr-findings.md b/plugins/pr-review/commands/pr-findings.md
index 2c2e136..00f9b9f 100644
--- a/plugins/pr-review/commands/pr-findings.md
+++ b/plugins/pr-review/commands/pr-findings.md
@@ -1,5 +1,17 @@
 # /pr-findings - Filter Review Findings
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔍 PR-REVIEW · Findings                                          │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the findings display.
+
 ## Purpose
 
 List and filter findings from a previous PR review by category, severity, or confidence level.
diff --git a/plugins/pr-review/commands/pr-review.md b/plugins/pr-review/commands/pr-review.md
index 053e3ae..e6ae203 100644
--- a/plugins/pr-review/commands/pr-review.md
+++ b/plugins/pr-review/commands/pr-review.md
@@ -1,5 +1,17 @@
 # /pr-review - Full Multi-Agent Review
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔍 PR-REVIEW · Full Review                                       │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the review.
+
 ## Purpose
 
 Conduct a comprehensive pull request review using specialized agents for security, performance, maintainability, and test coverage.
diff --git a/plugins/pr-review/commands/pr-summary.md b/plugins/pr-review/commands/pr-summary.md
index dd00e89..02eaa6e 100644
--- a/plugins/pr-review/commands/pr-summary.md
+++ b/plugins/pr-review/commands/pr-summary.md
@@ -1,5 +1,17 @@
 # /pr-summary - Quick PR Summary
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔍 PR-REVIEW · Quick Summary                                     │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the summary.
+
 ## Purpose
 
 Generate a quick summary of PR changes without conducting a full multi-agent review.
diff --git a/plugins/pr-review/commands/project-init.md b/plugins/pr-review/commands/project-init.md
index b1d6af7..d5d0885 100644
--- a/plugins/pr-review/commands/project-init.md
+++ b/plugins/pr-review/commands/project-init.md
@@ -4,6 +4,18 @@ description: Quick project setup - configures only project-level settings for PR
 
 # Project Initialization (PR Review)
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔍 PR-REVIEW · Project Setup                                     │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the setup.
+
 Fast setup for a new project when system-level configuration is already complete.
 
 **Use this when:**
diff --git a/plugins/pr-review/commands/project-sync.md b/plugins/pr-review/commands/project-sync.md
index c082e31..caa30f8 100644
--- a/plugins/pr-review/commands/project-sync.md
+++ b/plugins/pr-review/commands/project-sync.md
@@ -4,6 +4,18 @@ description: Sync project configuration with current git remote - use after chan
 
 # Project Sync (PR Review)
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🔍 PR-REVIEW · Project Sync                                      │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the synchronization.
+
 Updates project configuration when the git remote URL has changed.
 
 **Use this when:**
diff --git a/plugins/viz-platform/commands/accessibility-check.md b/plugins/viz-platform/commands/accessibility-check.md
index c446f79..e1cd65f 100644
--- a/plugins/viz-platform/commands/accessibility-check.md
+++ b/plugins/viz-platform/commands/accessibility-check.md
@@ -4,6 +4,18 @@ description: Validate color accessibility for color blind users
 
 # Accessibility Check
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🎨 VIZ-PLATFORM · Accessibility Check                            │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the accessibility validation.
+
 Validate theme or chart colors for color blind accessibility, checking contrast ratios and suggesting alternatives.
 
 ## Usage
diff --git a/plugins/viz-platform/commands/breakpoints.md b/plugins/viz-platform/commands/breakpoints.md
index e86539e..02d9a9f 100644
--- a/plugins/viz-platform/commands/breakpoints.md
+++ b/plugins/viz-platform/commands/breakpoints.md
@@ -4,6 +4,18 @@ description: Configure responsive breakpoints for dashboard layouts
 
 # Configure Breakpoints
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🎨 VIZ-PLATFORM · Breakpoints                                    │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the configuration.
+
 Configure responsive breakpoints for a layout to support mobile-first design across different screen sizes.
 
 ## Usage
diff --git a/plugins/viz-platform/commands/chart-export.md b/plugins/viz-platform/commands/chart-export.md
index 16f15f0..d2eab1a 100644
--- a/plugins/viz-platform/commands/chart-export.md
+++ b/plugins/viz-platform/commands/chart-export.md
@@ -4,6 +4,18 @@ description: Export a Plotly chart to PNG, SVG, or PDF format
 
 # Export Chart
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🎨 VIZ-PLATFORM · Chart Export                                   │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the export.
+
 Export a Plotly chart to static image formats for sharing, embedding, or printing.
 
 ## Usage
diff --git a/plugins/viz-platform/commands/chart.md b/plugins/viz-platform/commands/chart.md
index 8901cd9..5f98443 100644
--- a/plugins/viz-platform/commands/chart.md
+++ b/plugins/viz-platform/commands/chart.md
@@ -4,6 +4,18 @@ description: Create a Plotly chart with theme integration
 
 # Create Chart
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🎨 VIZ-PLATFORM · Chart Builder                                  │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the chart creation.
+
 Create a Plotly chart with automatic theme token application.
 
 ## Usage
diff --git a/plugins/viz-platform/commands/component.md b/plugins/viz-platform/commands/component.md
index c268f9b..66ef550 100644
--- a/plugins/viz-platform/commands/component.md
+++ b/plugins/viz-platform/commands/component.md
@@ -4,6 +4,18 @@ description: Inspect Dash Mantine Component props and validation
 
 # Inspect Component
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🎨 VIZ-PLATFORM · Component Inspector                            │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the inspection.
+
 Inspect a Dash Mantine Component's available props, types, and defaults.
 
 ## Usage
diff --git a/plugins/viz-platform/commands/dashboard.md b/plugins/viz-platform/commands/dashboard.md
index 7432252..531d227 100644
--- a/plugins/viz-platform/commands/dashboard.md
+++ b/plugins/viz-platform/commands/dashboard.md
@@ -4,6 +4,18 @@ description: Create a dashboard layout with the layout-builder agent
 
 # Create Dashboard
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🎨 VIZ-PLATFORM · Dashboard Builder                              │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the dashboard creation.
+
 Create a dashboard layout structure with filters, grids, and sections.
 
 ## Usage
diff --git a/plugins/viz-platform/commands/initial-setup.md b/plugins/viz-platform/commands/initial-setup.md
index 2b5d8d8..ce8680b 100644
--- a/plugins/viz-platform/commands/initial-setup.md
+++ b/plugins/viz-platform/commands/initial-setup.md
@@ -4,6 +4,18 @@ description: Interactive setup wizard for viz-platform plugin - configures MCP s
 
 # Viz-Platform Setup Wizard
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🎨 VIZ-PLATFORM · Setup Wizard                                   │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the setup.
+
 This command sets up the viz-platform plugin with Dash Mantine Components validation and theming.
 
 ## Important Context
diff --git a/plugins/viz-platform/commands/theme-css.md b/plugins/viz-platform/commands/theme-css.md
index 7de53d9..945e68a 100644
--- a/plugins/viz-platform/commands/theme-css.md
+++ b/plugins/viz-platform/commands/theme-css.md
@@ -4,6 +4,18 @@ description: Export a theme as CSS custom properties
 
 # Export Theme as CSS
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🎨 VIZ-PLATFORM · Theme CSS Export                               │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the export.
+
 Export a theme's design tokens as CSS custom properties for use outside Dash.
 
 ## Usage
diff --git a/plugins/viz-platform/commands/theme-new.md b/plugins/viz-platform/commands/theme-new.md
index 1e9c95b..96a18c7 100644
--- a/plugins/viz-platform/commands/theme-new.md
+++ b/plugins/viz-platform/commands/theme-new.md
@@ -4,6 +4,18 @@ description: Create a new custom theme with design tokens
 
 # Create New Theme
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🎨 VIZ-PLATFORM · New Theme                                      │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the theme creation.
+
 Create a new custom theme with specified design tokens.
 
 ## Usage
diff --git a/plugins/viz-platform/commands/theme.md b/plugins/viz-platform/commands/theme.md
index 4119774..86383f5 100644
--- a/plugins/viz-platform/commands/theme.md
+++ b/plugins/viz-platform/commands/theme.md
@@ -4,6 +4,18 @@ description: Apply an existing theme to the current context
 
 # Apply Theme
 
+## Visual Output
+
+When executing this command, display the plugin header:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  🎨 VIZ-PLATFORM · Apply Theme                                    │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Then proceed with the theme activation.
+
 Apply an existing theme to activate its design tokens.
 
 ## Usage