English · 简体中文

TaiyiForge（太一炉）

AI가 코드를 작성하는 현학(玄学)을 실행 가능하고 감사 가능한 엔지니어링 파이프라인으로 만듭니다.

npm version

CI

Platforms

빠른 시작 · 핵심 능력 · 문서 · 커뮤니티

왜 TaiyiForge가 필요한가?

AI로 코드를 작성하는 것은 쉽습니다. AI로 엔지니어링을 하는 것은 어렵습니다.

/taiyi:plan은 기본적으로 반자동입니다 (모듈 분해 + 추천 프로필, 사람이 확인 후 배치로 /taiyi:new). auto 모드로 전환하면 원클릭으로 풀스택 골격을 생성할 수 있습니다 (아래 '원클릭 생성' 섹션 참조). 단계 순서를 외울 필요도 없고, 워크플로우 템플릿을 기억할 필요도 없습니다.

데모

27초 터미널 실황. 무(無)에서 변경 사항(change)을 생성하고, 엔진이 자동으로 단계를 진행합니다:

_{주: /taiyi:new → /taiyi:status → /taiyi:write → /taiyi:continue, 네 단계로 하나의 단계를 완료합니다.}

빠른 시작

# 1. 설치
npm install oh-my-taiyiforge

...

사용자는 Markdown과 코드만 작성하면 됩니다. 단계 순서, 워크플로우 템플릿, 게이트 검증은 모두 엔진이 처리합니다.

# 특정 측면만 설치
npx taiyi-forge-install --cursor
npx taiyi-forge-install --claude --opencode
...

자세한 설치 →

핵심 능력

9단계 파이프라인

변경 사항(change)은 항상 아홉 단계를 거치며, 각 단계마다 고정된 결과물을 산출합니다. 핵심 지점은 **인간 게이트(Human Gate)**입니다. AI가 스스로 통과시킬 수 없습니다.

change → requirement → design → ui-design → task → dev → test → review → integration
   ↑인간 승인            ↑인간 승인                                   ↑인간 승인

하나의 명령어, 네 가지 측면에서 사용 가능

Claude Code의 /taiyi:new이든, Cursor의 동일한 슬래시(slash)든, Codex의 $taiyi-new이든, 아니면 OpenCode의 플러그인 도구든 — 동일한 용어, 동일한 동작입니다.

v30 추천 상단 바 (21개):

프로젝트 레벨 vs Change 레벨

/taiyi:plan 원클릭 생성 풀스택 골격 (auto 모드)

/taiyi:plan기본값은 반자동입니다. 모듈 분해 후 사용자 확인을 거쳐 일괄적으로/taiyi:new`를 실행합니다. auto 모드는 백엔드, 프론트엔드, 테스트, 마이그레이션을 한 번에 모두 처리하여 단일 명령으로 바로 실행 가능한 풀스택 엔지니어링 결과물을 생성합니다.

아래는 auto 모드에서 한 번의 작업으로 산출되는 실제 구조입니다 (examples/translation-assistant/agent/, 79 파일 / 23 디렉토리):

agent/
├── backend/                          # FastAPI 백엔드
│   ├── app/
...

대응하는 9단계 산출물: 각 모듈은 .taiyi/changes/<slug>/에 {phase}.json과 hbs로 렌더링된 CHANGE.md → … → CHANGELOG.md를 생성합니다 (로컬에서 확인 가능하며, 기본적으로 저장소에 커밋되지 않습니다).

실행 방법: 요구사항 파일부터 시작합니다.

/taiyi:plan README.md --auto         # auto 모드: 원클릭 골격 생성
/taiyi:plan PRD.pdf --profile=full   # 반자동: 모듈 분해 후 사용자 확인 필요

전체 예시 → · plan 명령어 참고 →

파이프라인 그 이상

• 강제 TDD: dev 단계는 먼저 실패하고 나중에 성공하는 방식(Red-Green)을 따르며, 이는 권고가 아닌 강한 제약 조건입니다.
• evidence를 통한 부정행위 방지: 모든 AC(Acceptance Criteria)에는 실행 가능한 검증 명령이 포함되어야 하며, 테스트에 실패하면 진행되지 않습니다.
• 토큰 압축: 긴 세션의 경우 자동으로 CONTEXT-COMPACT.md를 생성하여 날짜가 바뀌어도 끊김 없이 이어집니다.
• ChangeGraph: 변경 사항 간의 의존성을 자동으로 추적하여 한 곳을 수정해도 전체에 미치는 영향을 알 수 있습니다.
• 일률적인 방식 거부: 대규모 기능은 full, 소규모 수정은 lite, 오타 수정은 nano와 같이 세분화합니다.
• 5가지 플러그인식 레지스트리 (v1.0.0-rc.1): Profile / CodePattern / SSOTRule / Extractor / RunnerPolicy는 모두 Registry<T> 추상화로 통합되었으며, builtin + YAML + node_modules 세 가지 확장 소스를 지원하고 구형 API와의 호환성을 유지합니다. 자세한 내용은 CHANGELOG를 참조하세요.

비교

문서

커뮤니티

• 🐛 버그 보고
• 💡 아이디어 및 토론
• 🔧 코드 기여 — npm test는 반드시 녹색이어야 함
• ⭐ 별점(Star)을 눌러주세요, 다음 배포 때 길을 잃지 않도록

TaiyiForge는 새로운 표준을 발명하지 않습니다. 대신 Harness · OpenSpec · GStack · Superpowers · OMO · Spec-Kit을 하나의 상태 기계로 오케스트레이션합니다. 필요한 것만 장착하고 나머지는 자동으로 건너뜁니다.

라이선스

MIT © 2026 TaiyiForge contributors

영감 출처: oh-my-claudecode · oh-my-codex · Harness Engineering · OpenSpec · GStack · Superpowers · OMO · Spec-Kit