Why md2wechat Works Better as a Discovery-First Agent Workflow

I increasingly avoid telling agents to “just start executing” with md2wechat.

This kind of tool has too many moving parts for guesswork to stay cheap.

Why this matters more here

md2wechat is not a single switch.

Even a normal workflow can involve choices like:

• what the current default mode is
• which providers exist right now
• which themes exist right now
• which prompt presets exist right now
• which advanced layout modules exist right now

If none of that has been confirmed, the workflow can drift from the first assumption.

The gains are practical

The biggest benefits are not abstract:

• fewer useless errors
• fewer bad assumptions
• rules that are easier to reuse across agents
• smoother upgrades when versions change

That is not process for its own sake. It is operational stability.

The order that works better

The steadier order looks like this.

First, inspect the current surface.

md2wechat capabilities --json

Second, list the resources relevant to the task.

md2wechat providers list --json
md2wechat themes list --json
md2wechat layout list --json

Third, inspect the exact object you plan to use.

md2wechat providers show volcengine --json
md2wechat layout show hero --json

Only after that do you move to convert, preview, generate_image, or draft creation.

This also makes agent rules easier to write

There is another practical benefit.

You no longer need fuzzy rules built around guesses such as “if this probably exists.”

The rule can stay direct:

• list the current capability surface
• choose from what is currently exposed
• execute only after the choice is confirmed

That kind of rule survives much longer.

Closing thought

I increasingly think the best first move with md2wechat is not “convert now.”

It is “show me what this runtime can do first.”

Discovery first, execution second.
It looks like one extra step, but it usually removes more rework than it adds.

Continue with:

• Discovery-First Workflow
• Why Agents Should Check the Layout Catalog Before Writing
• How to Choose md2wechat Modes Without Mixing Everything Together
• Setup and Troubleshooting