DEV.co
AI Coding Agents · Dong90

oh-my-taiyiforge

TaiyiForge is a TypeScript-based AI workflow automation plugin that enforces a nine-stage pipeline (requirement → design → task → dev → test → review) for code generation across Claude, Cursor, Codex, and OpenCode. It replaces ad-hoc prompting with state-machine-driven phases, human approval gates, and artifact contracts to make AI-assisted engineering auditable and reproducible.

Source: GitHub — github.com/Dong90/oh-my-taiyiforge
918
GitHub stars
19
Forks
TypeScript
Primary language
MIT
License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
RepositoryDong90/oh-my-taiyiforge
OwnerDong90
Primary languageTypeScript
LicenseMIT — OSI-approved
Stars918
Forks19
Open issues1
Latest releasev1.0.0 (2026-06-28)
Last updated2026-07-06
Sourcehttps://github.com/Dong90/oh-my-taiyiforge

What oh-my-taiyiforge is

A stateful orchestration framework that maps AI code generation into a nine-phase artifact contract model, with slash-command endpoints for each tool (Claude, Cursor, Codex, OpenCode) that share identical behavior. Includes token compression, change-graph dependency tracking, TDD-first test generation, and auto-scaffolding of full-stack projects from a single `/taiyi:plan` command with configurable profiles (full/lite/nano).

Quickstart

Get the oh-my-taiyiforge source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/Dong90/oh-my-taiyiforge.gitcd oh-my-taiyiforge# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Multi-tool AI-assisted development with policy enforcement

Teams using Claude Code, Cursor, Codex, or OpenCode simultaneously can enforce identical workflows and approval gates across all platforms, ensuring consistency regardless of which AI tool an engineer uses.

Full-stack project scaffolding from requirements

Accelerate greenfield projects by feeding a README or PRD into `/taiyi:plan --auto` to auto-generate backend (FastAPI), frontend, tests, migrations, and matching CHANGE/REQUIREMENT/DESIGN/TASK artifacts in a single pass.

Enforcing engineering discipline in AI-driven workflows

Organizations that need TDD-first validation, human approval at critical gates, and audit trails of design decisions can use the state machine to prevent AI from skipping requirements or design phases.

Implementation considerations

  • Installation requires npm and Node.js; the plugin must be synced separately to each AI platform (Claude, Cursor, Codex, OpenCode) via `npx taiyi-forge-install`.
  • The nine-stage pipeline mandates human approval at change, design, and review gates—teams must establish clear approval roles and SLAs or the system becomes a bottleneck.
  • Token compression and context management are automatic (CONTEXT-COMPACT.md), but long multi-day workflows require team discipline to checkpoint and use the compact context correctly.
  • Artifact storage (.taiyi/changes/) is local and not committed to the repository; teams must agree on where to persist change records if audit/history is required.
  • The `/taiyi:plan --auto` mode generates opinionated full-stack scaffolds (FastAPI + HTML/JS frontend); projects with non-standard tech stacks may need post-generation customization.

When to avoid it — and what to weigh

  • You need real-time pair programming with instant feedback — The nine-phase pipeline and approval gates introduce deliberate friction; this is not a live co-coding experience but rather a batch-oriented workflow tool.
  • You are locked into a single AI platform — TaiyiForge's value proposition depends on multi-platform slash-command support (Claude/Cursor/Codex/OpenCode). If you use only one, standard prompting or native tools may be simpler.
  • Your team does not use git-based code review or CI/CD — The framework assumes PR-based delivery, test evidence, and integration gates; teams without version control or CI automation will find the evidence/approval model less relevant.
  • You require non-TypeScript/Node.js plugin infrastructure — Installation requires npm and Node.js; if your IDE or AI tool does not support TypeScript-based plugins, deployment may not be feasible.

License & commercial use

MIT License. Permissive OSI-approved license allowing commercial use, modification, and distribution with no restriction on proprietary derivative works, subject only to inclusion of the original license text.

MIT is a permissive, OSI-approved license. Commercial use is explicitly allowed. No royalties, vendor lock-in, or commercial support requirements are imposed by the license itself. However, the project is under one year old; evaluate long-term maintenance and support expectations before critical production reliance.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

SignalAssessment
MaintenanceActive
DocumentationStrong
License clarityClear
Deployment complexityLow
DEV.co fitGood
Assessment confidenceMedium
Security considerations

No explicit security audit or threat model is documented. The plugin executes AI-generated code; review the nine-stage approval gates and TDD-first constraint to mitigate unchecked code generation. No mention of secrets management, authentication, or encryption for stored artifacts (.taiyi/changes/). Teams handling sensitive code should review how artifacts are stored locally and excluded from version control.

Alternatives to consider

Aider + custom shell scripts

Aider provides simpler multi-file AI-assisted editing for a single project; if you only need code generation without multi-platform orchestration or nine-stage pipelines, Aider + bash scripts may be lighter.

LangChain Agents + custom state machines

If you need deep customization of the AI orchestration logic and are comfortable building your own state machine, LangChain Agents offer more flexibility but require significant engineering.

Native IDE slash-command frameworks (Cursor Extensions, Claude Artifacts)

If you use only one AI tool (Cursor or Claude Code), the native IDE plugin system may offer simpler setup and tighter integration, though without cross-platform consistency.

Software development agency

Build on oh-my-taiyiforge with DEV.co software developers

If your team uses multiple AI coding tools and needs consistent approval workflows, artifact contracts, and audit trails, run `npm install oh-my-taiyiforge` and complete the QUICKSTART in 5 minutes. For production use, review the ARCHITECTURE and CONTROL-PLANE documentation to align with your approval processes.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

oh-my-taiyiforge FAQ

Does TaiyiForge write the code automatically?
Partially. The AI writes code at the 'dev' stage, but only after passing human approval gates at 'change' and 'design' stages. The nine-stage pipeline enforces TDD-first (red-before-green); it is not a fully autonomous code generator.
Can I use TaiyiForge with just one AI tool (e.g., only Cursor)?
Yes, but you lose a key value proposition. TaiyiForge's main benefit is identical behavior across Claude, Cursor, Codex, and OpenCode. With a single tool, native slash commands or prompting may be simpler.
Where are the generated artifacts stored?
In `.taiyi/changes/<slug>/` (local, not committed to git by default). Teams requiring persistent audit history must implement custom export or CI/CD integration to move artifacts to an external store.
What if I am using TypeScript but not Node.js?
Installation requires npm and Node.js runtime. If your project uses TypeScript but runs on Deno, Bun, or browser-only targets, you will need to adapt the installation or run the plugin in a separate Node.js process.

Software development & web development with DEV.co

From first prototype to production, DEV.co delivers software development services around tools like oh-my-taiyiforge. Our software development agency staffs experienced software developers and web developers for custom software development, web development, integrations, and ongoing support across ai coding agents and beyond.

Evaluate TaiyiForge for Your Team

If your team uses multiple AI coding tools and needs consistent approval workflows, artifact contracts, and audit trails, run `npm install oh-my-taiyiforge` and complete the QUICKSTART in 5 minutes. For production use, review the ARCHITECTURE and CONTROL-PLANE documentation to align with your approval processes.