toplog

id	741f5faa-186c-4455-8e51-8e1dacbac1e2
name	toplog
description	toplog — topic-tracing assistant for debugging. `run` activates the right trace topics for a given issue (in code or tests) so RCA has better traceability; `scan` reconciles the topics referenced in code against the topic catalog; `learn` consolidates post-RCA findings (enrich a topic, add a new one with its trace points, or retire a stale one). Use when debugging a hard failure and you want richer logs before or alongside RCA, when adding or auditing toplog topics, or after proving a root cause to capture the traceability that helped. Also triggers on "turn on tracing for X", "what topics cover Y", "add a toplog topic", or "audit toplog topics".
tags
eval	false
version	1

toplog — topic-tracing assistant

Use the toplog mechanism (topic-based runtime logging) to make hard failures observable before and during root-cause analysis, and to grow a curated set of trace topics over time. This skill operates toplog; it doesn't reimplement it.

This file routes — load the row that matches the task at hand.

Modes (from the skill arg)

Skill arg	Load	What it does
run <issue> (default when an issue is given)	modes/run.md	Activate topics to trace an issue; feed RCA
scan	modes/scan.md	Reconcile code topics with the catalog
learn (usually after RCA)	modes/learn.md	Consolidate findings into the catalog + code

Reference

When you need to…	Load
the registry of known topics + reconciliation rules	topics.md
extract topics in code / diff vs catalog	scripts/scan_topics.py
the toplog mechanism + API (enable/on/off/disable/is_on, /api/v1/toplog/*)	docs/toplog.md (repo)