What is miaosuan?

Miaosuan is an open-source system that gives AI agents a daily strategy-review loop, meant to turn scattered decisions into a single action instead of a long essay. Its name comes from a line in Sun Tzu's Art of War about calculating carefully before a battle. Rather than being another prompt pack that asks an AI to analyze a business through an old military text, miaosuan is a working system: it reads what actually happened each day, interprets it through a pluggable strategic doctrine, forces every insight into an action, and compresses stalled decisions into a short decision card the user can answer in one word. The loop runs in five steps: gather activity from the review window, interpret it through doctrine lenses, force each interpretation into an action, update a set of five rolling strategy files, and escalate any decision that has stalled for several days into a thirty second digest. A human reply of one word feeds back into the next cycle. The Seven Military Classics, a set of ancient Chinese strategy texts, ship as the first doctrine pack, distilled into thirty five operational lenses, alongside full per chapter study notes for all seven texts. The five rolling strategy files track the situation on each front, the one to three main bets everything else serves, pending decisions waiting on a human with age counters, hard red lines the agent must never recommend, and a dated changelog of every strategy change. Doctrine packs are pluggable, so other frameworks like Stoic philosophy or Boyd's OODA loop could be added as separate packs following a documented spec. Setup works by cloning the repository, installing SKILL.md as a skill for an agent such as Claude Code or OpenClaw, copying the strategy templates into the agent's workspace, and running the review manually or on a daily schedule. No API keys or accounts are required since it runs entirely as markdown read by an existing agent. Everything stays local to the user's workspace and nothing is sent elsewhere. The skill and code are MIT licensed, while the doctrine packs are released under CC-BY-4.0.