Templates and patterns for tables, diagrams, trees, and visual markdown — loaded on demand when formatting artifacts.
Formatting standards, constraints, and reusable templates for AI Agents when creating tables, diagrams, trees, and other visual markdown elements.
Applies to ALL artifacts: plans, backlogs, brainstorms, docs, session logs.
| ID | Rule | Detail |
|---|---|---|
| C1 | Pad columns | All cells in the same column MUST have equal width |
| C2 | Cell width limit | Max ~50-60 characters per cell |
| C3 | Column count | 3-4 ideal, 5-6 max. More than 6 → restructure |
| C4 | Alignment | Left-align with :-- for readability |
| C5 | Long URLs | Use reference links [text][ref] for URLs > 40 ch |
Field | Type | Description
:--------------|:---------------|:----------------------------
`name` | string | Project name
`status` | enum | active, archived, completed
`ecosystem` | string \| null | Parent ecosystem slug
Group completed items by plan. Use reference links for file paths.
Plan | IDs
:--------------------------|:-----------------------------
`Initial MVP (v1.0)` | FT-01→05, BUG-01→03
[Migration Plan v2][ref1] | MG-01→08, BUG-10, BUG-11
[Hotfix Plan][ref2] | BUG-12
[ref1]: ../plans/done/migration-v2.md
[ref2]: ../plans/done/hotfix-login.md
<!-- WRONG: cell > 60 chars, pipes misaligned -->
| # | Task | Very long description that goes past eighty chars | Out |
|:--|:-----|:--------------------------------------------------|:----|
<!-- WRONG: inline URL bloats cell width -->
| [Some Long Plan Name](../plans/done/very-long-name.md) | IDs |
<!-- RIGHT: reference link keeps cell short -->
| [Some Long Plan Name][ref1] | IDs |
+-|)```text code blocksCorners: ┌ ┐ └ ┘
Lines: ─ │
Junctions: ├ ┤ ┬ ┴ ┼
Arrows: ▼ ▲ ► ◄ → ←
Double: ╔ ╗ ╚ ╝ ║ ═
┌─────────────────┐
│ Parent Box │
└───────┬─────────┘
│
┌───┼───┐
▼ ▼ ▼
┌─────┐ ┌─────┐ ┌─────┐
│ A │ │ B │ │ C │
└─────┘ └─────┘ └─────┘
┌──────────────────────────────────────┐
│ Layer 3 — Description │
├──────────────────────────────────────┤
│ Layer 2 — Description │
├──────────────────────────────────────┤
│ Layer 1 — Description │
└──────────────────────────────────────┘
┌──────────┐ ┌──────────┐ ┌──────────┐
│ Step 1 │────▶│ Step 2 │────▶│ Step 3 │
└──────────┘ └──────────┘ └──────────┘
┌──────────┐
┌───▶│ Path A │
┌────────┐ │ └──────────┘
│ Decide │─┤
└────────┘ │ ┌──────────┐
└───▶│ Path B │
└──────────┘
Client Server Database
│ │ │
│── request ────────▶│ │
│ │── query ──────────▶│
│ │◀── result ─────────│
│◀── response ───────│ │
├── └── │```text code blocks/project-slug/
├── project.md
├── repo/
│ ├── src/
│ └── package.json
├── sessions/
│ └── 2026-03-30.md
├── artifacts/
│ ├── tasks/
│ │ ├── backlog.md
│ │ ├── sprint-current.md
│ │ └── done.md
│ └── plans/
│ └── done/
└── docs/
Criteria | Option A | Option B | Option C
:-------------|:----------|:---------|:--------
**Cost** | $0 | $5/mo | $20/mo
**Effort** | 1 day | 3 days | 2 weeks
**Scale** | ~50 users | ∞ | ∞
**Self-host** | ❌ | ✅ | ✅
Feature | v1.0 | v2.0 | Planned
:--------------|:-----|:-----|:-------
Auth modes | 1 | 3 | —
SSR | ❌ | ✅ | —
Multi-tenant | ❌ | ✅ | —
Plugin system | ❌ | ❌ | ✅
Standard icons for use across all artifacts:
✅ Yes / Done / Good ❌ No / Missing
🟡 Medium / Partial 🔴 High / Critical
🟢 Low / Good 📅 Planned
🚀 ToDo 🔄 In Progress
⏳ Pending 📊 Evaluated
Before finalizing any visual markdown element:
[text][ref]?text code blocks?├── └── │ characters?