oh-my-taiyiforge
무엇인가
TaiyiForge는 AI 에이전트가 코드 변경을 수행할 때 따를 9단계 파이프라인과 단계별 산출물 계약을 주입하는 워크플로 자동화 플러그인이다. change → requirement → design → ui-design → task → dev → test → review → integration 순서를 상태 기계로 고정하고, 각 단계가 남겨야 할 산출물 형식과 통과 조건을 규정한다. 규율 대상은 코드 생성 자체가 아니라 변경 작업의 진행 순서와 검증 절차다.
어떻게 동작하나
엔진은 `.taiyi/changes/<id>/` 아래에 단계별 `{phase}.json`을 만들고 hbs 템플릿으로 `CHANGE.md`부터 `CHANGELOG.md`까지 렌더링한다. 사용자는 `/taiyi:new`, `/taiyi:status`, `/taiyi:write`, `/taiyi:continue` 네 명령으로 한 단계를 진행하며, change·design·integration 지점에서는 인간 승인 없이 다음 단계로 넘어갈 수 없다. dev 단계는 TDD를 강제해 실패 테스트를 먼저 요구하고, 각 인수 조건(AC)에는 실행 가능한 검증 명령을 evidence로 붙여야 게이트를 통과한다. 장기 세션에서는 `CONTEXT-COMPACT.md`를 생성해 문맥을 압축한다.
무엇과 다른가
프롬프트를 직접 작성하거나 단일 규칙 파일을 두는 방식과 달리, 단계 순서·산출물 템플릿·게이트 검증을 엔진이 담당한다. 동일한 명령 어휘가 Claude Code의 `/taiyi:*`, Cursor의 슬래시 명령, Codex의 `$taiyi-new`, OpenCode 플러그인 도구에서 같은 동작을 낸다. 변경 규모에 따라 full·lite·nano 프로파일을 선택하고, ChangeGraph로 변경 간 의존을 추적하며, Profile·CodePattern·SSOTRule·Extractor·RunnerPolicy 5개 Registry를 builtin·YAML·node_modules 세 소스로 확장한다.
어떻게 쓰나
설치는 npm 패키지 설치 후 설치 스크립트로 각 AI 터미널에 Skill을 동기화하는 방식이다. `npm install oh-my-taiyiforge` 다음 `npx taiyi-forge-install --all`을 실행하거나 `--cursor`, `--claude --opencode`처럼 대상을 지정한다. 첫 사용은 채팅에서 `/taiyi:new "작업 설명"`으로 change를 만들고 `/taiyi:status`로 상태를 확인하는 흐름이며, 요구사항 문서를 `/taiyi:plan README.md --auto`에 넘기면 백엔드·프론트엔드·테스트·마이그레이션 골격을 한 번에 생성한다.
전제와 한계
Claude Code·Cursor·OpenCode·Codex 네 터미널을 지원하며 Node.js/npm 환경이 필요하다. 생성된 `.taiyi/changes/` 산출물은 로컬에 남고 기본적으로 저장소에 커밋되지 않는다. 자체 표준을 새로 만들지 않고 Harness·OpenSpec·GStack·Superpowers·OMO·Spec-Kit를 상태 기계로 엮는 방식이므로, 설치된 구성 요소만 사용하고 나머지는 건너뛴다. Registry 확장 API는 v1.0.0-rc.1 기준이며 기여 시 `npm test` 통과가 요구된다.
관련 논문 2
유사 도구
- refly자연어로 서술한 업무 절차를 결정적 스킬로 컴파일해 Claude Code·API·웹훅으로 내보내는 Refly의 스킬 팩이다. 실행 중 개입과 버전 관리를 규칙으로 고정한다.
- oh-my-claude프롬프트에 ultrawork 트리거를 넣으면 병렬 실행·서브에이전트 위임·검증 게이트를 강제하는 Claude Code 플러그인이다.
- SkillAnything대상 도구·API·워크플로를 분석해 7단계 파이프라인으로 SKILL.md와 스크립트를 생성하고 Claude Code·Codex용 스킬 묶음으로 패키징하는 절차를 주입한다.
- idea-validation-agents스타트업 아이디어 검증 절차를 CLAUDE.md·AGENTS.md에 주입해 9단계 스코어링과 결정 메모를 생성하게 하는 스킬 팩이다.
- openInvestAI 에이전트에 다중 에이전트 투자위원회 절차를 주입해, 정보 격리·반박 라운드·감사 가능한 판정 기록을 강제하는 Claude Code 플러그인이다.
- agents하나의 Markdown 소스에서 Claude Code, Codex, Cursor, Copilot 등 여러 코딩 하네스용 플러그인·에이전트·스킬을 생성해 배포하는 마켓플레이스다.