mattbaconz/signal

증명 가능한 압축. Dense mode 에이전트가 생존할 수 있는 환경.

에이전트를 위한 전문적인 토큰 압축 (Token compression): 상시 가동되는 SIGNAL-3, 입력 압축 (Input compression), 최소화된 스킬 페이로드 (Minified skill payloads), 구조화된 간결한 답변 (Structured terse replies), 그리고 체크포인트가 적용된 긴 세션 (Checkpointed long sessions).

주제	요약
얻을 수 있는 것	에이전트 내 더 짧은 지침(Instructions) + 답변; 필요할 때 전체 스레드 기록을 붙여넣는 대신 체크포인트 (S3) 사용.
실행 방법	npx skills add mattbaconz/signal → 또는 signal3. 일반적인 설치에는 클론 (Clone)이 필요하지 않음. /signal3
이 트리 구조의 의미	= 편집 가능한 소스 사양 (Source specs). skills/ · gemini-signal/ · claude-signal/ = 미러링된 호스트 패키지 (직접 편집하지 마세요; CONTRIBUTING 참조). kiro-signal/

프로토콜 엔트리포인트 (Protocol entrypoints): skills/signal.min.md

· 심볼 (Symbols) skills/signal-core.min.md

· 저장소 (Repo) github.com/mattbaconz/signal · 릴리스 (Releases) CHANGELOG.md

npx skills add mattbaconz/signal

그 다음 어떤 프롬프트에서도 Signal을 사용하세요:

signal3

호스트가 슬래시 명령어를 노출하는 경우 슬래시 명령어 (Slash commands)도 지원됩니다:

/signal3

이것이 일반적인 경로입니다. 클론 (Clone)이 필요하지 않습니다.

flowchart TD
A["Signal을 원하시나요?"] --> B["빠른 설치: 클론 불필요"]
B --> C["npx skills add mattbaconz/signal"]
...

사용자가 signal3를 아예 입력할 필요가 없도록 Signal을 기본 호스트 규칙 (Default host rule)으로 만들고 싶을 때만 클론하세요:

git clone https://github.com/mattbaconz/signal
cd signal

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-signal-all.ps1 -AlwaysOn

클론된 상태에서:

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\auto-benchmark.ps1

정적 v0.4 피스처 (Fixtures) 결과에 따르면, 입력 압축 (Input-compression) 및 스킬 오버헤드 (Skill-overhead) 점검 전반에 걸쳐 11/11 충실도 통과 행 (Fidelity-pass rows), 중앙값 예상 절감률 73.5%, 그리고 **p10–p90 절감률 39.8%–89.9%**를 보여줍니다. 실시간 출력 (Live output) 주장은 별도로 보고되며, 유효하려면 충실도 게이트 (Fidelity gates)를 통과해야 합니다.

긴 코딩 에이전트 (Coding-agent) 세션을 실행하거나, 대규모 AGENTS.md / CLAUDE.md / GEMINI.md 파일을 유지할 때 Signal을 사용하세요.

파일들, 또는 어시스턴트를 우스꽝스러운 페르소나로 만들지 않으면서 간결한 답변이 필요할 때 Signal을 사용하세요. 실질적인 약속은 간단합니다: 반복되는 컨텍스트 감소, 불필요한 토큰 (filler tokens) 감소, 동일하게 보호되는 기술적 세부 정보.

데모 (Demo) · 설치 (Install) · 명령어 (Commands) · Signal vs 원시적 방식 (Caveman-style) · 벤치마크 (Benchmark) · 리포지토리 맵 (Repo map) · 아키텍처 (Architecture) · 변경 이력 (Changelog)

전/후 (Before / after) · 티어 (Tiers) · Karpathy 규범 (Karpathy norms) · Git & CI · 스타 (Stars)

