@uzysjung/agent-harness 26.117.0 → 26.119.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ko.md CHANGED
@@ -1,13 +1,6 @@
1
1
  # uzys-agent-harness
2
2
 
3
- **기술 스택에 실제로 필요한 AI 코딩 스킬·플러그인만 골라, 한 번의 명령어로 Claude Code · Codex · OpenCode · Antigravity 에 세팅한다아이디어부터 출시까지 에이전트가 탈선하지 않게 잡아주는 라이프사이클 규율과 함께.**
4
-
5
- 코딩 에이전트는 기본기가 계속 강해지고 있다 — 안 쓸 스킬과 MCP 를 쌓으면 컨텍스트 창만 부풀고, awesome-list 는 내 프로젝트에 맞는 것을 일일이 고르기엔 선택지가 너무 많다. `agent-harness` 는 두 가지를 한다:
6
-
7
- 1. **스택 기반 lean 큐레이션** — 검증된 옵션 중에서, 이 프로젝트에 실제로 필요한 것만 설치.
8
- 2. **규율 레이어(discipline layer)** — 실제 프로덕션 프로젝트를 에이전트로 운영하며 증명된 룰·훅·CI 스캐폴드: 문서 거버넌스, 검증 게이트, 벤치마크 패리티 루프, 재발 방지. 이 규율 레이어 덕분에 이 도구는 단순한 스킬 모음이 아니라 *하네스*가 된다 ([상세 ↓](#규율-레이어--무엇이-하네스인가)).
9
-
10
- **Claude Code 는 전체 지원(모든 자산·훅·플러그인); Codex / OpenCode / Antigravity 는 skills + rules 레이어를 받는다.** 디폴트는 project scope — 명시적으로 선택하지 않는 한 글로벌 영역 미수정.
3
+ 검증된 AI 코딩 스킬·플러그인·룰·훅을 Claude Code, Codex, OpenCode, Antigravity 에 설치한다대화형 위저드 번, 프로젝트 범위로.
11
4
 
12
5
  [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
13
6
  [![Version](https://img.shields.io/github/v/tag/uzysjung/uzys-agent-harness?label=version)](https://github.com/uzysjung/uzys-agent-harness/releases)
@@ -15,8 +8,6 @@
15
8
 
16
9
  ![agent-harness 데모 — 검증된 AI 코딩 스킬·플러그인 원커맨드 설치](https://raw.githubusercontent.com/uzysjung/uzys-agent-harness/main/docs/assets/agent-harness-demo.gif)
17
10
 
18
- > **"vetted(검증됨)"의 의미** — GitHub star ≥ 1000 + 활성 유지보수 + Docker 격리 실설치 검증(현재 51/65 자산 green), 월간 CI cron 재검증([catalog-verify](docs/COMPATIBILITY.md), [trust-tier-drift](.github/workflows/)). 자산 코드의 라인 단위 보안 감사나 prompt-injection 스캔까지 보장하는 것은 **아니다**. npm/npx 자산은 버전 고정; **plugin/skill 자산은 upstream HEAD 로 설치(commit-pin 아직 없음)**. 설치 자산은 서드파티 의존성처럼 취급할 것 — [SECURITY.md](SECURITY.md) 참고.
19
-
20
11
  🇺🇸 [English](./README.md)
21
12
 
22
13
  ---
@@ -27,240 +18,82 @@
27
18
  npx -y @uzysjung/agent-harness
28
19
  ```
29
20
 
30
- 6-step interactive wizard 가 안내한다. flag 필요 없음. **기존 프로젝트에도 안전** — `settings.json` / `CLAUDE.md` 는 변경 전 백업(아래 상세); 아무것도 삭제하지 않는다.
21
+ 위저드가 6단계로 안내한다:
31
22
 
32
23
  ```
33
- Step 1/6 Tracks스택 선택
34
- Step 2/6 CLIclaude / codex / opencode / antigravity
35
- Step 3/6 Install items 추천 항목 (pre-checked) 확인
36
- Step 4/6 ScopeProject (default) 또는 Global
37
- Step 5/6 Confirm
38
- Step 6/6 Installing
39
- ```
40
-
41
- 설치 후:
42
-
43
- ```bash
44
- claude # CLI 실행 — 설치된 skills · rules · hooks 가 바로 활성화됨
24
+ 1/6 Tracks 스택 선택
25
+ 2/6 CLI claude / codex / opencode / antigravity
26
+ 3/6 Install items 미리 체크된 추천 항목 검토
27
+ 4/6 Scope Project (기본값) 또는 Global
28
+ 5/6 Confirm
29
+ 6/6 Installing
45
30
  ```
46
31
 
47
- ### 비대화형 설치 (CI / 스크립트 / Docker)
48
-
49
- wizard 는 TTY 가 필요하다. CI 파이프라인·온보딩 스크립트·컨테이너에서는 flag 사용 — 우리 자체 검증 CI 가 도는 것과 같은 경로다:
32
+ 설치가 끝나면 CLI 실행한다 스킬·룰·훅이 활성 상태다:
50
33
 
51
34
  ```bash
52
- npx -y @uzysjung/agent-harness install \
53
- --track tooling --cli claude --scope project \
54
- --with bmad-method
35
+ claude # 또는 codex / opencode / agy
55
36
  ```
56
37
 
57
- | Flag | 의미 |
58
- |------|---------|
59
- | `--track <name>` | 설치할 트랙 (반복 가능) |
60
- | `--cli <target>` | `claude` / `codex` / `opencode` / `antigravity` (반복 가능) |
61
- | `--scope <s>` | `project` (기본) 또는 `global` |
62
- | `--with <asset-id>` / `--without <asset-id>` | 카탈로그 자산 id 로 추가/제외 (반복 가능) — id 는 [호환 매트릭스](docs/COMPATIBILITY.md) |
63
-
64
- ---
65
-
66
- ## 큐레이션 철학 — lean by default
67
-
68
- 프론티어 코딩 모델은 스킬 팩이 가르치던 것을 계속 흡수하고 있다. 우리의 입장: **스킬은 자신이 차지하는 컨텍스트 비용 이상의 가치를 증명해야 한다** — 설치된 스킬은 안 쓰일 때도 에이전트의 어텐션을 점유하므로, 기본 설치는 최소로 유지하고 "스킬이 많음"은 기능이 아니라 비용으로 취급한다.
69
-
70
- 여전히 가치 있다고 믿는 것은 지식 레이어가 아니라 **인사이트 레이어**다:
38
+ **기본값은 project scope 다.** 4단계에서 Global 을 고르지 않는 한 `~/.claude/`, `~/.codex/`, `~/.opencode/`, `~/.gemini/`, 글로벌 npm 에는 아무것도 쓰지 않는다.
71
39
 
72
- - **오케스트레이션 노하우** 모델/effort 역할 분담(`model-orchestration`), 다관점 검증(`multi-persona-review`), 자기 하네스 감사(`harness-health-audit`).
73
- - **크로스-CLI 레버리지** — CLI 별 강점 활용: 자연스러운 산문은 Antigravity(`gemini-consult`), 간결한 구조화 + 이미지 생성은 Codex(`codex-consult`).
74
- - **운영 사실(operational facts)** — CLI flag·인증 흐름·배포 절차(`supabase-cli`, `railway-skills`, …)는 모델이 아무리 똑똑해져도 upstream 릴리즈와 함께 drift 한다. 범용 패턴 가이드가 가장 먼저 불필요해진다.
40
+ **기존 프로젝트에도 안전하다.** 내용이 다른 편집 가능 파일을 교체하기 전에 타임스탬프 백업을 옆에 만들고, 모든 백업 경로를 설치 요약에 출력한다. 삭제하는 것은 없다.
75
41
 
76
- 구조화 워크플로 번들(superpowers, BMAD, OpenSpec, …)은 **opt-in 유지, pre-check 안 함**. 우리 관점: 강한 모델에는 애자일한 방향 + 확고한 git/PR 정책이 강제된 절차보다 낫다(솔로/그린필드 기준) — 단 다수 개발자 간 의견 정렬·주니어 온보딩·감사 추적은 모델 업그레이드로는 해결되지 않는 조직의 문제라, 선택은 사용자의 몫으로 열어둔다([워크플로 큐레이션 가이드](docs/WORKFLOWS.md)).
42
+ 위저드는 TTY 필요하다. CI·컨테이너·온보딩 스크립트용 flag 모드는 [사용 가이드](docs/USAGE.md#non-interactive-install)를 참고한다.
77
43
 
78
- v26.103.0 부터 설치기는 선택 항목의 **세션 시작 컨텍스트 비용**을 표시한다(번들 스킬은 실측, 외부 자산은 정직하게 unmeasured 표기).
44
+ ##
79
45
 
80
- ---
46
+ 코딩 에이전트의 기능은 계속 고도화되고 있다. 하지만 한 번 설치한 skill 과 MCP 는 실제 사용 여부와 상관없이 매 세션 context window 를 차지한다. awesome-list 에 수백 개의 선택지가 있어도 내 기술 스택에 어떤 항목이 맞는지까지는 알려주지 않는다. 결국 모든 항목을 설치해 매 세션 불필요한 비용을 치르거나, 프로젝트를 시작할 때마다 직접 목록을 읽고 골라야 한다.
81
47
 
82
- ## 규율 레이어 무엇이 하네스인가
48
+ 도구는 스택에서 출발한다. 원하는 track 을 고르면 해당 track 이 필요로 하는 자산이 미리 체크된다. 사용자는 설치를 진행하기 전에 선택된 자산을 검토하고 필요 없는 항목을 해제할 수 있다.
83
49
 
84
- 큐레이션 자산은 설치의 절반이다. 나머지 절반은 **프로젝트 라이프사이클 규율** — 우리 프로덕션 프로젝트에서 증명된 룰·훅·스캐폴드를 도메인 중립으로 일반화한 것이다. 에이전트가 실제로 도는 루프를 커버한다 — 방향 → 문서 → 테스트/CI → 검증 → 실브라우저 → 재발 방지:
50
+ ## 무엇을 얻는가
85
51
 
86
- | 라이프사이클 단계 | 설치물 | 강제하는 |
87
- |---|---|---|
88
- | **방향** | `north-star` 스킬 (전 트랙) + `northstar-roadmap` ★ | 비전 문서 → 갭 실측 → 랭킹된 백로그 |
89
- | **문서 거버넌스** | `doc-governance` 룰 (전 트랙) + `spec-drift-check` 훅 | SSOT 위계, "머지 = 코드 **그리고** 추적 동기화", 현행/archive 분리 |
90
- | **딜리버리** | `git-policy` · `change-management` · `gates-taxonomy` 룰 (전 트랙) | conventional commits, 핵심 결정의 ADR 화, 게이트 4유형 |
91
- | **테스트 → CI** | `test-policy` 룰 (dev 트랙) + `ci-scaffold` (opt-in) | 커버리지 threshold, TDD, 실DB CI 템플릿(`.github/workflows/`) |
92
- | **검증** | `reviewer` 에이전트 + `multi-persona-review` ★ | 구현자 ≠ 검증자; 출하 전 다관점 리뷰 |
93
- | **실브라우저 검증** | `playwright-launch` + `benchmark-parity` 룰 (UI 트랙) | 영속 profile capture, 갭 매트릭스(`gap.md`), PR `## Fidelity` 증거 |
94
- | **재발 방지** | `recurrence-prevention` ★ (dev 트랙) | 반복 결함 → 에스컬레이션: 기록 → 강제 룰 → 구조적 게이트 |
52
+ - **스택 기반 큐레이션.** 검증된 옵션 가운데 해당 프로젝트에 실제 필요한 자산만 선택적으로 설치한다. `csr-supabase` 를 고르면 React, shadcn, Supabase, Postgres 자산만 미리 체크되며, 나머지 60여 개 항목은 제외된다.
95
53
 
96
- 전부 가볍고 예측 가능하게 동작한다 레일은 고정하되 안에서 에이전트는 유연하게 움직인다. = 1st-party dev-method 스킬.
54
+ - **규율 레이어.** 실제 프로덕션 프로젝트를 에이전트로 운영하면서 추출한 룰과 훅, CI 스캐폴드로 구성된다. 문서 거버넌스, 검증 게이트, 벤치마크 패리티 루프, 재발 방지 체계를 포함한다. 이 레이어 덕분에 단순한 skill 모음이 아니라 하네스가 된다.
97
55
 
98
- ---
56
+ - **4개 CLI, 하나의 어휘.** Claude Code 는 1급 지원 대상으로 모든 자산, 훅, plugin 을 제공받는다. Codex, OpenCode, Antigravity 는 skill 과 rule 레이어를 지원받는다. 프로젝트가 특정 CLI 에 묶이지 않는다.
99
57
 
100
- ## 기존 프로젝트에 설치
58
+ ## 검증
101
59
 
102
- `agent-harness` 설정을 조용히 덮어쓰지 않는다. 내용이 다른 **편집 가능** 파일을 교체하기 전에 타임스탬프 백업을 만들고, 모든 백업 경로를 설치 요약에 출력한다(`backup` 행). 아무것도 삭제되지 않는다.
60
+ 자산이 vetted 등급을 받으려면 GitHub star 1,000개 이상, 활성 유지보수 상태, 격리된 Docker 컨테이너 실설치 검증 통과라는 가지 조건을 모두 충족해야 한다. CI cron 이 매월 이 세 가지 기준을 다시 검사한다.
103
61
 
104
- | 이미 있는 | 처리 |
105
- |---|---|
106
- | 자체 hooks / statusLine 이 있는 `.claude/settings.json` | 갱신 전 `settings.json.backup-<ts>` 로 백업 |
107
- | 루트 `CLAUDE.md` (생성본과 다른 경우) | 병합 write 전 `CLAUDE.md.backup-<ts>` 로 백업 |
108
- | `--reinstall` / `update` 모드의 `.claude/` | 디렉토리 전체를 먼저 `.claude.backup-<ts>` 로 rename |
109
- | `.mcp.json` | 기존 MCP 서버 보존·병합 (교체 아님) |
62
+ vetted 등급이 라인 단위의 보안 감사나 자산 내용에 대한 prompt-injection 스캔을 의미하지는 않는다. npm 과 npx 자산은 버전이 고정되지만, plugin 과 skill 자산은 upstream HEAD 로 해석되어 아직 commit 고정이 이루어지지 않는다. 따라서 설치하는 모든 자산은 일반적인 서드파티 의존성과 동일하게 취급해야 한다 — [SECURITY.md](SECURITY.md) 참고.
110
63
 
111
- ---
64
+ 모든 자산에는 3단계 중 하나의 등급 배지가 부여된다. Anthropic 공식 마켓플레이스와 하네스 자체 자산은 **★ official**, 검증을 통과한 자산은 **vetted**, GitHub star 1,000개 미만으로 opt-in 이 필요한 자산은 **⚠ experimental** 로 분류된다. 이 등급은 정보 제공을 위한 구분이며 자산 설치를 차단하지는 않는다.
112
65
 
113
66
  ## Tracks
114
67
 
115
- **트랙** = 스택별 프리셋 번들. Step 1 에서 1이상 선택; 트랙이 Step 3 의 pre-check 항목을 결정한다.
116
-
117
- ### Dev tracks
118
-
119
- | Track | Stack |
120
- |---|---|
121
- | `csr-supabase` | Vite + React + Supabase |
122
- | `csr-fastify` | Vite + React + Fastify |
123
- | `csr-fastapi` | Vite + React + FastAPI |
124
- | `ssr-nextjs` | Next.js (App Router) |
125
- | `ssr-htmx` | HTMX + server-side |
126
- | `data` | DuckDB + Polars + PySide6 |
127
- | `full` | dev 트랙 전체 union |
128
-
129
- ### Business tracks
130
-
131
- | Track | 용도 |
132
- |---|---|
133
- | `executive` | 제안서, DD, 발표자료, 재무모델 |
134
- | `project-management` | PM 워크플로우 + 리뷰 |
135
- | `growth-marketing` | Growth + 콘텐츠 마케팅 |
136
-
137
- ### Meta
138
-
139
- | Track | 용도 |
140
- |---|---|
141
- | `tooling` | Bash + Markdown 메타프로젝트 (앱 스택 없음) |
142
-
143
- ---
144
-
145
- ## 트랙별 설치 항목 (요약)
146
-
147
- 트랙 선택 결과로 자동 추천되고 Step 3 에 pre-checked 로 표시된다 — 설치 전 자유롭게 토글. 전체 자산 표와 검증 상태는 [영문 README](./README.md#what-gets-installed-per-track) 와 [호환 매트릭스](docs/COMPATIBILITY.md) 참조. 주요 포인트:
148
-
149
- - **Frontend**: `frontend-design`(Anthropic 공식, **전 dev 트랙 기본**) + `react-best-practices`(vercel-labs) + `shadcn-ui`. `web-design-guidelines` · `impeccable` 은 v26.106.0 부터 opt-in.
150
- - **Backend**: `railway-skills`, Supabase 계열(csr-supabase), `vercel-cli`. `netlify-cli` 는 opt-in(배포 CLI 중복 정리).
151
- - **Data**: `polars` · `dask`(K-Dense) + `anthropic-data-plugin`. Python 패턴 2종(wshobson)은 opt-in.
152
- - **Dev Tools**: `find-skills` · `agent-browser` · `karpathy-coder` + 1st-party dev-method 스킬 8종(★ — 전 dev 트랙 코어, Step 3 에서 해제 가능). `code-review`(Anthropic 공식) 는 opt-in — 기본 리뷰 에이전트와 표면 중복.
153
- - **Security**: `security-guidance`(Anthropic 공식, opt-in — 런타임에 Python·Agent SDK 필요) · `trailofbits-skills`.
154
- - **Workflow (전부 opt-in)**: superpowers · ECC · OpenSpec · BMAD · addy agent-skills · wshobson agents · feature-dev — 7종 비교는 [워크플로 가이드](docs/WORKFLOWS.md).
155
- - **권장 수단 (opt-in)**: `model-orchestration` · `gemini-consult`(agy) · `codex-consult`(codex) — 방법론 코어와 달리 "권장하는 수단". 두 컨설트 스킬은 런타임에 해당 외부 CLI 필요.
156
- - **CI 스캐폴드 (opt-in)**: `--with ci-scaffold` → `.github/workflows/` fill-in 템플릿(태그 트리거 CI + 실DB 서비스 컨테이너 + coverage 게이트 + Playwright E2E). `.claude/` 밖에 쓰는 유일한 자산 — **기존 워크플로 파일은 절대 덮어쓰지 않고**, uninstall 은 `.github/` 를 건드리지 않는다.
68
+ 만드는 것에 따라 11track 으로 나뉜다:
157
69
 
158
- ---
159
-
160
- ## Trust tiers (검증 등급)
161
-
162
- 모든 외부 자산은 **trust tier** 를 가지며 Step 3 에서 배지로 표시된다:
163
-
164
- - **★ official** — Anthropic 공식 marketplace + 본 하네스 자체 자산.
165
- - **vetted** — GitHub star ≥ 1000 + 활성 유지보수. track 적합 시 pre-checked.
166
- - **⚠ experimental** — star 1000 미만. opt-in 만 (pre-check 안 함), 카테고리 하단 표시.
167
-
168
- tier 는 **정보 제공일 뿐 차단하지 않는다** — 최종 선택은 항상 사용자. star-drift 는 월간 CI 로 자동 감시된다.
169
-
170
- > **"검증됨"의 근거는?** [호환·검증 매트릭스](docs/COMPATIBILITY.md) — 설치 방법을 실제 registry/marketplace 에 대조하고, 핵심 워크플로 셋은 **Docker 격리 컨테이너 실설치**로 검증한다(정적 표가 아님).
171
-
172
- ---
173
-
174
- ## Scope
175
-
176
- Step 4 에서 install write 위치 선택.
177
-
178
- | 대상 | Project (default) | Global (opt-in) |
179
- |---|---|---|
180
- | `claude plugin` | `--scope project` (`installed_plugins.json` 의 `projectPath` 로 격리) | `--scope user` |
181
- | `npx skills` | project `node_modules` | `-g` (user-level) |
182
- | `npm` | `--save-dev` (devDependency) | `-g` |
183
- | Codex (prompts / skills / config) | 프로젝트 `.codex/` | `~/.codex/` |
184
- | Antigravity (skills / workflows) | 프로젝트 `.agents/` | `~/.gemini/antigravity/` |
185
- | `~/.claude/skills/` · `~/.codex/` · `~/.opencode/` · `~/.gemini/` · `npm root -g` | **미수정** | 자산별 write |
186
-
187
- Project scope 는 install 을 본 레포에 가둔다. 동일 머신의 다른 프로젝트는 영향 받지 않는다.
188
-
189
- Claude CLI 자체는 scope 와 무관하게 `~/.claude/plugins/cache/` 에 plugin 파일을 write 한다 — 단 `installed_plugins.json` 메타데이터가 `projectPath` 로 격리하므로 다른 프로젝트에서 안 보인다.
190
-
191
- ---
192
-
193
- ## Uninstall
194
-
195
- ```bash
196
- npx -y @uzysjung/agent-harness uninstall
197
- ```
198
-
199
- `.claude/.harness-install.json` (install 시 생성) 을 읽어 자동 reverse 한다.
200
-
201
- - Project-scope 자산: 자동 제거 (`claude plugin uninstall --scope project`, `npm uninstall --save-dev`, `.codex/` cleanup 등).
202
- - 프로젝트 루트 `CLAUDE.md`: install 시점과 내용이 동일할 때만 제거 (sha256). 설치 후 직접 수정했다면 안내와 함께 보존.
203
- - Global-scope 자산: 안내 메시지만 출력 — 사용자가 직접 제거. uninstall 은 명시적 동의 없이는 다른 프로젝트나 글로벌 설정을 절대 변경하지 않는다.
70
+ - **프론트엔드 + 백엔드** — `csr-supabase` · `csr-fastify` · `csr-fastapi` · `ssr-nextjs` · `ssr-htmx`
71
+ - **데이터** — `data`
72
+ - **비즈니스** `executive` · `project-management` · `growth-marketing`
73
+ - **메타** — `tooling` (앱 스택 없는 Bash·Markdown 프로젝트)
74
+ - **전체** `full`
204
75
 
205
- | Flag | What |
206
- |---|---|
207
- | `--dry-run` | reverse list 만 출력, 변경 없음 |
208
- | `--keep-templates` | external 자산만 제거, `.claude/`, `.codex/`, `.opencode/` 보존 |
76
+ ### [각 track 무엇을 설치하는지 보기 →](docs/TRACKS.md)
209
77
 
210
- ---
78
+ ## 문서
211
79
 
212
- ## 동작 방식
80
+ ### [사용 가이드 →](docs/USAGE.md)
213
81
 
214
- ```
215
- ┌──────────────────────────────────────────────────────────┐
216
- │ npx -y @uzysjung/agent-harness │
217
- │ │ │
218
- │ ▼ │
219
- │ ┌─ 6-step wizard ──────────────────────────────────┐ │
220
- │ │ Track(s) → CLI(s) → Items → Scope → Confirm │ │
221
- │ └──────────────────┬───────────────────────────────┘ │
222
- │ ▼ │
223
- │ ┌─ Phase 1: Templates ─────────────────────────────┐ │
224
- │ │ .claude/{rules,agents,hooks,commands,skills} │ │
225
- │ │ CLAUDE.md (scaffold) · .mcp.json │ │
226
- │ └──────────────────┬───────────────────────────────┘ │
227
- │ ▼ │
228
- │ ┌─ Phase 2: External assets ───────────────────────┐ │
229
- │ │ claude plugin / npx skills / npm / shell-script │ │
230
- │ │ Step 4 에서 선택한 scope 따름 │ │
231
- │ └──────────────────┬───────────────────────────────┘ │
232
- │ ▼ │
233
- │ ┌─ Phase 3: install log ───────────────────────────┐ │
234
- │ │ .claude/.harness-install.json │ │
235
- │ │ (uninstall 의 source) │ │
236
- │ └──────────────────────────────────────────────────┘ │
237
- └──────────────────────────────────────────────────────────┘
238
- ```
82
+ 워크플로 상세, 설치 내부 동작, uninstall, scope, CI flag, CLI 별 설정.
239
83
 
240
- ---
84
+ ### [호환성 매트릭스 →](docs/COMPATIBILITY.md)
241
85
 
242
- ## CLI 지원
86
+ 자산별 설치 방식과 검증 상태.
243
87
 
244
- | CLI | 지원 |
245
- |---|---|
246
- | Claude Code | First class — 모든 자산 + hook |
247
- | Codex (OpenAI) | Skills + `AGENTS.md` (스택별 rules) |
248
- | OpenCode | Skills + AGENTS.md 통합 |
249
- | Antigravity (Google) | Project: `.agents/rules/` (context, 항상) + `.agents/skills/` (dev-method skills) |
88
+ ### [트랙 목록 →](docs/TRACKS.md)
250
89
 
251
- Step 2 에서 1개 또는 multi 선택.
90
+ track 미리 체크하는 자산 전체.
252
91
 
253
- ---
254
-
255
- ## 심화
92
+ ### [보안 안내 →](SECURITY.md)
256
93
 
257
- - [docs/USAGE.md](./docs/USAGE.md) 워크플로우 상세, install 내부, CI flag, ECC 통합, Codex/OpenCode 설정
258
- - [docs/WORKFLOWS.md](./docs/WORKFLOWS.md) — 설치 가능 워크플로 7종 비교 가이드
259
- - [docs/NORTH_STAR.md](./docs/NORTH_STAR.md) — 디자인 원칙
260
- - [docs/decisions/](./docs/decisions/) — ADR (아키텍처 결정)
261
- - [docs/REFERENCE.md](./docs/REFERENCE.md) — 트랙별 자산 매트릭스 상세
94
+ 검증이 보장하는 것과 보장하지 않는 것, 그리고 제보 방법.
262
95
 
263
- ---
96
+ 설치 가능한 워크플로 비교는 [docs/WORKFLOWS.md](docs/WORKFLOWS.md), 설계 원칙은 [docs/NORTH_STAR.md](docs/NORTH_STAR.md), 아키텍처 결정은 [docs/decisions/](docs/decisions/) 에 있다.
264
97
 
265
98
  ## License
266
99