Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
이 플러그인은 Elixir/Phoenix 개발 환경을 위한 전문 에이전트 시스템입니다. 26가지의 전문 에이전트를 활용하여 코드 계획, 구현, 검토 및 검증 과정을 병렬로 수행합니다. Amp, Codex, Pi 등 다양한 AI 코딩 도구와 연동되어 강력한 네이티브 플러그인 기능을 제공합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Docs: phxagents.dev
Security: scanned with SkillSpector
문서(Docs): phxagents.dev -- 실행 환경별 설치 가이드, 런타임 호환성 매트릭스, 모든 26가지 철칙(Iron Laws), 그리고 탐색 가능한 기술 및 에이전트 카탈로그.
Claude Code는 훌륭합니다. 하지만 assign_new가 재연결 시 조용히 건너뛴다는 것, :float이 돈 필드를 손상시킬 수 있다는 것, 또는 Oban 작업이 Idempotent(멱등성)하지 않다는 것을 알지 못합니다.
이 플러그인은 알고 있습니다. 이는 26가지 전문 에이전트를 조정하여 Elixir/Phoenix 코드를 병렬로 계획하고, 구현하며, 검토하고, 검증합니다. 각 에이전트는 도메인 전문 지식, 신선한 컨텍스트, 그리고 테스트로는 잡아낼 수 없는 버그를 포착하는 강제된 철칙(Iron Laws)을 가지고 있습니다.
Amp 사용 시? 동일한 51가지 Elixir, Phoenix, LiveView, Ecto, Oban, 테스트 및 보안 기술과 40개의 결정론적 워크플로우 래퍼, 다섯 개의 읽기 전용 전문 에이전트, 병렬 검토/조사 기능, 그리고 네이티브 편집/검증 가드와 네이티브 PR 감시 라이프사이클 플러그인을 설치하세요. 전체 Claude Code 플러그인과의 중요한 차이점은 Amp 사용 시를 참조하거나 phxagents.dev에서 Amp 설치 가이드를 확인하세요.
Codex 사용 시? $elixir-phoenix:phx-investigate 및 $elixir-phoenix:phx-review 워크플로우를 포함한 모든 51가지 기술에 대한 네이티브 생성 기술 플러그인을 설치하세요. Codex 사용 시 또는 Codex 설치 가이드를 참조하세요. 신뢰 기반의 파괴적 명령어 보호 장치가 포함되어 있으며, 사용자 지정 에이전트는 의도적으로 제외되었고 Tidewave MCP 등록은 외부로 유지됩니다.
Pi 사용 시? 모든 51개 스킬에 대한 네이티브 생성 스킬 패키지를 설치하여, Pi와 호환되는 /skill:phx-investigate 및 /skill:phx-review 워크플로우를 포함합니다. Pi 사용 또는 Pi 설치 가이드를 참조하세요. 확장 기능(extensions), 프롬프트 템플릿, MCP, 사용자 지정 에이전트는 아직 의도적으로 포함되지 않았습니다. Tidewave는 Pi 호스트가 독립적으로 노출하는 경우에만 사용할 수 있습니다.
OpenCode 사용 시? 모든 51개 스킬에 대한 생성된 스킬 전용 타겟을 설치하여, phx-investigate 및 phx-review를 포함합니다. 테스트된 OpenCode 1.17.2 설정에서는 이들이 /phx-investigate 및 /phx-review로도 사용 가능하며, 스킬 도구(skill tool)가 휴대 가능한 명시적 인터페이스입니다. OpenCode 사용, OpenCode 가이드, 또는 OpenCode 설치 가이드를 참조하세요.
DeepSeek Harness (dsh) 사용 시? 모든 51개 스킬에 대한 생성된 스킬 전용 타겟을 설치합니다. 메시지 내 어느 곳에서든 /phx-investigate 또는 /phx-review 토큰이 스킬을 결정론적으로 로드하며, dsh는 CLAUDE.md를 네이티브로 읽습니다. DeepSeek Harness 사용, dsh 가이드, 또는 dsh 설치 가이드를 참조하세요. 후크(hooks)와 사용자 지정 에이전트는 의도적으로 포함되지 않았으며, Tidewave MCP 등록은 외부적입니다.
최상위 런타임 지원 매트릭스에서 네이티브 호출, 설치 및 의도적으로 연기된 기능들을 비교하세요. 생성된 스킬 지원이 Claude Code의 전체 기능 동등성(feature parity)을 의미하지는 않습니다.
# 기능을 설명하면, 플러그인이 나머지를 알아서 처리합니다.
/phx:plan 실시간 댓글 알림 추가
...
프롬프트 엔지니어링이 필요 없습니다.
┌─────────────────────────────────────────────────────────────────────┐
│ ⚗ Claude Code용 Elixir/Phoenix 플러그인 │
│ │
...
v3.0.0 -- 51개의 모든 표준 스킬 트리가 Amp, Codex, Pi, OpenCode, 그리고 DeepSeek Harness를 위한 분포를 생성했습니다. 9개의 핵심 워크플로우가 완전히 적응되었습니다: 6개의 주요 생명주기(lifecycle) 워크플로우와
phx-trace,phx-audit, 그리고phx-research입니다. 나머지 투영은 도메인 지식을 유지하지만, Claude 특정 오케스트레이션을 실행 시간(runtime)에서 번역해야 할 수 있습니다. Claude Code는 여전히 전체 표준 플러그인이며, 훅(hooks), 에이전트(agents), MCP, 명령어(instructions), 그리고 워크플로우 이식성(workflow portability)은 실행 시간에 따라 의도적으로 다릅니다. 기능적 동등성을 가정하기 전에 지원 매트릭스를 확인하십시오. 이슈를 환영합니다.
# Claude Code에서 마켓플레이스 추가하기
/plugin marketplace add oliver-kriska/claude-elixir-phoenix
...
Claude Code 2.1.110 이상이 필요합니다. 설치 이름은 elixir-phoenix로 유지되지만, 공개 워크플로우 명령어는 /phx:*입니다. Claude Code는 플러그인의 매니페스트 이름에 따라 명령어를 네임스페이스화하며, 설치 이름에 따르지 않습니다. 새로 설치할 경우, /ecto:*와 /lv:*를 위한 두 개의 작은 호환성 네임스페이스가 자동으로 포함되므로 별도로 설치할 필요가 없습니다. 업데이트 후에는 이미 열려 있는 세션에서 명령어를 시도하기 전에 /reload-plugins를 실행하십시오.
⚠️ [경고]
claude plugin update를 단독으로 실행하지 마십시오. v3에서는 v2가 선언하지 않았던 두 개의 호환성 플러그인(ecto, lv)이 도입되었으며, claude plugin update는 새로 버전에서 선언된 의존성을 설치하지 않습니다. 이로 인해 업데이트된 플러그인이 완전히 로드되지 않아 /phx:* 명령뿐만 아니라 /ecto:*와 /lv:*도 사용할 수 없게 됩니다. 두 개의 호환성 플러그인을 먼저, 아래의 정확한 순서로 사용하십시오.
claude plugin marketplace update oliver-kriska
claude plugin install ecto@oliver-kriska
claude plugin install lv@oliver-kriska
...
이후 Claude Code를 재시작하십시오. 이미 열려 있는 세션에서는 /reload-plugins가 업데이트된 스킬, 에이전트 및 훅을 다시 로드합니다. 작업을 계속하기 전에 /phx:help, /ecto:n1-check, 그리고 /lv:assigns가 나타나는지 확인하십시오.
만약 claude plugin list가 `Dependency
설정은 필요하지 않습니다. Claude Code 2.1.219 이상 버전은 기본적으로 최대 서브 에이전트 생성 깊이를 3으로 설정하므로, /phx:full, 깊은 /phx:plan, 병렬 /phx:investigate, 그리고 /phx:trace는 중첩된 오케스트레이터를 사용할 수 있습니다. Claude Code 2.1.217–2.1.218 버전에서는 기본적으로 깊이 1로 설정되었으며, 해당 버전이나 명시적으로 깊이 1–2를 구성하는 경우 워크플로우가 메인 대화에서 오케스트레이션을 유지하고 리프 전문가를 직접 생성합니다. 이들은 동일한 결정, 아티팩트, 검증 및 검토 게이트를 보존하며, 에이전트 토폴로지만 변경됩니다.
완벽하게 중첩된 토폴로를 명시적으로 활성화하려면 깊이 3으로 Claude Code를 시작하십시오:
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=3 claude
깊이 2는 /phx:trace의 호출 추적기(call-tracer)만으로 충분합니다. 이는 Claude Code를 시작하는 환경에 설정해야 하며, 플러그인 후크로는 부모 프로세스 환경을 변경할 수 없습니다.
멀티 스택 팁 — 프로젝트 범위 활성화. 이 플러그인은 Elixir/Phoenix에 대한 의견이 강합니다(opinionated). 여러 언어 스택에서 작업하는 경우, 전역적으로 활성화하기보다는 프로젝트별로 활성화하는 것을 선호하십시오. 다음 위치에 추가하세요:
<project>/.claude/settings.json:
{ "enabledPlugins": { "elixir-phoenix@oliver-kriska": true } }
후크는 mix.exs 존재 여부(v2.10.1 이상)에 대해 자체 게이트를 설정하므로, 전역 활성화가 안전합니다 — 프로젝트 범위 지정은 단지 깔끔함을 위한 선호 사항일 뿐입니다.
catchup같은 마켓플레이스에서 프레임워크에 구애받지 않는 /catchup 부재 복귀 브리핑(PR, 검토, git, Linear, 캘린더 → 우선순위가 지정된 Context Brief, 어떤 상위 변경 사항이 당신의 진행 중인 파일에 영향을 미치는지 포함)을 제공하는 **catchup**도 배포됩니다. 독립적인 플러그인이며 별도의 매니페스트를 가지므로, 필요할 때만 설치하십시오:
/plugin install catchup@oliver-kriska
자세한 내용은 plugins/catchup/README.md를 참조하십시오. Elixir/Phoenix와 연결되어 있지 않습니다.
git clone https://github.com/oliver-kriska/claude-elixir-phoenix.git
# 옵션 A: 로컬 마켓플레이스로 추가
...
공개 명령어 호환성을 테스트할 때는 세 가지 --plugin-dir 인수를 모두 유지하세요. 메인 디렉터리는 /phx:*를 제공하고, ecto와 lv 디렉터리는 레거시(legacy) 별칭인 /ecto:* 및 /lv:*를 제공합니다.
Amp는 동일한 생성된 스냅샷에서 두 가지 프로필을 지원합니다:
skill: invoke 명령어를 사용합니다. 이 경우 플러그인은 여전히 전문 분석(specialists), 병렬 분석, 편집 잠금(edit lock) 기능을 제공하지만, 파일시스템 래퍼(filesystem wrappers)가 호스팅 전용 스킬을 로드할 수 없으며 네이티브 phx-full은 플러그인 검증 게이트를 활성화하지 않습니다.phx:*/ecto:*/lv:* 래퍼와 래퍼가 활성화한 phx-full 게이트를 보존합니다.재현 가능한 전체 동작을 위해서는 프로젝트 로컬의 페어드(paired) 설치가 권장됩니다:
cd /path/to/your-phoenix-project
# 이 프로젝트에 51개의 스킬을 설치합니다
...
Ctrl+O로 Amp의 명령어 팔레트를 열고 skill: invoke를 실행한 다음, phx-investigate를 선택하고 버그 세부 정보를 전송하세요. 이 네이티브 경로는 해당 스킬이 로컬인지, 내장(built-in)인지, 개인 호스팅인지, 또는 워크스페이스 호스팅인지에 관계없이 효과적인 스킬을 해결합니다. paired-full의 경우, 익숙한 phx: investigate, phx: review, ecto: n1-check, 및 lv: assigns 래퍼도 사용할 수 있으며, 이들은 한 번의 실행 동안 일치하는 로컬 스킬을 주입합니다. phx: full은 네이티브 skill: invoke를 통해서가 아니라 해당 래퍼를 통해서만 플러그인 검증 게이트를 활성화합니다.
amp skill add --global은 **머신 로컬(machine-local)**에, 즉 ~/.config/agents/skills/ 아래에 위치하며 개인 호스팅/계정 전체 범위가 아닙니다. 개인 호스팅 아티팩트는 Amp의 개인 설정 또는 개인 Git 리포지토리를 통해 관리되며 여러 머신과 오브(orbs)에서 작동합니다. 호스팅 게시, 소스 우선순위, 래퍼 제한, 업데이트, 폴백 설치, 전문 분석, 안전 경계 및 검증에 대한 전체 내용은 Amp 가이드를 참조하세요.
phx-watch-pr는 별도의 phx-watch-pr.ts 플러그인이 추가로 필요합니다.
작업자(worker) Orb가 열리고 PR을 감시하는 프로젝트에 설치하세요:
mkdir -p .amp/plugins
plugin=".amp/plugins/phx-watch-pr.ts"
temporary="$(mktemp "${plugin}.XXXXXX")"
...
이 플러그인은 제한된(bounded) Orb keep-alive 임대(lease)를 유지하고, 배포와 같은 검사는 준비 상태(readiness)에서 제외하며, 재로드에 안전한 상태를 영속화하고, 실패/취소된 필수 CI, 해결되지 않은 피드백, 그리고 최종 결과가 있을 때만 동일한 작업자 스레드를 깨웁니다. --fix 옵션을 사용하면 실행 가능한 피드백과 브랜치 소유의 CI 실패가 하나의 직렬화된(serialized) 동일 스레드 워크플로우에서 복구됩니다. 이 플러그인은 결코 공유 CI, 병합(merges), 또는 배포를 맹목적으로 재실행하지 않습니다.
Codex는 생성된 대상을 네이티브 스킬스 플러그인으로 설치합니다. 등록과 설치는 별도의 단계입니다:
codex plugin marketplace add oliver-kriska/claude-elixir-phoenix --ref main
codex plugin add elixir-phoenix@oliver-kriska
codex plugin list