가장 먼저 신뢰해야 할 것: v0.4 검증 스위트 (proof suite)는 정적 입력/기술 축소 (skill shrinkage)와 실시간 출력 토큰 (live output-token) 주장을 분리합니다. 현재 정적 검증은 입력 압축 및 기술 오버헤드 (skill-overhead) 고정값 전반에 걸쳐 11/11의 충실도 통과 행 (fidelity-pass rows), 73.5%의 중앙값 추정 절감량 (median estimated savings), 그리고 39.8%~89.9%의 p10–p90 절감량을 기록하고 있습니다. 실시간 승리 횟수는 충실도 게이트 (fidelity gate)를 통과했을 때만 집계됩니다. 세부 사항: 벤치마크 (Benchmark) · docs/benchmark-methodology.md · docs/token-metrics.md.

설명용 데이터: 시나리오 A–C는 ceil(characters / 4)를 사용합니다.

(청구되는 API 토큰이 아님) — 형태를 보여주기에는 좋으나, 실제 토크나이저 (tokenizer) 수를 보고하는 호스트와 비교하는 주요 "증거"로는 적합하지 않습니다.

재현 방법: benchmark/run.ps1 (검증 스위트, 실시간 드라이 런 (dry-runs), 그리고 긴 세션 실행기) · 방법론 docs/benchmark-methodology.md.

👤 장황한 에이전트 (Verbose agent)	🌐 SIGNAL
“제 생각에 문제는 auth.js의 47번 라인 근처에 있는 것 같습니다...”	auth.js:47 · null ref · guard — 스크립트된 벤치마크에서 토큰이 약 7배 적음.
컨텍스트에 10턴의 채팅 + 도구 노이즈 (tool noise)를 붙여넣음.	CKPT 원자 (atom): 스택, 진행 상황, 다음 단계 — 대화 기록 (transcript)은 컨텍스트 창 밖에 유지됨.
하나의 거대한 SKILL.md 트리 + 영구적인 참조.	인간에게는 표준적인 형태, 에이전트에게는 .md — 8개 주요 기술 쌍(Benchmark) 전반에서 .min.md가 약 85% 더 작음.

npx skills add mattbaconz/signal

signal3를 사용하거나

긴 에이전트 작업 (agentic work)을 위해 권장되는 고밀도 모드 (dense mode)를 활성화하려면 에이전트 채팅에서 /signal3를 사용하세요. 가장 작은 활성화 영역을 원하면 /signal을, 중간 티어를 원하면 /signal2를 사용하세요.

전역 설치 (Global install):

npx skills add mattbaconz/signal -y -g

빠른 설치 (fast install)를 사용하면 클론 (cloning) 없이 스킬 (skill)을 바로 얻을 수 있습니다. 호스트 메모리 파일 (host memory files)을 작성하는 헬퍼 스크립트 (helper scripts)가 필요한 경우에만 리포지토리 (repo)를 클론하세요. 이 스크립트가 있어야 일반적인 프롬프트 (prompts)가 기본적으로 SIGNAL-3를 사용하게 됩니다.

git clone https://github.com/mattbaconz/signal
cd signal

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-signal-all.ps1 -AlwaysOn -DryRun
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-signal-all.ps1 -AlwaysOn

드라이 런 (dry run)은 변경될 모든 파일을 출력합니다. 실제 실행 (real run)은 AGENTS.md, CLAUDE.md, GEMINI.md와 같은 지원되는 호스트 명령어 파일 (host instruction files)을 업데이트합니다. 수동 템플릿 (Manual templates)은 docs/always-on.md에 문서화되어 있습니다.

