Brand Profile

Brand Profile is the official way to give md2wechat agents stable brand memory.

It lives at:

~/.config/md2wechat/brand.md

It is Markdown, not YAML. The CLI stores and returns the text, but it does not parse the file. The agent reads it as writing and layout guidance.

When to use it

Use Brand Profile when you want repeated article work to keep the same:

• writing voice
• preferred themes
• preferred layout modules
• calls to action
• forbidden phrases
• example language
• audience and positioning

This is especially useful for teams that ask agents to format release posts, tutorials, service pages, or WeChat drafts on a regular basis.

Initialize the file

Run:

md2wechat brand init

Then inspect it:

md2wechat brand show --json

If the file exists, the command returns the raw Markdown content in data.content and the path in data.path.

What to write

A practical Brand Profile can be short:

# Brand Profile

We write for operators and creators who want reliable WeChat publishing.

Voice:
- clear, direct, practical
- avoid hype and empty slogans
- explain tradeoffs before commands

Layout:
- prefer one opening module, one evidence module, and one CTA
- avoid stacking too many decorative modules
- use API mode when advanced layout is needed

Conversion:
- invite readers to try md2wechat Agent API
- keep product claims concrete and verifiable

Agent priority order

When instructions conflict, agents should resolve them in this order:

1. explicit CLI flags
2. the user's current request
3. Brand Profile text
4. config.yaml
5. current CLI discovery output
6. conservative agent defaults

Brand Profile should guide decisions, but it should not override a direct user request in the current conversation.

Verify preferences before using them

If the Brand Profile names a theme or layout module, verify it before using it:

md2wechat themes list --json
md2wechat layout list --json
md2wechat themes show wechat-native --json

Do not silently fall back from an invalid theme to a random theme. Report the mismatch or choose a verified alternative.

Continue with

• md2wechat-skill Guide
• Discovery-First Workflow
• Advanced Layout