Shared Conventions Map

project transformers — knowledge discovery architecture — 2026-04-28

source of truth
knowledge/shared/conventions/
trigger-phrases.json
Fuel check ⛽ · Park it 🅿️ · Visualize 🪄 · Compound it 🧪 · OG Image 🏞️
fizzy-conventions.json
Card creation, tagging, fizzy-md proxy rules
coding-tools.json
Amp CLI, OpenCode, free model tiers, Wheeljack tool signposts
git-conventions.json
Branch naming, commit message format
whatsapp-setup.json
Multi-account config, store paths
summary.md
Overview index of all conventions
discovery path
how bots find conventions
loaded every session
AGENTS.md
→
signpost section
## Shared Conventions
→
points to
knowledge/shared/conventions/
→
also findable via
memory_search
bot rollout status
signpost in agents.md
🍠
OptimusAGENTS.md
🛠️
WheeljackAGENTS.md
🚔
ProwlAGENTS.md
🐝
BumblebeeAGENTS.md
🎯
BluestreakAGENTS.md
🔍
HoundAGENTS.md
🔬
PerceptorAGENTS.md
📼
RewindAGENTS.md
🚨
Red AlertAGENTS.md
🎷
JazzAGENTS.md
🔩
RivetAGENTS.md
📿
Alpha TrionAGENTS.md
❤️‍🩹
Ratchetair-gapped
💗
Arceeair-gapped
signpost in AGENTS.md
air-gapped (by design)
trigger phrases
universal commands
Park it 🅿️
all bots
Wrap up current work and store in the right place. Context-dependent routing:
🎯
Fizzy
Tracked tasks & cards
🧠
Memory
Lessons & decisions
📓
Obsidian
Reference material
⏰
Cron
Timed reminders
Visualize 🪄
all bots
Generate a rich HTML visual explainer using the visual-explainer skill, save to viz/{slug}.html, publish to ark.zainf.dev/viz/
Fuel check ⛽
all bots
Run codexbar usage across all providers — report Claude weekly limits, Amp hourly credits, Codex replenishment status
Compound it 🧪
all bots
Capture learnings from completed work into knowledge/solutions/. Updates PATTERNS.md if repo has one. Three questions: what worked, what broke, reusable insight.
OG Image 🏞️
all bots
Universal publishing-image trigger for 1200×630 OpenGraph images. Prefer this for blog/article posts, site pages, launch cards, and other higher-frequency preview-image work.
Usage check 💸
all bots
Use the openclaw-usage skill and shared usage script for token, cost, model, and session analysis. Prefer the skill over ad-hoc log parsing.
publishing image policy
publishing image triggers
OG Image 🏞️
primary
Use workspace/scripts/generate-og-image.js with og-image-config.example.json for generic site/page OpenGraph images. Alias: OG image 🖼️.
Blog OG 📝
alias
Blog/article-specific alias of OG Image 🏞️. Use workspace/scripts/generate-blog-og-image.js when a post title, series, date, and description should drive the preview image.
Ark logo/avatar 🎨
infrequent
Still available for Ark entity logos and avatars, but no longer the main publishing-image route. Use ref/ark-logo-avatar-process.md only when creating group/entity assets.
Routing rule: Blog/article posts happen more often than new Ark entities, so bots should reach for OG Image 🏞️ first for social-preview and OpenGraph work. Keep Ark logo/avatar 🎨 scoped to occasional Ark identity assets.
contextual references (bonus)
Optimus fizzy-conventions.json coding-tools.json
Wheeljack coding-tools.json
Prowl whatsapp-setup.json
Architecture principle: Single source of truth in knowledge/shared/conventions/. Each bot gets a one-line signpost in AGENTS.md (loaded every session). Contextual deep links in MEMORY.md are bonus — not required. Air-gapped bots (Ratchet, Arcee) are excluded by design.
System Architecture Operations Dashboard Memory Management