render-output

Key principle: Output should be scannable in under 5 seconds. Choose the simplest pattern that communicates the information effectively. </objective>

<quick_start> Select pattern based on data type:

Default to the simplest pattern. Escalate complexity only when needed. </quick_start>

@type: [SchemaType]
@id: [unique-identifier]
[scalar properties]

[table]{columns|tab}:
[row1 tab-separated]
[row2 tab-separated]

Rules:

• •ALWAYS include @type and @id
• •Use tab-separated tables for arrays
• •Prefer flat structure (avoid nesting >2 levels)
• •No prose - data only
• •Use toon language tag for syntax highlighting

Example:

@type: AssessAction
@id: 005-auth
actionStatus: CompletedActionStatus

validationStatus: VALID
checksPerformed: 10
issues.critical: 0
issues.warning: 1

</toon_pattern>

<table_pattern> For human-readable listings and comparisons:

| Column1 | Column2 | Column3 |
|---------|---------|---------|
| value1  | value2  | value3  |

Rules:

• •Maximum 6 columns (truncate or split if more)
• •Align columns consistently
• •Truncate cells >30 chars with ...
• •Right-align numbers
• •Keep header row concise

Example:

| ID         | Name           | Stage       | Priority |
|------------|----------------|-------------|----------|
| 005-auth   | Implement Auth | in-progress | P1       |
| 006-mgmt   | User Management| ready       | P2       |

</table_pattern>

<status_pattern> For single action outcomes:

[symbol] [action verb] [target]: [brief result]

Symbols:

• •✓ success
• •✗ failure
• •⚠ warning
• •→ transition

Examples:

✓ Created outcome 005-auth in queued/
✓ Synced capabilities-info.toon (12 capabilities)
✗ Validation failed: 3 critical issues
⚠ Index stale, auto-syncing...

For short lists (<5 items), use indented bullets:

✓ Created 3 outcomes
  - 005-auth (queued)
  - 006-mgmt (queued)
  - 007-report (queued)

</status_pattern>

<box_pattern> For validation reports and multi-section results:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[Title]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Section1:     [✓/✗] [details]
Section2:     [✓/✗] [details]
Section3:     [✓/✗] [details]

Overall: [PASS ✓ / FAIL ✗ / NEEDS_ATTENTION ⚠]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Use box drawing characters:

• •━ horizontal line
• •│ vertical line (if needed)
• •┌┐└┘ corners (if needed)

Reserve for:

• •Validation reports (>3 checks)
• •Multi-section summaries
• •Error reports with details </box_pattern>

<summary_pattern> For counts, distributions, and quick stats:

Single line for simple counts:

Summary: 11 total | 3 queued | 2 ready | 1 in-progress | 5 completed

Two lines for distributions:

Summary: 11 total | 3 queued | 2 ready | 1 in-progress | 5 completed
         9 parent | 2 child | P1: 6 | P2: 4 | P3: 1

Rules:

• •Use | as separator
• •Align related groups
• •Maximum two lines </summary_pattern>

<distribution_pattern> For visual distribution of values:

Maturity Distribution:
  0-29%:   ### (3)
  30-59%:  ##### (5)
  60-79%:  ### (3)
  80-100%: # (1)

Rules:

• •Use # for bar chart
• •Include count in parentheses
• •Align labels and bars </distribution_pattern> </patterns>

<pattern_selection> Choose pattern based on:

1. •Audience: Subagent (TOON) vs Human (table/status/box)
2. •Complexity: Simple (status) → Complex (box)
3. •Data shape: List (table) vs Result (status) vs Validation (box)

Decision tree:

Is output for another agent?
├─ Yes → TOON block
└─ No → Is it a single action result?
        ├─ Yes → Status line
        └─ No → Is it validation with pass/fail?
                ├─ Yes → Box report
                └─ No → Is it a list/comparison?
                        ├─ Yes → Markdown table
                        └─ No → Summary line

</pattern_selection>

DO NOT use emoji. Stick to these standard symbols. </symbols>

<anti_patterns> Avoid these common mistakes:

• •Excessive whitespace: Don't add blank lines between every element
• •Nested boxes: Don't put boxes inside boxes
• •Mixed styles: Don't combine table + box in same output
• •Emoji overuse: Stick to standard symbols (✓✗⚠)
• •Long prose: Output should be data-focused, not explanatory
• •Missing language tags: Always tag code blocks (toon, markdown)
• •Inconsistent alignment: Align columns and values consistently
• •Over-engineering: Don't use box for simple status
• •Column overflow: Keep tables under 6 columns </anti_patterns>

<success_criteria> Output meets quality standards when:

• •Pattern matches data type (use decision tree)
• •Symbols used consistently throughout
• •No excessive whitespace or blank lines
• •Code blocks have language tags
• •Tables stay under 6 columns
• •Box reports used only for complex validation
• •TOON used for machine-readable returns
• •Human output is scannable in <5 seconds
• •No mixed patterns in single output </success_criteria>

Summary: 11 total | 3 queued | 2 ready | 1 in-progress | 0 blocked | 5 completed

Current Focus: 005-implement-auth (in-progress)

Blocked: None </example>

4745a58 feat(ws): add out/list command 0.9.2 → 0.9.3 (minor)

✓ Committed, pushed, synced </example>

Schema: ✓ Valid YAML frontmatter Achievement: ✓ Behavioral focus Effects: ✓ 3 Given-When-Then Capabilities: ✓ Links valid Actors: ⚠ 1 unknown actor ID

Overall: NEEDS_ATTENTION ⚠ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ </example>

summary.total: 11 summary.queued: 3 summary.completed: 5

outcome{id,name,stage|tab}: 005-auth Implement Auth in-progress 006-mgmt User Management ready

</example>
</examples>