Dong90/oh-my-taiyiforge

AI workflow automation plugin for intelligent code generation with Claude/Codex

What it solves

TaiyiForge transforms the process of using AI to write code from an unpredictable "metaphysical" experience into a structured, executable, and auditable engineering pipeline. It addresses common AI coding issues such as AI agents skipping design phases, context window exhaustion (token explosion), inconsistent workflows across different AI tools (like Claude, Cursor, and Codex), and the lack of a formal review process for AI-generated code.

How it works

The project implements a state-machine engine that enforces a nine-phase artifact contract. This pipeline ensures that every change follows a strict sequence: change $\rightarrow$ requirement $\rightarrow$ design $\rightarrow$ ui-design $\rightarrow$ task $\rightarrow$ dev $\rightarrow$ test $\rightarrow$ review $\rightarrow$ integration.

Key mechanisms include:

  • Human-in-the-loop: Critical nodes require human approval to prevent the AI from approving its own work.
  • Cross-platform consistency: A unified set of slash commands (e.g., /taiyi:new, /taiyi:plan) that work identically across Claude Code, Cursor, Codex, and OpenCode.
  • Token Management: Automatic generation of CONTEXT-COMPACT.md to compress long conversations for seamless continuity.
  • Automated Scaffolding: The /taiyi:plan command can automatically decompose requirements into modules and generate a full-stack project skeleton (backend, frontend, tests) in "auto" mode.

Who it’s for

Software engineers and teams who want to move beyond simple AI chatting and implement a professional, disciplined engineering workflow using AI agents, ensuring that design, testing (TDD), and review are not skipped.

Highlights

  • Nine-Phase Pipeline: A strict state-machine enforced workflow from requirement to integration.
  • Unified Command Set: 21 canonical commands providing a consistent experience across multiple AI terminals.
  • Full-Stack Scaffolding: Ability to generate a complete project structure from a single PRD or README via /taiyi:plan --auto.
  • Forced TDD: Development phase requires a "red-green" test-driven development approach as a hard constraint.
  • Evidence-Based Validation: Every acceptance criterion must be accompanied by an executable verification command.
  • ChangeGraph: Automatic tracking of dependencies between different changes to understand global impact.