Files
leo-claude-mktplace/plugins/projman/skills/visual-output.md
lmiranda d90a8d05af feat(projman): add token usage estimation reporting
- New skill: token-budget-report.md with MCP overhead and skill loading
  estimation model based on known file sizes and static overhead tables
- Sprint-plan displays token report after planning complete
- Sprint-close displays token report after lessons captured
- Visual-output.md updated with token report format
- .gitignore exception for token-budget-report.md (not API tokens)

Helps identify which phases and components consume the most context budget.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 10:20:56 -05:00

3.8 KiB

name, description
name description
visual-output 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
/pm-setup ⚙️ Gear SETUP
/pm-debug 🐛 Bug DEBUG
/labels-sync 🏷️ Label LABELS
/suggest-version 📦 Package VERSION
/proposal-status 📋 Clipboard PROPOSALS
/pm-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

Token Budget Report

Displayed at end of planning and closing phases:

+-- Token Budget Report -----------------------------------------------+
|  Phase: [PHASE NAME]                                                 |
|  Sprint: [Sprint Name]                                               |
+----------------------------------------------------------------------+
|  MCP Overhead: ~XX,XXX tk                                            |
|  Phase Cost:   ~X,XXX tk  (skills: N, agent: model)                 |
|  Est. Total:   ~XX,XXX tk (~XX% of budget)                          |
+----------------------------------------------------------------------+

See skills/token-budget-report.md for full format and estimation model.