호스트 (Host)	최적의 경로 (Best path)	자동 활성화 (Auto-activation)
Claude Code	플러그인 마켓플레이스 (Plugin marketplace) 또는 독립형 ~/.claude/skills/ 복사	플러그인/훅 (Plugin/hooks)이 상기시킬 수 있음; 슬래시 명령어 (slash command)는 여전히 명시적임
OpenAI Codex	npx skills add mattbaconz/signal 또는 .codex/skills로 복사	AGENTS.md를 통해 S3를 항상 켜짐 (always-on) 상태로 만들 수 있음
Gemini CLI	Gemini 확장 패키지 (extension package) 또는 리포지토리 루트의 GEMINI.md	GEMINI.md를 통해 S3를 항상 켜짐 (always-on) 상태로 만들 수 있음
Cursor	skills/rules를 Cursor 스킬/룰 경로로 복사	.cursor/rules/signal.mdc를 통해 S3를 항상 켜짐 (always-on) 상태로 만들 수 있음
Windsurf	생성된 .windsurf/rules/signal.md	룰 (Rules)이 자동으로 적용될 수 있음
Cline	생성된 .clinerules/signal.md	룰 (Rules)이 자동으로 적용될 수 있음
GitHub Copilot	생성된 .github/copilot-instructions.md	명령어 파일 (Instruction file)이 리포지토리 컨텍스트 (repo context)에서 적용됨
Kiro	kiro-signal/skills/<name> 서브트리 (subtree)에서 임포트 (Import)	스킬별 임포트; 활성화는 Kiro 워크스페이스 (workspace)에 따라 다름

플러그인 (Plugins)은 Claude Code (코딩 에이전트)에만 존재합니다. 사용자용 claude.ai 데스크톱 채팅은 **/plugin**을 노출하지 않습니다. 만약 **/plugin**과 같은 슬래시 명령어가 무시되거나 "알 수 없음("unknown")"으로 표시된다면, 잘못된 앱을 사용 중이거나 오래된 Claude Code 빌드를 사용 중인 것입니다. Claude Code를 업데이트하고 다시 시작하세요. 공식 문제 해결 가이드: Discover plugins — "/plugin command not recognized".

A) 플러그인 마켓플레이스 (/plugin이 작동할 때) — ...

Claude Code 세션에서, 다른 슬래시 명령 (slash commands)과 동일한 입력을 사용합니다:

/plugin marketplace add mattbaconz/signal
/plugin install signal@signal-suite

(owner/repo 형식은 GitHub에서 작동하며, 대신 전체 Git URL을 사용할 수도 있습니다.) 그 다음 **/reload-plugins**를 실행하세요. 마켓플레이스 ID는 signal-suite이며, **claude-signal/README.md**를 통해 확인하세요. 상세 정보:

/plugin marketplace list를 실행하면 signal-suite가 나타납니다. 플러그인을 사용하면 기술 (skills)에 네임스페이스 (namespace)가 지정됩니다: /signal:signal, /signal:signal-commit, ... (플러그인 이름 signal 뒤에 콜론(:)을 붙이고, 그 뒤에 claude-signal/skills/ 하위의 폴더 이름을 붙입니다).

B) /plugin을 사용하지 않는 경우 — 독립형 기술 (Claude가 ~/.claude/skills/를 로드하는 모든 곳에서 작동): 이 리포지토리를 클론(clone)하고, 필요한 경우 다음을 실행한 후 사용하세요:

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-signal-all.ps1

이 명령은 claude-signal/skills/를 **%USERPROFILE%\.claude\skills\**로 복사합니다. 그 다음 /signal, **/signal-commit**과 같은 짧은 명령어를 사용하세요 (Commands 섹션 참조). 동일한 기술에 대해 플러그인을 중복으로 설치하지 마십시오.

