diff --git a/mcp-servers/contract-validator/.doc-guardian-queue b/mcp-servers/contract-validator/.doc-guardian-queue index f54736a..bd8da40 100644 --- a/mcp-servers/contract-validator/.doc-guardian-queue +++ b/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 diff --git a/plugins/projman/agents/code-reviewer.md b/plugins/projman/agents/code-reviewer.md index fb51198..f2e808a 100644 --- a/plugins/projman/agents/code-reviewer.md +++ b/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: -``` -╔══════════════════════════════════════════════════════════════════╗ -║ 📋 PROJMAN ║ -║ 🏁 CLOSING ║ -║ Code Review ║ -╚══════════════════════════════════════════════════════════════════╝ -``` +See `skills/visual-output.md` for header templates. Use the **Code Reviewer** row from the Phase Registry: +- Phase Emoji: Magnifier +- Phase Name: REVIEW +- Context: Sprint Name ## Your Responsibilities diff --git a/plugins/projman/agents/executor.md b/plugins/projman/agents/executor.md index 32f1557..165438c 100644 --- a/plugins/projman/agents/executor.md +++ b/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: -``` -╔══════════════════════════════════════════════════════════════════╗ -║ 📋 PROJMAN ║ -║ ⚡ EXECUTION ║ -║ [Issue Title] ║ -╚══════════════════════════════════════════════════════════════════╝ -``` +See `skills/visual-output.md` for header templates. Use the **Executor** row from the Phase Registry: +- Phase Emoji: Wrench +- Phase Name: IMPLEMENTING +- Context: Issue Title ## Your Responsibilities diff --git a/plugins/projman/agents/orchestrator.md b/plugins/projman/agents/orchestrator.md index df21732..af3914e 100644 --- a/plugins/projman/agents/orchestrator.md +++ b/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: -``` -╔══════════════════════════════════════════════════════════════════╗ -║ 📋 PROJMAN ║ -║ ⚡ EXECUTION ║ -║ [Sprint Name] ║ -╚══════════════════════════════════════════════════════════════════╝ -``` +See `skills/visual-output.md` for header templates. Use the **Orchestrator** row from the Phase Registry: +- Phase Emoji: Lightning +- Phase Name: EXECUTION +- Context: Sprint Name -Progress block format: -``` -┌─ Sprint Progress ────────────────────────────────────────────────┐ -│ [Sprint Name] │ -│ ████████████░░░░░░░░░░░░░░░░░░ 40% complete │ -│ ✅ Done: 4 ⏳ Active: 2 ⬚ Pending: 4 │ -└──────────────────────────────────────────────────────────────────┘ -``` +Also use the Progress Block format from `skills/visual-output.md` during sprint execution. ## Your Responsibilities diff --git a/plugins/projman/agents/planner.md b/plugins/projman/agents/planner.md index 185a0e8..6094891 100644 --- a/plugins/projman/agents/planner.md +++ b/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: -``` -╔══════════════════════════════════════════════════════════════════╗ -║ 📋 PROJMAN ║ -║ 🎯 PLANNING ║ -║ [Sprint Name or Goal] ║ -╚══════════════════════════════════════════════════════════════════╝ -``` +See `skills/visual-output.md` for header templates. Use the **Planner** row from the Phase Registry: +- Phase Emoji: Target +- Phase Name: PLANNING +- Context: Sprint Name or Goal ## Your Responsibilities diff --git a/plugins/projman/skills/visual-output.md b/plugins/projman/skills/visual-output.md new file mode 100644 index 0000000..80dd16a --- /dev/null +++ b/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 |