<div align="center">
██╗ ██╗████████╗███████╗ █████╗ ██████╗ ███████╗███╗ ██╗████████╗███████╗
██║ ██║╚══██╔══╝██╔════╝██╔══██╗██╔════╝ ██╔════╝████╗ ██║╚══██╔══╝██╔════╝
██║ ██║ ██║ █████╗ ███████║██║ ███╗█████╗ ██╔██╗ ██║ ██║ ███████╗
...
10 specialized agents · 12 commands & skills · Claude · Opencode · Ampcode · Droid
<p align="center">
<img src="https://img.shields.io/github/package-json/v/hamr0/liteagents?label=version&color=2a4f8c" alt="version">
<img src="https://img.shields.io/badge/license-Apache%202.0-2a4f8c" alt="license: Apache 2.0">
</p>
</div>
Liteagents는 초기에 모든 것을 알려줘야 했던 LLM을 위한 스캐폴딩(scaffolding)으로 시작했습니다.
이제는 그렇지 않습니다. 모델들이 더 똑똑해지면서, 이 툴킷은 더 얇아졌습니다: 이름을 불러 호출하는 전문 에이전트들 또는 도메인에 따라 스스로 작동하는 것들입니다. 이는 빡빡한 레일(rails) 대신 광범위한 차선(lanes)이며, 어떻게 할지에 대한 스크립트가 아니라 무엇을에 대한 제약 조건입니다.
이는 적극적으로 도전받고, 가지치기되고, 재작성됩니다. 모델이 개선됨에 따라 이름이 바뀌거나, 추가되거나, 삭제되는 일들이 발생합니다. 이러한 변화 자체가 핵심입니다.
<sub>권한 오류가 발생했나요? mkdir -p ~/.npm-global && npm config set prefix '~/.npm-global', 그런 다음 ~/.npm-global/bin을 PATH에 추가하세요.</sub>
카탈로그 (The catalog)
Agents — @name(Claude Code) 또는 /name으로 호출합니다.
| Agent | 용도 |
|---|
1-create-prd | 범위를 PRD(제품 요구 사항 정의서)로 정의합니다. 이는 지켜야 할 사양이 아니라, 작업으로 들어가는 포털입니다. |
| ... | |
Commands & skills — /name. | |
| Command | 용도 |
|---|
/stash | 압축 또는 인계 전에 이 세션의 컨텍스트를 스냅샷합니다. |
| ... | |
| <sub>Claude Code와 Amp는 12가지 모두를 스킬(skills)로 제공하며; Opencode와 Droid는 12가지 모두를 명령어(commands)로 노출합니다. 네 가지 모두 에이전트 참조 문서를 함께 제공합니다.</sub> | |
가볍고 범용적이며, 특정 모델에 구애받지 않는 규칙 문서(rules doc)입니다. 이 문서는 무엇이 중요한지를 설정하고, 어떻게 할지에 대해서는 넓은 여지를 남겨둡니다. 즉, 정교함보다는 단순함을 추구하며, 모든 줄에는 목적이 있고, 수술적인 변경을 가하며, 의존성을 찾기 전에 표준 라이브러리를 최대한 활용하는 것이 중요합니다. 설계하기 전에 개념 증명(POC)부터 진행해야 합니다.
더 스마트한 모델 덕분에 제품 요구사항 정의서(PRD)는 산출물이 아니라 포털이 됩니다. 즉, 대화의 시작점인 셈입니다. 모든 것을 미리 확정하는 대신, 경험이 쌓임에 따라 모듈별로 발견하고 검토하며, 변경하고 삭제하면서 점진적으로 완성됩니다.
이 문서는 매 세션마다 로드되며 CLAUDE.md에서 연결되고, /remember 기능을 통해 항상 최신 상태를 유지합니다. 각 실행 시 사용자 본인의 복사본을 설치된 템플릿과 바이트 단위로 비교합니다.
| 사용자의 사본 | 발생하는 일 |
|---|
| 동일함 | 아무것도 없음 — 쓰기 작업도, 출력도 없음 |
| ... | |
편집 내용은 절대 파괴되지 않지만, 제자리에 보존되는 것도 아닙니다. .bak 파일은 다음 업데이트에서 덮어쓰이는 단일 파일입니다. 사용자 정의된 본문은 두 번의 출시가 아니라 한 번의 릴리스만 생존할 수 있습니다.
/stash → /remember — 일상적인 핵심 기능
/stash ──► /remember
capture consolidate
**/stash**는 프로젝트 로컬 범위입니다. 즉, 한 세션, 하나의 기능 또는 범위를 다룹니다. 새로운 배포를 시작하거나, 컨텍스트가 약 30%에 도달했을 때(절대 40%를 넘기지 않도록) 사용합니다. 스태시(stash)는 다음 세션으로의 깔끔한 인수인계 역할을 합니다.
**/remember**는 5번의 스태시가 쌓일 때마다 작동합니다. 이 기능은 그 5개의 내용을 통합하고, 모든 프로젝트 전반에 걸쳐 사용자의 로그를 읽어와 사용자 본인과 모델이 실제로 충돌했던 지점(수정 사항, 막다른 길, 포기된 흐름)을 발굴합니다. 이러한 내용들이 규칙으로 자리 잡게 되어 다음 세션은 이전보다 오류가 적습니다.
마크다운 파일 기반이며 데이터베이스나 RAG를 사용하지 않고, 항상 컨텍스트 내에서 활성화되며 각 프로젝트의 미묘한 차이를 분리하여 유지합니다. 중급 모델(mid-tier model)을 사용하여 작동합니다.
/docs-builder — 또 다른 일상적인 핵심 기능
마크다운 파일이 방대해지면 문제가 생깁니다. 토큰 소모가 심한 에이전트는 중요한 지식을 찾지 못하게 됩니다. (자체 PRD도 발견된 내용들이 쌓이면서 500줄에서 3k+ 줄로 늘어났는데, 이것이 바로 이 기능이 해결하기 위해 존재하는 문제입니다.)
이것은 /docs 아래의 모든 것을 네 개의 버킷(bucket)인 product/, logs/, wiki/, archive/에 걸쳐 인덱싱합니다. 또한, 사용자가 직접 할 필요가 없도록 문서들을 재구성하고, 인덱싱하며, 크기가 큰 문서를 분할해 줍니다.
중급 모델입니다.
/live-canvas — 모든 에이전트 CLI가 갖추지 못했던 UI
터미널 기반 에이전트는 사용자의 화면을 볼 수 없으며, '그 카드에 있는 패딩, 하지만 모바일에서만'과 같은 것을 말로 설명하는 데 10분을 허비할 수도 있습니다.
/live-canvas는 사용자 인터페이스(UI)가 올라간 가벼운 localhost 페이지를 하나 구동합니다. 사용자는 변경이 필요한 요소를 클릭하고, 원하는 내용을 입력한 후 제출합니다. 여러 요소에 대해 원하는 만큼 댓글을 달 수 있으며, 한 번의 작업으로 모든 것을 처리한 다음 배치(batch)를 에이전트에게 전송합니다.
결과가 돌아오는 방식은 두 가지입니다:
- JSON 모드 — 피드백이 파일로 저장되며, 사용자가 에이전트에게 이를 읽도록 지시합니다. 모든 도구에서 작동합니다.
- 라이브 모드 — MCP 채널을 통해 각 댓글이 세션으로 직접 스트리밍되어 편집 내용이 브라우저에 있는 동안에도 적용됩니다. Claude Code 전용입니다.
또한, 실제 UI 방향(direction) 기능도 내장하고 있어, 사용자가 실제로 원하는 것이 무엇인지 알아내기 위해 div를 조정하는 데 몇 시간을 낭비할 필요 없이 화면의 다양한 변형을 생성하여 선택할 수 있도록 합니다.
/self-review → /branch-review → /release → /refactor
/self-review — 마지막 self-review 이후의 코드와 구조(작동 여부, 회귀 없음, 정리 필요 항목 — 데드 코드, 상태 소유권, 재사용성, 명명 규칙, 성능 — 간과되거나 사양이 부족한 부분)를 검토하거나, 지정된 정확한 커밋 해시 또는 a..b 범위를 검토합니다(더러운 트리는 중단). /branch-review 이전에 실행됩니다. 오케스트레이터는 핸드오프만 작성하고, 생성된 미들티어 워커 하나가 실제 실행을 통해 이를 깨뜨리려고 시도하며 최대 5개의 실패 문장 항목과 최대 5개의 정리 항목을 보고합니다: 지금 수정 ( /branch-review 전에 수정) 및 나중에. 모든 항목은 라인에 고정될 수 있으며, nit, change 또는 idea로 태그가 지정되어 수정 장부에 들어갑니다(누락됨, 구축할 가치가 있음). 이 워커는 절대 아무것도 수정하지 않습니다. 게이트 역할을 하지 않습니다.
/branch-review — 핵심 기능입니다. 브랜치에 있는 모든 변경 사항을 검토하며, 기본적으로 중간 깊이로 수행하거나 지정된 정확한 커밋 해시 또는 범위를 검토합니다(기록 없음, 문서 스윕은 나중에). 확인된 블로커만 노출합니다: 실제 버그, 테스트 품질, 그리고 전체 OWASP 형태의 보안 패스(누출된 키 없음, 주입 없음, 신뢰 경계 확인)가 레벨에 관계없이 최대 깊이로 실행됩니다. 비블로킹인 모든 항목은 수정 장부로 이동합니다. 또한 브랜치 변경 사항에 대해 프로젝트 문서 — README, PRD, 발견 사항 — 을 스윕하고 커밋합니다. 이는 리뷰가 확정된 후 한 번(준비되었거나, 블로커가 이름으로 모두 통과될 때마다) 이루어집니다.
/release — 마지막 사전 릴리스 작업을 수행합니다: 짧은 기계적 검사(lint, 마이그레이션, origin과 동기화; 리뷰 기록의 tests: 라인이 커버하지 않는 경우에만 테스트 실행)를 실행하고, CHANGELOG 항목을 작성하며, 버전을 올리고, 로컬에 커밋합니다. 그런 다음 병합할 준비가 되었음을 알려주고 시퀀스를 반환합니다. 절대 푸시하지 않습니다.
/refactor — 인수가 없으면 수정 장부를 처리합니다: nit 항목을 수정하고, change 및 idea 항목(리팩토어보다 큰 것) 목록을 나열하며, 각각 유지할지, 제거할지 또는 사양화할지 요청합니다. 설계상 누적됩니다: nits는 사용자가 정리하기로 선택할 때까지 쌓이므로, 리뷰나 릴리스가 그에 의해 침몰하는 일이 없습니다.
전체 영역 인자(whole-area argument)를 사용하면 먼저 후보 목록(무엇이 잘못되었는지, 제안된 변경 사항, 강점)을 나열한 후 중단합니다. 선택하는 항목만 편집됩니다.
더 깊은 문서 (Deeper docs)
| 문서 | 내용 |
|---|
/remember | /stash → /remember 파이프라인, 마찰 센서(friction sensor), 항원 원장(antigen ledger) |
| ... | |
링크 (Links)
Apache-2.0 © 2026 hamr0 — LICENSE 참조.