Mathews-Tom/armory: AI 코딩 에이전트를 위한 패키지 모음

AI 코딩 에이전트(AI coding agents)를 위한 큐레이션되고, 프로덕션 등급의 스킬(skills), 에이전트(agents), 후크(hooks), 규칙(rules), 명령어(commands), 유틸리티(utilities), 그리고 프리셋(presets)입니다. 마법이나 데모가 아닌 — AI를 진지하게 사용하는 개발자를 위해 구축된 검증된 워크플로우입니다.

armory는 Claude Code와 Claude.ai용 패키지 모음집입니다. 각 패키지는 특정 작업 영역에 대해 Claude를 반복 가능하고, 의견이 담긴(opinionated) 워크플로우로 확장하는 자립형 프롬프트 또는 자동화 단위입니다. 이 패키지들은 스킬, 에이전트, 후크, 규칙, 명령어, 유틸리티, 프리셋의 일곱 가지 유형에 걸쳐 있습니다.

철학: 이 컬렉션의 패키지들은 실용적이며 컨텍스트에 구애받지 않습니다. 단순히 *무엇(what)*을 정의하는 것이 아니라 *어떻게(how)*를 정의하며 — 입력, 출력, 엣지 케이스(edge cases), 그리고 실패 모드까지 다룹니다. 이들은 예시로 구성된 것이 아니라 실제 워크로드에서 테스트되었습니다.

AI 코딩 에이전트를 자신의 워크플로우의 중요한 부분으로 취급하는 개발자를 대상으로 합니다.

계획 패키지들을 상호 교환 가능한 형식으로 사용하는 것이 아니라 순서대로 사용해야 합니다:

unknown destination → decision-map → known design → plan-prompts → task-decomposer / plan-review → milestone-runner → stacked-prs

오케스트레이터 에이전트(Orchestrator agents)는 스킬과 다른 에이전트를 결합하여 다단계 워크플로우를 구성합니다. 각 에이전트는 단독으로 실행되거나, Agent 툴을 통해 다른 에이전트에 의해 생성될 수 있습니다.

기본적으로 노력을 기울입니다. 선언된 타겟 매트릭스는 별칭(alias)과 예상되는 완전히 공개된 모델 ID 접두사(fully disclosed model-id prefix)를 기록합니다. 날짜가 찍힌 스냅샷은 관찰된 수신 필드이며, 이 선언으로부터 절대 추론되지 않습니다. max

노력을 실제로 어려운 새로운 문제에만 사용하십시오 (수익 감소, 과도한 생각 위험); high

동시 세션 또는 비용 민감 작업용입니다.

model_fit.yaml

클라이언트/모델/노력/프로필/텔레메트리 매트릭스를 선언합니다. 현재 타겟은 Claude Code의 opus 별칭을 요청하며, claude-opus-로 시작하는 공개된 모델 ID를 요구하고, 관찰된 입력 토큰 및 출력 토큰 필드를 요구합니다.

모델 요청을 생성하지 않고 프로필 유효성 검사:

uv run python scripts/model_fit.py --target claude-code-opus-xhigh --profile core --dry-run
uv run python scripts/model_fit.py --target claude-code-opus-xhigh --profile full --dry-run

드라이 런(Dry runs)은 claude --version을 읽고 저장소 패키지 정의만 해결합니다. 이들은 발견된 메타데이터를 보고하고 패키지 내용이 로드되지 않았음을 명시적으로 밝힙니다. 프로필을 설치하거나 유료 호출을 수행하지 않습니다.

모델 요청이 승인된 경우에만 --live --output /path/to/receipt.json을 사용하십시오. 이 프로브는 내장 도구를 비활성화하고, 주변 MCP 구성을 억제하며, 세션을 영구 저장하지 않습니다. 그 수신(receipt)은 파생된 필드만 저장합니다: 선언된 타겟/프로필/도구 표면(tool surface), 클라이언트 버전, 타겟이 선언한 접두사와 일치해야 하는 관찰된 모델, 필수 토큰 필드, 경과 시간(wall time), 터미널 메타데이터. 원시 프롬프트, 어시스턴트 텍스트 및 스트림 이벤트는 절대 보존되지 않습니다. 누락되거나 변경된 필수 필드가 있으면 비제로 종료됩니다; 이 프로브는 절대로 토큰 값을 추정하지 않습니다.

아래 스킬들은 기본 모델의 기능으로 대체되었습니다. 여전히 설치는 가능하지만 더 이상의 업데이트는 제공되지 않습니다.

| Preset | Packages | 설명 |
|---|---|
| core | 3개의 스킬, 1개의 후크, 1개의 규칙 | 기본 검토-커밋 라이프사이클. 여기서 시작하세요. |
| ... |
오케스트레이터 에이전트(orchestrator agents)가 수동적인 스킬 호출 대신 자율적인 워크플로우 오케스트레이션을 제공하여 대체되었습니다.

npx skills를 사용하여 모든 패키지를 직접 설치합니다.

# 모든 패키지 설치
npx skills add Mathews-Tom/armory
# 특정 스킬 또는 에이전트 설치
...

옵션 2 — 프로필 설치 프로그램