C) 일회성 실행: 플러그인 디렉토리가 포함된 터미널에서 Claude Code를 실행합니다 — (리포지토리에서 claude --plugin-dir ./claude-signal실행).claude-signal/README.md`를 참조하세요.

선택 사항: 항상 켜져 있는 가벼운 기본 설정을 위해 templates/claude-CLAUDE.min.md를 프로젝트의 **CLAUDE.md**에 병합하세요.

사용자는 모든 프롬프트에 /signal3를 입력할 필요가 없습니다. 호스트 지침 파일 (host instruction file)을 한 번만 추가하면 그 다음부터는 일반적인 프롬프트를 입력하면 됩니다. 에이전트는 signal3, SIGNAL-3, /signal3를 동일한 리셋 명령으로 취급합니다.

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-signal-all.ps1 -AlwaysOn -DryRun
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-signal-all.ps1 -AlwaysOn

상세 정보 및 호스트 파일 맵: docs/always-on.md

명령 (Command)	기능 (What it does)
/signal	S1 — entry tier (진입 단계)
/signal2	S2 — strong default (강력한 기본값)
/signal3	S3 — auto-CKPT (자동 체크포인트)
/signal-commit	Stage + conventional commit (스테이징 + 관습적 커밋)
/signal-push	Commit + push (커밋 + 푸시)
/signal-pr	Push + PR (gh 사용)
/signal-review	한 줄 리뷰, 심각도(severity) 필수
/signal-state	.signal_state.md
/signal-compress	fidelity gates (충실도 게이트)를 통한 메모리/규칙/문서 압축
/signal-diff	요약된 변경 사항
/signal-search	요약된 검색

계층 상세 정보: Tiers.

이 저장소에는 기존의 최상위 signal/ 디렉토리가 없습니다 — 이를 언급하는 오래된 문서는 무시하세요. 이 표가 클론(cloning) 후 실제로 열게 될 내용입니다.

위치 (Location)	설명 (What it is)	사용 조건 (You need it if…)
[skills/](skills/)	표준 기술 사양(Canonical skill specs): *.md (읽기용) + *.min.md (밀집형)	npx skills add를 통해 설치하거나 에이전트(agent)에 기술을 복사하는 경우
[gemini-signal/](gemini-signal/), [claude-signal/](claude-signal/)	미러링된 호스트 확장 레이아웃 (도구별 SKILL.md)	이 트리에서 Gemini CLI 또는 Claude Code 플러그인을 배포하는 경우
[kiro-signal/](kiro-signal/)	Kiro 미러: skills/ + 경로가 재작성된 번들 references/	Kiro IDE로 가져오는 경우 — docs/kiro.md 참조
[references/](references/)	공유 참조 (심볼, Karpathy 규범, 벤치마크, 체크포인트 노트)	규범(norms)이나 심볼을 인용하는 경우
[templates/](templates/)	프로젝트의 GEMINI / CLAUDE 파일에 병합할 스니펫(Snippets)	앱 저장소에 SIGNAL을 통합하는 경우
[scripts/](scripts/), [benchmark/](benchmark/)	shrink.ps1, sync-integration-packages.ps1, verify.ps1, 검증용 벤치마크 러너(runners)	로컬에서 기여하거나 검증하는 경우 (CONTRIBUTING.md)

SIGNAL은 단순히 "간결하게 말하기"가 아닙니다. 이는 밀집된 출력(dense output), 압축된 입력(compressed input), 지속 가능한 상태(durable state), 그리고 재현 가능한 증거(reproducible evidence)가 필요한 에이전트들을 위한 프로토콜 표면(protocol surface)입니다. 핵심적인 가설은 전문적인 압축에는 단순히 짧은 말투가 아니라, 게이트(gates)와 아티팩트(artifacts)가 필요하다는 것입니다.

flowchart LR
subgraph inputs [Verbose]
V1[Long replies]
...

누적 (Cumulative) 트랜스크립트 절약량 (베이스라인 대비 체크포인트 방식 히스토리)은 전체 클론 후 benchmark/README.md (benchmark/long-session/)에서 다룹니다. 프롬프트 (Prompt) vs 출력 (output) vs 전체 토큰 (tokens.total) — 호스트마다 보고하는 범위가 다르므로 docs/token-metrics.md를 참조하십시오.

Caveman은 간결한 에이전트 출력을 설치하기 쉽게 만들고 대중화시켰기 때문에 적절한 비교 대상입니다. 현재 공개된 README에 따르면 단 한 줄의 npx skills add JuliusBrussee/caveman 설치로 사용 가능하며, Claude API 벤치마크 프롬프트 전반에서 평균 출력 절약량은 약 65%, 메모리 파일에 대한 caveman-compress 입력 절약량은 약 **46%**로 보고되었습니다. Caveman의 릴리스 노트는 또한 재현 가능한 벤치마크 시스템과 원-커맨드 (one-command) 설치를 강조합니다.

SIGNAL v0.4.0은 다른 축에서 경쟁합니다: 검증 게이트 (proof gates)를 갖춘 전문적인 밀집 모드 (professional dense mode)입니다.

기능 (Capability)	Caveman 스타일 베이스라인	SIGNAL v0.4.0
출력 스타일 (Output style)	페르소나/전보식 압축 (Persona/telegraphic compression)	전문적인 밀집 프로토콜 (Professional dense protocol): 간결함, 서문 없음, 신뢰도 토큰 (confidence tokens), 템플릿
...

공정한 주장은 "SIGNAL이 항상 Caveman보다 적은 출력 토큰을 생성한다"가 아닙니다. Caveman은 원시 출력 압축 (raw output compression)에 매우 강력합니다. SIGNAL의 더 강력한 주장은 다음과 같습니다: Signal은 모든 벤치마크 주장이 충실도 게이트 (fidelity gate)를 통과해야 하고 재현 가능한 JSON으로 매핑되어야 하므로, 전문적인 에이전트 워크플로우 (professional agent workflows)에서 더 신뢰하기 쉽습니다.

/signal , /signal2 , 또는 /signal3 를 사용하십시오.

티어 (Tier)	제공 사항	대략적인 습관적 절약량
S1	기호 (Symbols), 서문 없음, 망설임 없음 (no hedge), 간결함	~35%
S2	S1 + BOOT, 별칭 (aliases), 델타 친화적 턴 (delta-friendly turns)	추가로 약 ~20%
S3	S2 + 5턴마다 자동 체크포인트 (auto-checkpoint)	긴 세션이 제한된 범위 내로 유지됨

기호 (Symbol)	의미 (Meaning)	예시 (Example)
→	유발 / 생성 (causes / produces)	nullref→crash
∅	없음 / 제거 / 비어있음 (none / remove / empty)	cache=∅
Δ	변화 / 차이 (change / diff)	Δ+cache→~5ms
!	필수 / 반드시 (required / must)	!fix before deploy
[n]	신뢰도 (confidence) 0.0–1.0	fix logic [0.95]

전체 참조: [skills/signal-core.min.md](skills/signal-core.min.md)

.

v0.4.0은 증명 우선 벤치마크 방법론 (proof-first benchmark methodology)을 사용합니다. 압축을 통한 이득은 충실도 (fidelity)가 통과될 때만 인정됩니다: 보호된 코드 (protected code), 경로 (paths), 줄 번호 (line numbers), 버전 (versions), 인용된 오류 (quoted errors), 식별자 (identifiers), 그리고 기술 용어 (technical terms)는 온전하게 유지되어야 합니다. 위에 생성된 다이어그램은 시각적 요약이며, 진실의 근원 (source of truth)은 체크인된 JSON과 러너 (runner)입니다.

벤치마크 암 (Benchmark arms):

Arm	목적 (Purpose)
baseline	일반적인 에이전트/시스템 프롬프트 (Normal agent/system prompt)
terse-control	명시적인 "간결하게 답변하라" 제어 (Explicit "answer concisely" control)
caveman-style	전보식/페르소나 스타일의 압축 제어 (Telegraphic/persona-style compression control)
signal	실제 SIGNAL 기술/기본값 (Actual SIGNAL skill/defaults)

flowchart LR
P["Scenario fixtures"] --> A["4 arms: baseline, terse-control, caveman-style, signal"]
A --> M["Measure input tokens, output tokens, total tokens, chars"]
...

현재 정적 스냅샷 (Current static snapshot): benchmark/results/v0.4-static.json