convez.ai
AgenteAutomaçãoAvançado
ryu-qqq

Agent Crew

ryu-qqq/agent-crew

Fonte única de verdade para agentes e skills de operação em equipe

Ver no GitHub
InicialPluginScore · de 0 a 100

Repositó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-crew

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
2

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을 개인의 도구가 아니라 팀의 시스템으로 편입시켜, 팀 생산성의 저점을 끌어올리는 것을 목표로 합니다.

— Software 3.0 시대, Harness를 통한 조직 생산성 저점 높이기


생태계 — agent-crew와 ops-pilot은 한 세트

자산을 만드는 곳과 평가·적용하는 곳이 짝을 이룹니다.

레포역할
agent-crew (이 레포)에이전트·스킬 .md 원본 저장소입니다. git tag로 버전을 끊습니다.
ops-pilotagent-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 loopproposal-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하여 프로젝트 값을 얻습니다. 이 패턴이 하나의 원본을 모든 프로젝트에 맞게 유지하는 핵심입니다.


버전

VERSIONING.md · CHANGELOG.md

Ver o original no GitHub

Bom para

Relacionados