git clone https://github.com/Mathews-Tom/armory.git
cd armory
# 프로필별 설치
...

모든 패키지의 버전을 인식하는 표를 표시하고, 설치된 버전을 감지하며, 어떤 것을 설치하거나 업그레이드할지 선택할 수 있게 해줍니다. 프로파일은 모든 유형에 걸쳐 선별된 패키지 묶음(bundle)을 설치합니다.

옵션 3 — Claude Code 플러그인 마켓플레이스 (skills, agents, commands 전용)

claude plugin marketplace add Mathews-Tom/armory
/plugin install armory

이것은 Claude Code의 네이티브 플러그인 시스템을 사용하며 armory 카탈로그의 일부를 로드합니다.

옵션 4 — 수동(Manual)

레포지토리를 클론하고 개별 패키지 폴더에 심볼릭 링크(symlink)를 만드세요:

git clone https://github.com/Mathews-Tom/armory.git
# Skills
ln -s "$(pwd)/armory/skills/architecture-reviewer" ~/.claude/skills/architecture-reviewer
...

또는 릴리스 페이지에서 .skill / .agent 아카이브를 다운로드하세요.

패키지는 Claude가 일치하는 의도(intent)를 감지할 때 활성화됩니다. 각 패키지는 프론트매터 설명에 트리거 구문(trigger phrases)을 정의합니다. 이 정의 파일(SKILL.md, AGENT.md 등)은 각 폴더에서 확인하세요.

예시 트리거:

"이것을 GitHub에 푸시하기 전에 보안 감사를 실행해줘"
-> 활성화: repo-sentinel (skill)
"이 코드를 품질 문제로 검토해줘"
...

**명령어(Commands)**는 슬래시 구문(/)을 통해 명시적으로 호출됩니다:

/tdd calculate_discount -> 함수에 대한 TDD 워크플로우
/security-scan src/ -> 보안 취약점 감사
/refactor src/utils.py -> 코드 단순화

**훅(Hooks)**은 Claude Code 라이프사이클 이벤트(PreToolUse, PostToolUse, Stop, UserPromptSubmit) 발생 시 자동으로 작동합니다. **규칙(Rules)**은 관련될 때 컨텍스트로 로드됩니다. **사전 설정(Presets)**은 just install-profile을 통해 묶음을 설치합니다.

모든 패키지는 package-evaluator를 사용하여 6가지 공유 차원(shared dimensions)으로 평가되며, 에이전트, 훅, 규칙, 명령어, 유틸리티, 사전 설정에 대한 유형별 신호가 있습니다:

— positive triggers (활성화되어야 함) 및 negative triggers (활성화되어서는 안 됨). Deprecated packages는 0개의 positive 케이스 + 2개의 negative 케이스를 강제합니다.

유효성 검사(Validation):

uv run scripts/validate_evals.py # 모든 eval 파일에 대한 스키마 유효성 검사
uv run scripts/generate_manifest.py # manifest.yaml 재생성

CI 파이프라인 (.github/workflows/evals.yml):

:-

PR 게이트: 모든 7개 타입 디렉터리에서 풀 리퀘스트(pull request)마다 manifest 동기화 + eval 스키마를 검증합니다.
주간 크론: 월요일에 실행되어 모델 드리프트 감지 기능을 수행합니다.

Pre-commit hook: 패키지 정의 파일 중 하나가 변경될 때 manifest.yaml을 자동으로 재생성합니다.

MCP 서버는 armory 패키지를 모든 에이전트 세션에서 검색 가능한 도구로 노출합니다. Claude Code 설정에 등록하세요:

{
"mcpServers": {
"armory": { "command": "uv", "args": ["run", "mcp/server.py"] }
...

사용 가능한 도구(Available tools):

스킬은 agentskills.io 오픈 표준을 기준으로 유효성 검사됩니다:

uv run scripts/validate_agentskills.py # 경고만 (기본값)
uv run scripts/validate_agentskills.py --strict # 추가 필드는 오류로 간주

76개 스킬 모두 0개의 오류와 함께 통과합니다. 검증기는 6개 필드 frontmatter 사양(name, description, license, compatibility, metadata, allowed-tools)을 확인하고 Claude Code 전용 필드를 경고로 표시합니다.

각 패키지는 배포를 위해 아카이브될 수 있습니다. 아카이브 유형은 디렉터리에서 자동 감지됩니다:

uv run scripts/package.py skills/architecture-reviewer # .skill 생성
uv run scripts/package.py agents/code-reviewer # .agent 생성
uv run scripts/package.py hooks/git-protection # .hook 생성

패키지는 Claude Code 네이티브 정의(Claude Code-native definitions)로 작성됩니다. 어댑터 생성기(adapter generator)는 이를 Cursor, OpenAI Codex, Gemini CLI용 플랫폼별 형식으로 변환합니다.

# 모든 플랫폼
uv run scripts/generate_adapters.py
# 단일 플랫폼
...

결과는 adapters/{platform}/에 저장됩니다.
(gitignored — 생성된 파일이며 소스 코드가 아님).

최신 릴리스에서 미리 빌드된 어댑터 패키지를 다운로드하세요:

# Cursor
npx @anthropic-armory/installer --target cursor
# Codex
...