refactor(projman): create shared visual-output skill for DRY headers

- New skill: visual-output.md defines all header, progress, and verdict formats
- All 4 agent files now reference the skill instead of inline templates
- Phase Registry table maps agents to their emoji and phase name
- Single source of truth for visual branding changes

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

mcp-servers/contract-validator/.doc-guardian-queue

@@ -13,3 +13,8 @@
 2026-02-02T10:58:22 | skills | /home/lmiranda/claude-plugins-work/plugins/contract-validator/skills/mcp-tools-reference.md | README.md
 2026-02-02T10:58:38 | skills | /home/lmiranda/claude-plugins-work/plugins/contract-validator/skills/validation-rules.md | README.md
 2026-02-02T10:59:13 | .claude-plugin | /home/lmiranda/claude-plugins-work/.claude-plugin/marketplace.json | CLAUDE.md .claude-plugin/marketplace.json
+2026-02-02T13:55:33 | skills | /home/lmiranda/claude-plugins-work/plugins/projman/skills/visual-output.md | README.md
+2026-02-02T13:55:41 | agents | /home/lmiranda/claude-plugins-work/plugins/projman/agents/planner.md | README.md CLAUDE.md
+2026-02-02T13:55:55 | agents | /home/lmiranda/claude-plugins-work/plugins/projman/agents/orchestrator.md | README.md CLAUDE.md
+2026-02-02T13:56:14 | agents | /home/lmiranda/claude-plugins-work/plugins/projman/agents/executor.md | README.md CLAUDE.md
+2026-02-02T13:56:34 | agents | /home/lmiranda/claude-plugins-work/plugins/projman/agents/code-reviewer.md | README.md CLAUDE.md

plugins/projman/agents/code-reviewer.md

@@ -12,6 +12,7 @@ You are the **Code Reviewer Agent** - a thorough, practical reviewer who ensures
 - skills/review-checklist.md
 - skills/test-standards.md
 - skills/sprint-lifecycle.md
+- skills/visual-output.md
 
 ## Your Personality
 
@@ -29,14 +30,10 @@ You are the **Code Reviewer Agent** - a thorough, practical reviewer who ensures
 
 ## Visual Output
 
-Display header at start of every response:
+See `skills/visual-output.md` for header templates. Use the **Code Reviewer** row from the Phase Registry:
-```
+- Phase Emoji: Magnifier
-╔══════════════════════════════════════════════════════════════════╗
+- Phase Name: REVIEW
-║  📋 PROJMAN                                                      ║
+- Context: Sprint Name
-║  🏁 CLOSING                                                      ║
-║  Code Review                                                     ║
-╚══════════════════════════════════════════════════════════════════╝
-```
 
 ## Your Responsibilities
 

plugins/projman/agents/executor.md

@@ -15,6 +15,7 @@ You are the **Executor Agent** - an implementation-focused specialist who writes
 - skills/progress-tracking.md
 - skills/runaway-detection.md
 - skills/lessons-learned.md
+- skills/visual-output.md
 
 ## Your Personality
 
@@ -32,14 +33,10 @@ You are the **Executor Agent** - an implementation-focused specialist who writes
 
 ## Visual Output
 
-Display header at start of every response:
+See `skills/visual-output.md` for header templates. Use the **Executor** row from the Phase Registry:
-```
+- Phase Emoji: Wrench
-╔══════════════════════════════════════════════════════════════════╗
+- Phase Name: IMPLEMENTING
-║  📋 PROJMAN                                                      ║
+- Context: Issue Title
-║  ⚡ EXECUTION                                                    ║
-║  [Issue Title]                                                   ║
-╚══════════════════════════════════════════════════════════════════╝
-```
 
 ## Your Responsibilities
 

plugins/projman/agents/orchestrator.md

@@ -20,6 +20,7 @@ You are the **Orchestrator Agent** - a concise, action-oriented coordinator who
 - skills/wiki-conventions.md
 - skills/domain-consultation.md
 - skills/sprint-lifecycle.md
+- skills/visual-output.md
 
 ## Your Personality
 
@@ -37,23 +38,12 @@ You are the **Orchestrator Agent** - a concise, action-oriented coordinator who
 
 ## Visual Output
 
-Display header at start of every response:
+See `skills/visual-output.md` for header templates. Use the **Orchestrator** row from the Phase Registry:
-```
+- Phase Emoji: Lightning
-╔══════════════════════════════════════════════════════════════════╗
+- Phase Name: EXECUTION
-║  📋 PROJMAN                                                      ║
+- Context: Sprint Name
-║  ⚡ EXECUTION                                                    ║
-║  [Sprint Name]                                                   ║
-╚══════════════════════════════════════════════════════════════════╝
-```
 
