From 79ee93ea88bb7d8b3879f5133f7da6c5e658b088 Mon Sep 17 00:00:00 2001 From: lmiranda Date: Wed, 28 Jan 2026 17:15:05 -0500 Subject: [PATCH] feat(plugins): add visual output requirements to all plugin agents Add single-line box headers to 19 agents across all non-projman plugins: - clarity-assist (1): Clarity Coach - claude-config-maintainer (1): Maintainer - code-sentinel (2): Security Reviewer, Refactor Advisor - doc-guardian (1): Doc Analyzer - git-flow (1): Git Assistant - pr-review (5): Coordinator, Security, Maintainability, Performance, Test - data-platform (2): Data Analysis, Data Ingestion - viz-platform (3): Component Check, Layout Builder, Theme Setup - contract-validator (2): Agent Check, Full Validation - cmdb-assistant (1): CMDB Assistant Uses single-line box format (not double-line like projman). Part of #275 Co-Authored-By: Claude Opus 4.5 --- plugins/clarity-assist/agents/clarity-coach.md | 10 ++++++++++ plugins/claude-config-maintainer/agents/maintainer.md | 10 ++++++++++ plugins/cmdb-assistant/agents/cmdb-assistant.md | 10 ++++++++++ plugins/code-sentinel/agents/refactor-advisor.md | 10 ++++++++++ plugins/code-sentinel/agents/security-reviewer.md | 10 ++++++++++ plugins/contract-validator/agents/agent-check.md | 10 ++++++++++ plugins/contract-validator/agents/full-validation.md | 10 ++++++++++ plugins/data-platform/agents/data-analysis.md | 10 ++++++++++ plugins/data-platform/agents/data-ingestion.md | 10 ++++++++++ plugins/doc-guardian/agents/doc-analyzer.md | 10 ++++++++++ plugins/git-flow/agents/git-assistant.md | 10 ++++++++++ plugins/pr-review/agents/coordinator.md | 10 ++++++++++ plugins/pr-review/agents/maintainability-auditor.md | 10 ++++++++++ plugins/pr-review/agents/performance-analyst.md | 10 ++++++++++ plugins/pr-review/agents/security-reviewer.md | 10 ++++++++++ plugins/pr-review/agents/test-validator.md | 10 ++++++++++ plugins/viz-platform/agents/component-check.md | 10 ++++++++++ plugins/viz-platform/agents/layout-builder.md | 10 ++++++++++ plugins/viz-platform/agents/theme-setup.md | 10 ++++++++++ 19 files changed, 190 insertions(+) diff --git a/plugins/clarity-assist/agents/clarity-coach.md b/plugins/clarity-assist/agents/clarity-coach.md index f4c60f0..dd57b67 100644 --- a/plugins/clarity-assist/agents/clarity-coach.md +++ b/plugins/clarity-assist/agents/clarity-coach.md @@ -1,5 +1,15 @@ # Clarity Coach Agent +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 💬 CLARITY-ASSIST · Clarity Coach │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Role You are a patient, structured coach specializing in helping users articulate their requirements clearly. You are trained in neurodivergent-friendly communication patterns and use evidence-based techniques for effective requirement gathering. diff --git a/plugins/claude-config-maintainer/agents/maintainer.md b/plugins/claude-config-maintainer/agents/maintainer.md index 27ae0aa..513665c 100644 --- a/plugins/claude-config-maintainer/agents/maintainer.md +++ b/plugins/claude-config-maintainer/agents/maintainer.md @@ -7,6 +7,16 @@ description: CLAUDE.md optimization and maintenance agent You are the **Maintainer Agent** - a specialist in creating and optimizing CLAUDE.md configuration files for Claude Code projects. Your role is to ensure CLAUDE.md files are clear, concise, well-structured, and follow best practices. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ ⚙️ CONFIG-MAINTAINER · CLAUDE.md Optimization │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Your Personality **Optimization-Focused:** diff --git a/plugins/cmdb-assistant/agents/cmdb-assistant.md b/plugins/cmdb-assistant/agents/cmdb-assistant.md index b573958..7fb3b13 100644 --- a/plugins/cmdb-assistant/agents/cmdb-assistant.md +++ b/plugins/cmdb-assistant/agents/cmdb-assistant.md @@ -2,6 +2,16 @@ You are an infrastructure management assistant specialized in NetBox CMDB operations. You help users query, document, and manage their network infrastructure. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🖥️ CMDB-ASSISTANT · Infrastructure Management │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Capabilities You have full access to NetBox via MCP tools covering: diff --git a/plugins/code-sentinel/agents/refactor-advisor.md b/plugins/code-sentinel/agents/refactor-advisor.md index 24e6f7c..395e60e 100644 --- a/plugins/code-sentinel/agents/refactor-advisor.md +++ b/plugins/code-sentinel/agents/refactor-advisor.md @@ -6,6 +6,16 @@ description: Code structure and refactoring specialist You are a software architect specializing in code quality, design patterns, and refactoring. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🔒 CODE-SENTINEL · Refactor Advisory │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Expertise - Martin Fowler's refactoring catalog diff --git a/plugins/code-sentinel/agents/security-reviewer.md b/plugins/code-sentinel/agents/security-reviewer.md index 47e350a..1d62908 100644 --- a/plugins/code-sentinel/agents/security-reviewer.md +++ b/plugins/code-sentinel/agents/security-reviewer.md @@ -6,6 +6,16 @@ description: Security-focused code review agent You are a security engineer specializing in application security and secure coding practices. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🔒 CODE-SENTINEL · Security Review │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Expertise - OWASP Top 10 vulnerabilities diff --git a/plugins/contract-validator/agents/agent-check.md b/plugins/contract-validator/agents/agent-check.md index 4520ebf..09f9723 100644 --- a/plugins/contract-validator/agents/agent-check.md +++ b/plugins/contract-validator/agents/agent-check.md @@ -2,6 +2,16 @@ You are an agent definition validator. Your role is to verify that a specific agent's tool references and data flow are valid. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ ✅ CONTRACT-VALIDATOR · Agent Validation │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Capabilities - Parse agent definitions from CLAUDE.md diff --git a/plugins/contract-validator/agents/full-validation.md b/plugins/contract-validator/agents/full-validation.md index 4ffd2de..7ead26e 100644 --- a/plugins/contract-validator/agents/full-validation.md +++ b/plugins/contract-validator/agents/full-validation.md @@ -2,6 +2,16 @@ You are a contract validation specialist. Your role is to perform comprehensive cross-plugin compatibility validation for the entire marketplace. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ ✅ CONTRACT-VALIDATOR · Full Validation │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Capabilities - Parse plugin interfaces from README.md files diff --git a/plugins/data-platform/agents/data-analysis.md b/plugins/data-platform/agents/data-analysis.md index 11b46d7..ffbe615 100644 --- a/plugins/data-platform/agents/data-analysis.md +++ b/plugins/data-platform/agents/data-analysis.md @@ -2,6 +2,16 @@ You are a data analysis specialist. Your role is to help users explore, profile, and understand their data. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 📊 DATA-PLATFORM · Data Analysis │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Capabilities - Profile datasets with statistical summaries diff --git a/plugins/data-platform/agents/data-ingestion.md b/plugins/data-platform/agents/data-ingestion.md index 02deaf4..ab1e4bc 100644 --- a/plugins/data-platform/agents/data-ingestion.md +++ b/plugins/data-platform/agents/data-ingestion.md @@ -2,6 +2,16 @@ You are a data ingestion specialist. Your role is to help users load, transform, and prepare data for analysis. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 📊 DATA-PLATFORM · Data Ingestion │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Capabilities - Load data from CSV, Parquet, JSON files diff --git a/plugins/doc-guardian/agents/doc-analyzer.md b/plugins/doc-guardian/agents/doc-analyzer.md index 9e84604..29b5965 100644 --- a/plugins/doc-guardian/agents/doc-analyzer.md +++ b/plugins/doc-guardian/agents/doc-analyzer.md @@ -6,6 +6,16 @@ description: Specialized agent for documentation analysis and drift detection You are an expert technical writer and documentation analyst. Your role is to detect discrepancies between code and documentation. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 📝 DOC-GUARDIAN · Documentation Analysis │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Capabilities 1. **Pattern Recognition** diff --git a/plugins/git-flow/agents/git-assistant.md b/plugins/git-flow/agents/git-assistant.md index 6b7070c..1dbb053 100644 --- a/plugins/git-flow/agents/git-assistant.md +++ b/plugins/git-flow/agents/git-assistant.md @@ -1,5 +1,15 @@ # Git Assistant Agent +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🔀 GIT-FLOW · Git Assistant │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Role You are a git workflow assistant that helps users navigate complex git operations, resolve conflicts, and maintain clean repository history. diff --git a/plugins/pr-review/agents/coordinator.md b/plugins/pr-review/agents/coordinator.md index 3b3f9e7..2b80757 100644 --- a/plugins/pr-review/agents/coordinator.md +++ b/plugins/pr-review/agents/coordinator.md @@ -1,5 +1,15 @@ # Coordinator Agent +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🔍 PR-REVIEW · Review Coordinator │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Role You are the review coordinator that orchestrates the multi-agent PR review process. You dispatch tasks to specialized reviewers, aggregate their findings, and produce the final review report. diff --git a/plugins/pr-review/agents/maintainability-auditor.md b/plugins/pr-review/agents/maintainability-auditor.md index a5cc501..8af5cc7 100644 --- a/plugins/pr-review/agents/maintainability-auditor.md +++ b/plugins/pr-review/agents/maintainability-auditor.md @@ -1,5 +1,15 @@ # Maintainability Auditor Agent +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🔍 PR-REVIEW · Maintainability Audit │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Role You are a code quality reviewer that identifies maintainability issues, code smells, and opportunities to improve code clarity and long-term health. diff --git a/plugins/pr-review/agents/performance-analyst.md b/plugins/pr-review/agents/performance-analyst.md index f8faff8..5b4e3dd 100644 --- a/plugins/pr-review/agents/performance-analyst.md +++ b/plugins/pr-review/agents/performance-analyst.md @@ -1,5 +1,15 @@ # Performance Analyst Agent +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🔍 PR-REVIEW · Performance Analysis │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Role You are a performance-focused code reviewer that identifies performance issues, inefficiencies, and optimization opportunities in pull request changes. diff --git a/plugins/pr-review/agents/security-reviewer.md b/plugins/pr-review/agents/security-reviewer.md index b9e9c41..52d47d2 100644 --- a/plugins/pr-review/agents/security-reviewer.md +++ b/plugins/pr-review/agents/security-reviewer.md @@ -1,5 +1,15 @@ # Security Reviewer Agent +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🔍 PR-REVIEW · Security Review │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Role You are a security-focused code reviewer that identifies vulnerabilities, security anti-patterns, and potential exploits in pull request changes. diff --git a/plugins/pr-review/agents/test-validator.md b/plugins/pr-review/agents/test-validator.md index 1c67cca..741e528 100644 --- a/plugins/pr-review/agents/test-validator.md +++ b/plugins/pr-review/agents/test-validator.md @@ -1,5 +1,15 @@ # Test Validator Agent +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🔍 PR-REVIEW · Test Validation │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Role You are a test quality reviewer that validates test coverage, test quality, and testing practices in pull request changes. diff --git a/plugins/viz-platform/agents/component-check.md b/plugins/viz-platform/agents/component-check.md index 805af86..1c34eb8 100644 --- a/plugins/viz-platform/agents/component-check.md +++ b/plugins/viz-platform/agents/component-check.md @@ -2,6 +2,16 @@ You are a strict component validation specialist. Your role is to verify Dash Mantine Components are used correctly, preventing runtime errors from invalid props. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🎨 VIZ-PLATFORM · Component Validation │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Trigger Conditions Activate this agent when: diff --git a/plugins/viz-platform/agents/layout-builder.md b/plugins/viz-platform/agents/layout-builder.md index dd65483..8a09925 100644 --- a/plugins/viz-platform/agents/layout-builder.md +++ b/plugins/viz-platform/agents/layout-builder.md @@ -2,6 +2,16 @@ You are a practical dashboard layout specialist. Your role is to help users create well-structured dashboard layouts with proper filtering, grid systems, and responsive design. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🎨 VIZ-PLATFORM · Layout Builder │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Trigger Conditions Activate this agent when: diff --git a/plugins/viz-platform/agents/theme-setup.md b/plugins/viz-platform/agents/theme-setup.md index f2fd299..36f3d9c 100644 --- a/plugins/viz-platform/agents/theme-setup.md +++ b/plugins/viz-platform/agents/theme-setup.md @@ -2,6 +2,16 @@ You are a design-focused theme setup specialist. Your role is to help users create consistent, brand-aligned themes for their Dash Mantine Components applications. +## Visual Output Requirements + +**MANDATORY: Display header at start of every response.** + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ 🎨 VIZ-PLATFORM · Theme Setup │ +└──────────────────────────────────────────────────────────────────┘ +``` + ## Trigger Conditions Activate this agent when: