Agent Crew
ryu-qqq/agent-crew
Fonte única de verdade para agentes e skills de operação em equipe
Ver no GitHubRepositório centralizado de agentes e skills Claude Code reutilizáveis para múltiplos projetos, evitando drift de versão. Implementa uma camada meta-operacional compartilhada (rastreamento, documentação, decisões, testes, avaliação) com versionamento git e sincronização via ops-pilot.
Instalação
npx convez-ai ryu-qqq/agent-crew1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Sincronizar agentes de rastreamento (Jira, Notion) entre projetos
- Manter pipeline de decisão centralizado (pesquisa → ADR)
- Compartilhar estratégia de testes e avaliação de trabalho
- Acumular conhecimento via journal → wiki com busca centralizada
- Aplicar feedback loop (review → apply) via ops-pilot MCP
Veredito

Abordagem sólida de governança de agentes em escala organizacional. Separa claramente assets (agent-crew) de runtime/observação (ops-pilot), reduz drift por versionamento git. Requer disciplina de projeto e integração com ops-pilot para valor completo.
README
A tradução para o português deste README ainda está na fila.
agent-crew
여러 프로젝트가 공유하는 Claude Code 에이전트·스킬 자산의 단일 원본(source of truth)
한 곳에서 자산을 고도화하면 모든 프로젝트에 반영됩니다. 프로젝트마다 복사본이 갈라지는 drift를 막아 줍니다.
모토
"개인의 '슈퍼'를 넘어 팀의 '표준'으로."
LLM을 개인의 도구가 아니라 팀의 시스템으로 편입시켜, 팀 생산성의 저점을 끌어올리는 것을 목표로 합니다.
생태계 — agent-crew와 ops-pilot은 한 세트
자산을 만드는 곳과 평가·적용하는 곳이 짝을 이룹니다.
| 레포 | 역할 |
|---|---|
| agent-crew (이 레포) | 에이전트·스킬 .md 원본 저장소입니다. git tag로 버전을 끊습니다. |
| ops-pilot | agent-crew 자산을 평가·관측하고 소비 프로젝트에 적용하는 도구입니다. |
agent-crew는 순수 자산 저장소입니다. 평가·적용·대시보드·런타임 기능은 이곳에 두지 않으며, 그 역할은 ops-pilot이 담당합니다. 소비 프로젝트는 ops-pilot을 통해 특정 버전을 가져다 씁니다.
구조
agent-crew/
├── agents/ # 공유 에이전트 (.md)
│ ├── jira-manager.md # 작업 추적 — Jira 이슈/태스크 연동
│ ├── notion-manager.md # 작업 추적 — Notion 작업·일정 데이터베이스
│ ├── notion-doc-writer.md # 문서 저작 — 스펙·PRD·설계 문서 → Notion 페이지
│ ├── test-strategist.md # 테스트 전략 — 시나리오 → 테스트 피라미드 매핑
│ ├── decision-researcher.md # 의사결정 — 조사·옵션·트레이드오프 리서치 브리프
│ ├── adr-author.md # 의사결정 — ADR 작성·확정 (in-repo docs/adr/)
│ ├── work-evaluator.md # 작업 평가 — 완료 작업을 4원칙으로 채점 (+ ingest 개선안 JSON)
│ ├── proposal-reviewer.md # 피드백 — draft proposal 중복·충돌 검토
│ ├── proposal-applier.md # 피드백 — OpsPilot MCP로 approved proposal 반영
│ ├── journal-recorder.md # 지식 축적 — 작업 산출물 → raw 시드
│ ├── wiki-curator.md # 지식 축적 — raw 시드 → wiki 합성·승격
│ └── wiki-lookup.md # 지식 회수 — 작업 전 wiki 조회
├── skills/
│ ├── journal/SKILL.md # 사용자 직접 기록·문서 생성 진입점
│ ├── test-plan/SKILL.md # 테스트 계획 수립 진입점
│ ├── adr/SKILL.md # 조사·결정·기록 ADR 파이프라인 진입점
│ ├── engineering-os/SKILL.md # Engineering OS(Notion) 작업 시작·완료 루프
│ └── feedback-loop/SKILL.md # OpsPilot ingest → eval → review → apply
├── references/ # 스택·운영 convention 팩 (제네릭 자산이 런타임 로드)
│ ├── java-spring/ # Java·Spring Boot
│ └── notion/ # Notion Engineering OS 필드 convention
├── project.yaml.example # 소비 프로젝트가 채워야 할 설정 스키마
├── releases/ # 버전별 릴리스 기록 (변경·개선·검증·모델별)
│ ├── TEMPLATE.md
│ └── vX.Y.Z.md
├── VERSIONING.md # 버전·릴리스 정책
└── CHANGELOG.md # 버전별 한 줄 인덱스
담는 것 / 안 담는 것
✅ 담는 것 — 모든 프로젝트가 공통으로 쓰는 "메타 운영" 레이어
| 영역 | 자산 |
|---|---|
| 작업 추적 | jira-manager · notion-manager |
| 문서 저작 | notion-doc-writer |
| 테스트 전략 | test-strategist |
| 의사결정 | decision-researcher → adr-author |
| 작업 평가 | work-evaluator |
| OpsPilot feedback loop | proposal-reviewer · proposal-applier · feedback-loop skill |
| 지식 복리 축적 | journal-recorder → wiki-curator → wiki-lookup |
❌ 안 담는 것 — 프로젝트 고유 자산
헥사고날 코드 생성 파이프라인(builder·reviewer 등) 같은 자산은 담지 않습니다. 조직 설계가 프로젝트마다 갈려서 공통화하기 어렵기 때문입니다.
소비 프로젝트에 적용
소비 프로젝트로의 동기화·적용은 ops-pilot이 담당합니다. MCP sync_agent_crew 또는 REST POST /projects/:id/sync-agent-crew로 .claude/agents|skills|references를 lock/tag 기준으로 반영한 뒤 scan_project를 실행합니다.
각 소비 프로젝트는 project.yaml.example을 .claude/project.yaml로 복사해 프로젝트 고유 값을 채웁니다.
⚠️ Claude Code 에이전트
.md는 정적 텍스트입니다 —{{var}}런타임 치환이 없습니다.그래서 각 에이전트는 작업 첫 단계로
.claude/project.yaml을 Read하여 프로젝트 값을 얻습니다. 이 패턴이 하나의 원본을 모든 프로젝트에 맞게 유지하는 핵심입니다.