taiyi-render — Claude Code prompt for JSON-to-Markdown rendering
The taiyi-render prompt rebuilds {PHASE}.md from {phase}.json after JSON edits. Use it to refresh a document without changing its Markdown structure by hand.
MIT ★ 855 updated 2026-10-12
.claude/commands/taiyi-render.mdWhat taiyi-render does
Invoke /taiyi:render and pass a phase when you want one other than the current phase. Claude Code runs scripts/taiyi-forge.sh render with the supplied arguments. Zod validates the JSON, then Handlebars produces the Markdown file.
Install the command at .claude/commands/taiyi-render.md. Edit the JSON first, then render; manual changes to the Markdown structure bypass validation. The command neither advances the workflow nor runs quality checks. The dev phase has no JSON view.
What it helps with
- rebuild a Markdown file after changing its JSON
- validate phase data with Zod before rendering
- render the current phase without naming it
- refresh a document while leaving its Markdown structure alone
Example prompts for the agent
- Render the current phase with
/taiyi:render. - Rebuild the Markdown for phase
changeusing/taiyi:render change. - Regenerate
{PHASE}.mdfrom{phase}.jsonfor phasechange.
How to install taiyi-render
Manually: put the files in place
.claude/commands/taiyi-render.mdHow to use
Paste the text at the start of a chat or into project instructions
Questions about taiyi-render
How do I install taiyi-render in Claude Code?
Place the command file at .claude/commands/taiyi-render.md.
What does taiyi-render do?
It generates {PHASE}.md from {phase}.json, validating the JSON with Zod and rendering the Markdown through Handlebars. If you omit the phase, it uses the current one.
What happens when rendering fails?
Zod reports the validation error. Fix the JSON based on that error and run the render again; the dev phase has no JSON view.
Source text
taiyi-render.md · MIT
<!-- TAIYI-FORGE:CHAT-COMMAND:taiyi-render.md -->
---
description: "TaiyiForge /taiyi:render — json → md via hbs"
argument-hint: "optional slug and phase, e.g. change"
---
User invoked **$taiyi-render** (= `/taiyi:render`). Run:
```bash
scripts/taiyi-forge.sh render $ARGUMENTS
```
Re-renders `{PHASE}.md` from `{phase}.json` (Zod validate + Handlebars). Omit phase to use current phase. **dev** has no json view.
Use after editing json artifacts; does not advance workflow or run quality gates.
## Agent 协议(必须遵守)
1. **优先改 json**,再 `render` — do not hand-edit md structure.
2. 用户只说 **`/taiyi:*` 斜杠**;你代跑 `scripts/taiyi-forge.sh`,禁止让用户手打 shell。
3. `render` 失败时读 Zod 错误,补全 json 后重试;勿跳过校验手改 md 过关。
© Dong90 · MIT · Dong90/oh-my-taiyiforge