페이즈록: 육아 기법에서 영감을 받은 AI 에이전트 제어 시스템

Phaselock는 자폐 아동을 위한 양육 기법을 AI 코딩 에이전트 제어에 적용한 오픈소스 에이전트 스킬입니다. 개발자는 모호한 작업이 자폐 아동과 AI 에이전트 모두 지시를 오해하게 하여 불완전하거나 잘못된 실행으로 이어진다는 점을 관찰했습니다.

핵심 제어 메커니즘

이 시스템은 네 가지 구체적인 제어 패턴을 구현합니다:

• 작업 전 명시적 게이트: 디스크에 승인된 게이트 파일이 있는지 확인하는 BeforeToolUse 훅을 사용합니다. 파일이 없으면 쓰기 작업이 불가능합니다. AI는 먼저 아키텍처 선언 없이는 진행할 수 없습니다.
• 실수에 대한 즉각적 피드백: PostToolUse 훅은 모든 파일 쓰기 후 정적 분석(PHPStan, PHPCS, ESLint, ruff 등)을 실행하고 구조화된 JSON 결과를 컨텍스트에 주입합니다. AI는 정확히 무엇이 문제인지 확인하고 수정한 후 다음 작업으로 넘어갑니다.
• 개방형 옵션이 아닌 제한된 선택지: 복잡한 기능은 의존성 순서로 분할된 조각으로 나뉩니다. AI는 한 번에 하나의 조각씩 작업하며, 각 조각은 다음 작업 시작 전 인간 검토를 위해 중단됩니다.
• 합리화로 피할 수 없는 규칙: 허용 또는 차단을 결정하는 셸 훅을 통해 기계적으로 적용됩니다. AI가 자신의 출력에 대해 가진 의견은 증거로 인정되지 않습니다.

기술적 세부사항

Phaselock는 Claude Code, Cursor, Windsurf 및 훅과 에이전트 스킬을 지원하는 모든 도구와 작동합니다. 도메인 지식은 Magento 2와 PHP를 중심으로 구성되었지만, 적용 아키텍처는 언어에 구애받지 않습니다.

현재 구현에는 확장성 제한이 있습니다: 모든 규칙을 매 세션마다 컨텍스트에 로드합니다. 규칙이 80개일 때는 관리 가능하지만, 500개 규칙에서는 작업 시작 전에 컨텍스트를 소모하게 되며, 10,000개 규칙에서는 물리적으로 불가능합니다.

향후 개발: Writ

개발자는 확장성 문제를 해결하기 위한 솔루션으로 Writ을 구축 중입니다. 이는 현재 중요한 규칙이 무엇인지 파악하고 해당 규칙만 반환하는 하이브리드 검색 시스템으로, 10ms 미만의 응답 시간과 10,000개 규칙에서 726배의 컨텍스트 감소를 달성합니다. 이 시스템은 아직 실험 단계이며 스트레스 테스트를 진행 중입니다.

개발자는 평가가 가장 해결되지 않은 어려운 문제로 남아있다고 언급합니다. 기준 질의는 80개 규칙에서 합성되며, 실제 세션의 실제 질의에서 검색 품질이 유지되는지 명확하지 않습니다.