convez.ai
AgenteAutomaçãoAvançado
AGMO-Inc

AGMO Everywhere

AGMO-Inc/agmo-everywhere

Orquestrador multi-agente com memory persistente em Obsidian

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent agentic workflow completo com 8 agentes e 29 skills sob demanda para Claude Code, integrado com Obsidian. Funciona como orquestrador que delega tarefas a agentes especializados e acumula conhecimento em vault Obsidian, garantindo continuidade contextual entre sessões.

Instalação

$npx convez-ai AGMO-Inc/agmo-everywhere

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
4
Forks
1
Acompanhando
0
Saúde
50%
Último commit
há 1 semana
Versão
v0.9.1
Issues abertas
6
Contribuidores
2

Casos de uso

  • Projetos complexos que exigem continuidade de contexto entre múltiplas sessões
  • Workflows de design com captura de screenshots e integração Figma
  • Documentação técnica auto-gerada com rastreamento de decisões e aprendizados

Veredito

Sistema robusto de orquestração multi-agente que resolve o problema crítico de persistência de contexto em Claude Code através de Obsidian. Curva de aprendizado íngreme e requer setup inicial, mas oferece valor real para projetos de longa duração com necessidade de continuidade contextual.

README

A tradução para o português deste README ainda está na fila.

Agmo Everywhere

Claude Code 플러그인 — 8개 에이전트, 29개 온디맨드 스킬, Obsidian 중심 워크플로우

Version Agents Skills License Obsidian

오케스트레이터가 전문 에이전트에게 위임하고, Obsidian vault에 모든 지식을 축적하는 Claude Code 플러그인


필수 도구 (Prerequisites)

도구필요성비고
Claude Code필수Anthropic 공식 CLI
Obsidian권장미설치 시 경고 표시, vault 관련 기능 제한
Python 3필수config 파일 JSON 파싱에 사용 (macOS 기본 설치)
Node.js필수statusLine(HUD) 설정에 사용
Codex CLI선택독립 검증자로 활용. 미설치 시 자동 스킵, 기존 워크플로우 영향 없음

스킬별 추가 도구

일부 스킬은 추가 도구가 필요합니다. 해당 스킬을 사용하지 않으면 설치하지 않아도 됩니다.

스킬추가 도구비고
implement-pagePlaywright브라우저 스크린샷 캡처. npx playwright install chromium
implement-page-androidPaparazzi / Roborazzi / Compose Preview Screenshot TestingCompose Preview 스크린샷 캡처. 3종 중 1개 필수
implement-page, implement-page-androidFigma MCP ServerFigma 디자인 데이터 연동

설치 가이드 (Installation)

# 1. 마켓플레이스 등록
claude plugin marketplace add https://github.com/AGMO-Inc/agmo-everywhere

# 2. 플러그인 설치
claude plugin install agmo

# 3. 초기 설정 (새 세션 시작 후)
# Claude Code에서 아래와 같이 입력
/setup

setup 실행 시 다음 작업이 자동으로 수행됩니다.

  • Obsidian vault 경로 설정 → ~/.agmo/config 저장
  • statusLine(HUD) 자동 구성
  • 공유 디렉토리 및 wisdom 파일 초기화

핵심 원칙 (Core Principles)

  1. Conductor, not Performer — 오케스트레이터는 직접 코드를 작성하지 않고 전문 에이전트에게 위임합니다.
  2. Evidence before Claims — "완료"라고 선언하기 전에 반드시 검증 증거를 확보합니다.
  3. YAGNI — 명시적으로 요청된 것만 구현합니다. 추측에 의한 기능 추가를 금지합니다.
  4. Token Efficiency — 카테고리 라우팅으로 작업 복잡도에 맞는 모델을 자동 선택합니다. (haiku / sonnet / opus)
  5. Obsidian is the Hub — 모든 문서(플랜, 설계, 구현 기록)의 원본은 Obsidian vault에 저장합니다.

왜 Obsidian인가? (Why Obsidian)

세션 간 기억 연속성 — Claude Code는 세션이 끝나면 컨텍스트가 사라집니다. Vault에 플랜/설계/구현이 남아있으므로 새 세션에서도 이전 작업을 이어갈 수 있습니다.

프로젝트 간 컨텍스트 공유 — brainstorming이나 plan 스킬이 자동으로 vault를 탐색하여 관련 설계 문서, 과거 결정사항을 참조합니다. 프로젝트 A에서 내린 결정이 프로젝트 B 작업에도 반영됩니다.

Wisdom 축적 — decisions.md, learnings.md, issues.md는 짧은 교훈/결정/이슈의 원본입니다. 세션 시작 시에는 전체 파일을 무조건 주입하지 않고, llm-wiki context budgeter가 현재 프로젝트 기준으로 필요한 항목만 제한된 예산 안에서 선택합니다.

llm-wiki 컨텍스트 스파인 — .agmo/llm-wiki/ 아래 SCHEMA.md, INDEX.md, LOG.md, projects/<project>.md를 유지합니다. Obsidian은 사람이 읽고 쓰는 vault이고, llm-wiki 스파인은 에이전트가 컨텍스트 윈도우를 아끼기 위해 먼저 읽는 압축 지도입니다. wiki-maintain.sh는 stale/low-confidence/contested/broken link 신호를 찾아 오염된 맥락을 그대로 믿지 않고 검증·대체·플래그 처리하게 돕습니다.

