lmiranda
d90a8d05af
- 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>
121 lines
3.8 KiB
Markdown
121 lines
3.8 KiB
Markdown
---
|
|
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 |
|
|
| `/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.
|