Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
AIOX Squad는 개발자에게 제어권을 돌려주는 오픈 소스 AI 오케스트레이션 프레임워크입니다. 전문 에이전트와 워크플로우를 구축할 수 있게 하며, CLI First 경험을 제공합니다. 새로운 npm 네임스페이스 `@aiox-squads/core`로 통합되었습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Versão NPM
Licença: MIT
Versão Node.js
CI
codecov
Documentação
Open Source
Contributions Welcome
Code of Conduct
🌐 README 언어별: EN | PT | ES | ZH
창조의 힘을 사람에게 돌려주기 — 구축할 용기가 있는 이들에게 제어권을 되돌려주는 오픈 소스 AI 오케스트레이션 프레임워크. 전문 에이전트, 워크플로우, 그리고 모든 도메인에 맞는 CLI First 경험을 제공합니다.
새로운 npm 네임스페이스:
@aiox-squads/core는 스코프가 없는aiox-core의 후속작입니다. 내용은 동일한 AIOX 프레임워크이지만, 새로운 네임스페이스는@aiox-squads/*아래로 스쿼드들이 통합되었음을 반영합니다. CLI 명령어(aiox-core포함)는 전환 기간 동안 보존됩니다.
AIOX가 처음이라면, 이 선형 경로를 따르세요:
# 새 프로젝트
npx aiox-core init meu-projeto
...
/agent-name/aiox-menu → /aiox-<agent>/skills → aiox-<agent-id>docs/ide-integration.md의 제한 사항 및 해결 방법을 따르세요.*help 또는 이에 상응하는 것)를 실행합니다.첫 번째 값의 정의 (이진): 에이전트 활성화 + 유효한 인사말 + 10분 이내에 유용한 출력이 있는 초기 명령어 실행.
AIOX의 많은 고급 기능은 라이프사이클 이벤트(hooks)에 의존합니다. 아래 표는 IDE/플랫폼 간 실제 파리티를 보여줍니다:
AIOX는 명확한 우선순위 계층 구조를 따릅니다:
CLI 우선 → 관측 가능성 두 번째 → UI 세 번째
| 레이어 | 우선순위 | 초점 | 예시 |
|---|---|---|---|
| CLI | 최대 | 지능이 존재하는 곳. 모든 실행, 결정 및 자동화가 여기서 발생합니다. | 에이전트 (@dev, @qa), 워크플로우, 명령어 |
| ... |
파생 원칙:
AIOX의 두 가지 핵심 혁신:
1. 에이전트 계획(Planning Agêntico): 전담 에이전트(analyst, pm, architect)가 사용자와 협력하여 상세하고 일관성 있는 PRD 및 아키텍처 문서를 작성합니다. 고급 프롬프트 엔지니어링과 인간 참여형 루프(human-in-the-loop)를 통한 정교화 과정을 통해, 이 계획 에이전트들은 단순한 AI 작업 생성 수준을 훨씬 뛰어넘는 포괄적인 명세서를 생산합니다.
2. 엔지니어링 기반 컨텍스트화된 개발: 스크럼 마스터(Scrum Master) 에이전트는 이러한 상세 계획들을 모든 것이 필요한 초상세 개발 스토리로 변환하며, 여기에는 완전한 컨텍스트, 구현 세부 사항 및 아키텍처 지침이 스토리 파일에 직접 통합되어 있습니다.
이 2단계 접근 방식은 AI 지원 개발에서 가장 큰 문제인 계획 불일치와 컨텍스트 손실을 모두 제거합니다. 개발 에이전트는 무엇을, 어떻게, 그리고 왜 구축해야 하는지에 대한 완전한 이해를 가지고 스토리 파일을 열게 됩니다.
📖 사용자 가이드에서 전체 워크플로우 보기 - 계획 단계, 개발 주기 및 모든 에이전트 역할
설치 문제 발생? 문제 해결 가이드를 참조하세요.
플랫폼별 특정 가이드:
다국어 문서화 이용 가능: English | Português | Español | 中文
시작하기 전에, AIOX가 어떻게 작동하는지 설명하는 다음 핵심 워크플로우 다이어그램들을 검토하세요:
⚠️ 이 다이어그램들은 AIOX Agentic Agile 흐름에 대한 90%의 혼란을 설명합니다. PRD(제품 요구사항 정의서)+아키텍처 작성과 sm/dev/qa 워크플로우, 그리고 에이전트들이 스토리 파일들을 통해 노트를 전달하는 방식을 이해하는 것이 필수적입니다. 또한 이것이 taskmaster가 아니거나 단순한 작업 실행기(executor)가 아님을 설명합니다!
노력 없이 최신 상태를 유지하세요! 기존 AIOX 설치를 업데이트하려면:
npx aiox-core@latest install
이것은 다음을 수행합니다:
.bak 백업 파일을 생성합니다.이를 통해 커스터마이징을 잃지 않으면서 최신 개선 사항, 버그 수정 및 새로운 에이전트의 이점을 쉽게 누릴 수 있습니다!
단일 명령으로 AIOX를 설치하세요:
npx aiox-core init meu-projeto
...
AIOX는 이제 Vite나 Next.js 같은 최신 도구에서 영감을 받은 인터랙티브한 차세대 설치 경험을 포함합니다:
인터랙티브 설치 도우미 기능:
이 설치 도우미가 제공하는 것:
끝! 클론하거나 수동으로 설정할 필요 없이 - 단지 하나의 명령어로 현대적이고 전문적인 설치 경험을 가지고 바로 시작할 수 있습니다.
사전 요구 사항: Node.js v18+ 필수 (v20+ 권장) | 문제 해결(Troubleshooting)
AIOX가 이미 설치되어 있는 경우:
npx aiox-core@latest install
# 도우미가 기존 설치를 감지하고 업데이트합니다
AIOX는 개발 경험 향상을 위해 IDE용 사전 구성된 규칙을 포함합니다.
.cursor/global-rules.md의 내용을 복사.claude/CLAUDE.md가 자동으로 로드됩니다npm run sync:ide:claudenpm run validate:claude-sync && npm run validate:claude-integrationAGENTS.md 파일이 자동으로 로드됩니다npm run sync:ide:codex로 보조 에이전트 동기화npm run sync:skills:codex로 로컬 스킬 생성 및 버전 관리npm run sync:skills:codex:global는 이 프로젝트 외부에서만 사용하세요 (/skills의 중복 방지)npm run validate:codex-sync && npm run validate:codex-integrationnpm run validate:codex-skills && npm run validate:pathsnpm run sync:ide:gemini로 동기화 가능한 규칙 및 에이전트.gemini/rules.md, .gemini/rules/AIOX/agents/, 그리고 .gemini/commands/*.toml에 생성됩니다.gemini/hooks/ + .gemini/settings.json)/aiox-menu, /aiox-dev, /aiox-architect 등)npm run validate:gemini-sync && npm run validate:gemini-integrationnpm run validate:parity이러한 규칙들은 다음을 제공합니다: