hellowind777/helloagents

해결하는 문제

HelloAGENTS는 AI 코드 CLI에서 흔히 발생하는 문제들을 해결합니다. 예를 들어, 에이전트가 너무 일찍 중단되어 구현 대신 제안만 제공하거나, 어려운 작업에 대해 사용자에게 책임을 전가하며, 세션 간에 프로젝트 맥락을 잃어버리거나, 실제로 검증하지 않은 상태에서 완료를 보고하는 등의 문제입니다. 구조화된 워크플로우 계층을 추가함으로써 AI 에이전트가 실질적인 실행 능력을 갖추고, 구현, 검증, 완료까지 일관성 있게 수행할 수 있도록 보장합니다.

작동 방식

Claude Code, Gemini CLI, Grok Build, Cursor, Codex CLI와 같은 기존 AI 코드 도구 위에 계층으로 통합됩니다. "스킬"(특수화된 규칙 세트)과 채팅 명령어(~로 시작)를 사용하여 에이전트의 행동을 안내합니다.

주요 메커니즘:

• 워크플로우 스킬: 작업 유형에 따라 자동으로 활성화되는 14개의 내장 스킬(hello-ui, hello-security, qa-review 등)로 품질 기준을 강제합니다.
• 프로젝트 지식 기반: 디스크에 .helloagents/ 디렉터리를 유지하여 프로젝트 개요, 코딩 가이드라인, 모듈 노트를 저장함으로써 에이전트가 사실을 다시 발견할 필요 없도록 합니다.
• 구조화된 계획: 채팅 기록에 의존하지 않고, "플랜 패키지"(요구사항, 작업, 계약)와 PRD 파일을 사용하여 복잡한 작업을 관리합니다.
• 상태 복구: STATE.md와 runtime.json에 세션 상태를 추적하여 다른 워크스페이스나 세션 간에 실행을 재개할 수 있습니다.
• 검증 게이트: 작업이 완료로 표시되기 전에 시각적 검증 또는 테스트 결과와 같은 실행 증거를 요구합니다.

대상 사용자

AI 코드 CLI를 사용하면서 더 높은 신뢰성, 엄격한 품질 관리, 장기적인 프로젝트 기억을 원하는 개발자들입니다.

주요 특징

• 14개의 전문 스킬: UI, API, 보안, 테스트, 아키텍처 등 태스크별 규칙.
• 채팅 기반 명령어: ~plan, ~build, ~qa, ~auto와 같은 명령어로 직접 제어 가능.
• 지속적 지식: 디스크에 저장된 프로젝트 맥락과 가이드라인으로 컨텍스트 창 낭비를 줄입니다.
• 실행 증거: "테스트 통과"를 넘어서 최종 납품을 위한 구조화된 증거를 요구합니다.
• 광범위한 통합: Claude Code, Gemini, Grok, Cursor, Codex 등 주요 AI CLI를 지원합니다.