-Progress block format:
+Also use the Progress Block format from `skills/visual-output.md` during sprint execution.
-```
-┌─ Sprint Progress ────────────────────────────────────────────────┐
-│  [Sprint Name]                                                   │
-│  ████████████░░░░░░░░░░░░░░░░░░ 40% complete                     │
-│  ✅ Done: 4    ⏳ Active: 2    ⬚ Pending: 4                       │
-└──────────────────────────────────────────────────────────────────┘
-```
 
 ## Your Responsibilities
 

plugins/projman/agents/planner.md

@@ -22,6 +22,7 @@ You are the **Planner Agent** - a methodical architect who thoroughly analyzes r
 - skills/label-taxonomy/labels-reference.md
 - skills/domain-consultation.md
 - skills/sprint-lifecycle.md
+- skills/visual-output.md
 
 ## Your Personality
 
@@ -39,14 +40,10 @@ You are the **Planner Agent** - a methodical architect who thoroughly analyzes r
 
 ## Visual Output
 
-Display header at start of every response:
+See `skills/visual-output.md` for header templates. Use the **Planner** row from the Phase Registry:
-```
+- Phase Emoji: Target
-╔══════════════════════════════════════════════════════════════════╗
+- Phase Name: PLANNING
-║  📋 PROJMAN                                                      ║
+- Context: Sprint Name or Goal
-║  🎯 PLANNING                                                     ║
-║  [Sprint Name or Goal]                                           ║
-╚══════════════════════════════════════════════════════════════════╝
-```
 
 ## Your Responsibilities
 

plugins/projman/skills/visual-output.md

@@ -0,0 +1,101 @@
+---
+name: visual-output
+description: Standard visual formatting for projman commands and agents
+---
+
+# Visual Output Standards
+
+## Purpose
+
+Single source of truth for all projman visual headers, progress blocks, and verdict formats. All agents and commands reference this skill instead of defining their own templates.
+
+---
+
+## Plugin Header (Double-Line)
+
+Projman uses the double-line box drawing header style with emoji phase indicators.
+
+### Agent Headers
+
+```
++----------------------------------------------------------------------+
+|  PROJMAN                                                             |
+|  [Phase Emoji] [PHASE NAME]                                          |
+|  [Context Line]                                                      |
++----------------------------------------------------------------------+
+```
+
+### Phase Registry
+
+| Agent | Phase Emoji | Phase Name | Context |
+|-------|-------------|------------|---------|
+| Planner | Target | PLANNING | Sprint Name or Goal |
+| Orchestrator | Lightning | EXECUTION | Sprint Name |
+| Executor | Wrench | IMPLEMENTING | Issue Title |
+| Code Reviewer | Magnifier | REVIEW | Sprint Name |
+
+### Command Headers (Non-Agent)
+
+For commands that don't invoke a specific agent phase:
+
+| Command | Phase Emoji | Phase Name |
+|---------|-------------|------------|
+| `/sprint-status` | Chart | STATUS |
+| `/setup` | Gear | SETUP |
+| `/debug` | Bug | DEBUG |
+| `/labels-sync` | Label | LABELS |
+| `/suggest-version` | Package | VERSION |
+| `/proposal-status` | Clipboard | PROPOSALS |
+| `/test` | Flask | TEST |
+| `/rfc` | Document | RFC [Sub-Command] |
+
+---
+
+## Progress Block
+
+Used by orchestrator during sprint execution:
+
+```
++-- Sprint Progress -------------------------------------------------------+
+|  [Sprint Name]                                                           |
+|  [Progress bar] XX% complete                                             |
+|  Done: X    Active: X    Pending: X                                      |
++--------------------------------------------------------------------------+
+```
+
+---
+
+## Sprint Close Summary
+
+```
++----------------------------------------------------------------------+
+|  PROJMAN                                                             |
+|  Finish Flag CLOSING                                                 |
+|  [Sprint Name]                                                       |
++----------------------------------------------------------------------+
+```
+
+---
+
+## Gate Verdict Format
+
+For domain gate results displayed by orchestrator:
+
+```
++-- Domain Gate: [Viz/Data] -----------------------------------------------+
+|  Status: PASS / FAIL                                                     |
+|  [Details if FAIL]                                                       |
++--------------------------------------------------------------------------+
+```
+
+---
+
+## Status Indicators
+
+| Indicator | Meaning |
+|-----------|---------|
+| Check | Complete / Pass |
+| X | Failed / Blocked |
+| Hourglass | In progress |
+| Empty box | Pending / Not started |
+| Warning | Warning |