양방향 링크로 추적성 확보 — 설계 → 플랜 → 구현 간 wikilink가 자동 생성됩니다. Obsidian 그래프 뷰에서 문서 간 관계를 한눈에 파악할 수 있습니다.

사람과 에이전트가 같은 문서를 공유 — 마크다운 기반이므로 사용자가 직접 열어서 플랜을 수정하거나 메모를 추가할 수 있습니다.


Wisdom 시스템

Wisdom은 프로젝트에서 축적된 학습, 결정, 이슈를 기록하고 자동 활용하는 시스템입니다.

구조

{vault_root}/
├── {project}/wisdom/
│   ├── learnings.md   # 프로젝트에서 얻은 교훈
│   ├── decisions.md   # 설계/아키텍처 결정 사항
│   └── issues.md      # 알려진 문제, 미해결 이슈
└── shared/wisdom/
    ├── learnings.md   # 프로젝트 공통 교훈
    ├── decisions.md   # 공통 결정 사항
    └── issues.md      # 공통 이슈

동작 방식

  • 자동 로드: 매 세션 시작 시 session-start 훅이 프로젝트 wisdom → 공유 wisdom 순으로 읽어 컨텍스트에 주입합니다.
  • 수동 기록: "기억해", "이거 기록해"라고 말하면 wisdom 스킬이 해당 내용을 분류하여 저장합니다.
  • 자동 기록: 디버깅이나 검증 과정에서 중요한 발견이 있으면 저장을 제안합니다.
  • 메타데이터 (v0.7.0): 각 항목에 선택적으로 confidence, source, ref 태그를 추가할 수 있습니다.

예시

# Learnings
- [2026-03-18] mock DB 테스트에서 prod 마이그레이션 실패를 감지 못함 → 통합 테스트는 실제 DB 사용 (confidence: high) (source: debugging)

# Decisions
- [2026-03-16] planner/architect/critic 에이전트 모델을 opus 고정 — 계획/분석에는 최상위 모델 필요 (confidence: high) (source: user)

Codex 통합 (Optional)

codex-plugin-cc가 설치된 환경에서 OpenAI Codex CLI를 독립 검증자로 활용합니다. Claude가 생성한 코드/플랜을 다른 모델이 교차 검증하여 self-review 편향을 줄입니다.

품질 게이트

게이트스킬Codex 명령역할
Plan Reviewplan-review Phase 1.5/codex:adversarial-review플랜 설계에 대한 adversarial challenge
Verificationverification/codex:reviewarchitect PASS 후 독립 코드 품질 리뷰
Debuggingdebugging Phase 4.5/codex:rescue3회 fix 실패 시 새로운 디버깅 관점

원칙

  • Codex는 품질 기준을 올릴 수만 있고 낮출 수 없음 — Agmo PASS + Codex BLOCK → FAIL
  • Graceful Degradation — Codex 미설치, 인증 실패, 타임아웃 시 자동 스킵
  • HUD 표시 — 세션 시작 시 자동 감지하여 codex:on / codex:off 표시

안전 가드레일 (Safety)

guard 훅이 모든 Bash 명령 실행 전에 자동으로 위험 패턴을 검사합니다.

차단 대상예시
재귀 삭제rm -rf /, rm -rf ~
DB 삭제DROP TABLE, DROP DATABASE
강제 푸시git push --force main
하드 리셋git reset --hard main

공백 변형, 플래그 순서 변경 등 기본 우회 패턴에도 대응합니다. 차단 시 사유를 명시하고 실행을 중단합니다.


에이전트 (Agents)

AgentRoleModel
executor코드 작성 및 수정haiku / sonnet / opus (라우팅)
explore코드베이스 탐색haiku (기본)
archivistObsidian vault 작업haiku (기본)
frontend프론트엔드 품질 검증 (visual, accessibility, responsive)opus (고정)
android-specialistAndroid 프론트엔드 품질 검증 (visual, accessibility, responsive)opus (고정)
architect분석, 검증, 디버깅opus (고정)
planner계획 수립opus (고정)
critic리뷰 및 비평opus (고정)

스킬 카탈로그 (Skills)

카테고리스킬
워크플로우brainstorming, plan, plan-review, execute, ralph
품질tdd, verification, code-review, debugging, accessibility
분석retro, security-audit, benchmark
Obsidiansave-plan, save-impl, save-note, vault-search, note-to-issue, wisdom
Gitgit-workflow
Figmaimplement-page, implement-page-android
오케스트레이션parallel, cancel
메타setup, plugin-review

워크플로우 가이드 (Recommended Workflows)

기본 워크플로우: 아이디어 → 설계 → 계획 → 실행

"이런 기능을 만들고 싶어"  →  brainstorming
→ 설계 승인
→ "플랜 만들어줘"          →  plan
→ [선택] "플랜 리뷰해줘"  →  plan-review
→ "실행해줘"               →  execute
→ 자동 검증 + Obsidian 저장

빠른 실행: 명확한 요청

"이 버그 수정해줘"    →  직접 실행 (Light 작업)
"이 기능 구현해줘"   →  plan → execute (Heavy 작업)

TDD 워크플로우

"TDD로 구현해줘"  →  테스트 먼저 → 구현 → 리팩토링

Git 워크플로우

"커밋해줘"    →  git-workflow 스킬
"PR 만들어줘" →  git-workflow 스킬

설정 (Configuration)

항목값
config 파일~/.agmo/config
환경변수AGMO_VAULT_ROOT (config보다 우선 적용)
상태 디렉토리~/.agmo/state/

License

MIT

Ver o original no GitHub

Bom para

Relacionados