-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathindex.html
More file actions
1182 lines (1087 loc) · 53.2 KB
/
Copy pathindex.html
File metadata and controls
1182 lines (1087 loc) · 53.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>ttutak — 상세 문서</title>
<style>
:root {
--bg: #0d1117;
--surface: #161b22;
--surface-hover: #1c2129;
--border: #30363d;
--text: #e6edf3;
--text-secondary: #8b949e;
--accent: #58a6ff;
--accent-hover: #79c0ff;
--green: #3fb950;
--orange: #d29922;
--red: #f85149;
--purple: #bc8cff;
--pink: #f778ba;
}
* { margin: 0; padding: 0; box-sizing: border-box; }
html {
scroll-padding-top: 60px;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Noto Sans KR, Helvetica, Arial, sans-serif;
background: var(--bg);
color: var(--text);
line-height: 1.7;
}
/* Hero */
.hero {
text-align: center;
padding: 80px 20px 60px;
background: linear-gradient(135deg, #0d1117 0%, #161b22 50%, #1a1e2e 100%);
border-bottom: 1px solid var(--border);
}
.hero h1 {
font-size: 3rem;
font-weight: 800;
margin-bottom: 16px;
background: linear-gradient(135deg, var(--accent), var(--purple));
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
background-clip: text;
}
.hero p {
font-size: 1.2rem;
color: var(--text-secondary);
max-width: 640px;
margin: 0 auto 24px;
}
.hero-badges {
display: flex;
gap: 12px;
justify-content: center;
flex-wrap: wrap;
}
.hero-badges a {
display: inline-block;
padding: 8px 20px;
border-radius: 8px;
text-decoration: none;
font-size: 0.9rem;
font-weight: 600;
transition: all 0.2s;
}
.btn-primary {
background: var(--accent);
color: #fff;
}
.btn-primary:hover { background: var(--accent-hover); }
.btn-outline {
border: 1px solid var(--border);
color: var(--text-secondary);
}
.btn-outline:hover {
border-color: var(--accent);
color: var(--accent);
}
/* Nav */
.nav {
position: sticky;
top: 0;
z-index: 100;
background: rgba(13,17,23,0.95);
backdrop-filter: blur(12px);
border-bottom: none;
padding: 0 20px;
overflow-x: auto;
}
.nav-inner {
max-width: 1100px;
margin: 0 auto;
display: flex;
gap: 8px;
justify-content: center;
}
.nav a {
padding: 12px 16px;
color: var(--text-secondary);
text-decoration: none;
font-size: 0.85rem;
font-weight: 500;
white-space: nowrap;
transition: all 0.2s;
position: relative;
}
.nav a::after {
content: '';
position: absolute;
bottom: 0;
left: 16px;
right: 16px;
height: 2px;
background: var(--accent);
transform: scaleX(0);
transition: transform 0.2s;
}
.nav a:hover, .nav a.active {
color: var(--accent);
text-decoration: none;
}
.nav a:hover::after, .nav a.active::after {
transform: scaleX(1);
}
/* Content */
.content {
max-width: 1100px;
margin: 0 auto;
padding: 40px 20px 80px;
}
section {
margin-bottom: 64px;
}
h2 {
font-size: 1.8rem;
font-weight: 700;
margin-bottom: 24px;
padding-bottom: 12px;
border-bottom: 1px solid var(--border);
}
h3 {
font-size: 1.3rem;
font-weight: 600;
margin: 32px 0 16px;
color: var(--accent);
}
h4 {
font-size: 1.05rem;
font-weight: 600;
margin: 24px 0 12px;
color: var(--purple);
}
p { margin-bottom: 16px; }
a { color: var(--accent); text-decoration: none; }
a:hover { text-decoration: underline; }
/* Cards */
.card-grid {
display: grid;
grid-template-columns: repeat(2, 1fr);
gap: 16px;
margin: 20px 0;
}
.card {
background: var(--surface);
border: 1px solid var(--border);
border-radius: 12px;
padding: 24px;
transition: border-color 0.2s, box-shadow 0.2s;
}
.card:hover {
border-color: var(--accent);
box-shadow: 0 0 0 1px rgba(88,166,255,0.1);
}
.card-title {
font-size: 1.05rem;
font-weight: 600;
margin-bottom: 6px;
}
.card-desc {
color: var(--text-secondary);
font-size: 0.85rem;
line-height: 1.5;
}
/* Tags */
.tag {
display: inline-block;
padding: 2px 10px;
border-radius: 20px;
font-size: 0.75rem;
font-weight: 600;
margin-right: 4px;
}
.tag-opus { background: rgba(188,140,255,0.15); color: var(--purple); }
.tag-sonnet { background: rgba(88,166,255,0.15); color: var(--accent); }
.tag-p1 { background: rgba(248,81,73,0.15); color: var(--red); }
.tag-p2 { background: rgba(210,153,34,0.15); color: var(--orange); }
.tag-p3 { background: rgba(139,148,158,0.15); color: var(--text-secondary); }
/* Tables */
table {
width: 100%;
border-collapse: collapse;
margin: 16px 0;
font-size: 0.9rem;
}
th, td {
padding: 10px 14px;
text-align: left;
border-bottom: 1px solid var(--border);
}
th {
font-weight: 600;
color: var(--text-secondary);
font-size: 0.8rem;
text-transform: uppercase;
letter-spacing: 0.5px;
}
tr:hover td { background: var(--surface); }
/* Code */
code {
background: var(--surface);
padding: 2px 8px;
border-radius: 6px;
font-size: 0.85rem;
font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
}
pre {
background: var(--surface);
border: 1px solid var(--border);
border-radius: 12px;
padding: 20px;
overflow-x: auto;
margin: 16px 0;
font-size: 0.85rem;
line-height: 1.6;
}
pre code {
background: none;
padding: 0;
}
/* Pipeline */
.pipeline {
display: flex;
gap: 8px;
flex-wrap: wrap;
margin: 20px 0;
align-items: center;
}
.pipeline-step {
background: var(--surface);
border: 1px solid var(--border);
border-radius: 10px;
padding: 12px 20px;
text-align: center;
min-width: 120px;
}
.pipeline-step .step-name {
font-weight: 600;
font-size: 0.9rem;
margin-bottom: 4px;
}
.pipeline-step .step-agent {
color: var(--text-secondary);
font-size: 0.75rem;
}
.pipeline-arrow {
color: var(--text-secondary);
font-size: 1.2rem;
}
/* Diff */
.diff {
border-radius: 12px;
overflow: hidden;
border: 1px solid var(--border);
margin: 16px 0;
}
.diff-header {
background: var(--surface);
padding: 10px 16px;
font-weight: 600;
font-size: 0.85rem;
border-bottom: 1px solid var(--border);
}
.diff-del {
background: rgba(248,81,73,0.1);
padding: 12px 16px;
border-left: 3px solid var(--red);
font-size: 0.9rem;
}
.diff-add {
background: rgba(63,185,80,0.1);
padding: 12px 16px;
border-left: 3px solid var(--green);
font-size: 0.9rem;
}
/* Blockquote */
blockquote {
border-left: 3px solid var(--border);
padding: 12px 20px;
margin: 16px 0;
color: var(--text-secondary);
background: var(--surface);
border-radius: 0 8px 8px 0;
}
/* Flowchart-like */
.flow {
background: var(--surface);
border: 1px solid var(--border);
border-radius: 12px;
padding: 20px 20px 20px 24px;
margin: 16px 0;
font-size: 0.88rem;
line-height: 1.6;
list-style: none;
counter-reset: flow-step;
}
.flow > li {
position: relative;
padding: 8px 0 8px 28px;
border-left: 2px solid var(--border);
margin-left: 8px;
}
.flow > li:first-child {
border-left-color: transparent;
}
.flow > li:first-child::after {
content: '';
position: absolute;
left: -2px;
top: 28px;
bottom: 0;
width: 2px;
background: var(--border);
}
.flow > li:last-child {
border-left-color: transparent;
}
.flow > li::before {
counter-increment: flow-step;
content: counter(flow-step);
position: absolute;
left: -11px;
top: 8px;
width: 20px;
height: 20px;
background: var(--accent);
color: #fff;
border-radius: 50%;
font-size: 0.7rem;
font-weight: 700;
display: flex;
align-items: center;
justify-content: center;
}
.flow > li > .flow-title {
font-weight: 600;
color: var(--text);
}
.flow .flow-sub {
list-style: none;
padding-left: 16px;
margin-top: 4px;
}
.flow .flow-sub li {
color: var(--text-secondary);
font-size: 0.83rem;
padding: 2px 0;
}
.flow .flow-sub li::before {
content: "├── ";
font-family: monospace;
color: var(--border);
}
.flow .flow-sub li:last-child::before {
content: "└── ";
}
/* Responsive */
@media (max-width: 768px) {
.hero h1 { font-size: 2rem; }
.hero p { font-size: 1rem; }
.card-grid { grid-template-columns: 1fr; }
.pipeline { flex-direction: column; align-items: stretch; }
.pipeline-arrow { transform: rotate(90deg); text-align: center; }
}
/* Footer */
footer {
text-align: center;
padding: 40px 20px;
border-top: 1px solid var(--border);
color: var(--text-secondary);
font-size: 0.85rem;
}
</style>
</head>
<body>
<!-- Hero -->
<div class="hero">
<h1>ttutak 뚝딱</h1>
<p>"개발해줘" 한마디면 PRD, 설계, 구현, 리뷰, 테스트, PR까지 뚝딱. 말하면 만들어주는 Claude Code 개발 자동화 플러그인</p>
<div class="hero-badges">
<a href="https://github.com/rnqhstmd/ttutak" class="btn-primary">GitHub</a>
<a href="https://github.com/rnqhstmd/ttutak/releases/latest" class="btn-outline">릴리스 노트</a>
</div>
</div>
<!-- Nav -->
<nav class="nav">
<div class="nav-inner">
<a href="#overview">개요</a>
<a href="#skills">스킬</a>
<a href="#setup">setup</a>
<a href="#context-skill">context</a>
<a href="#dev-pipeline">dev</a>
<a href="#lens-skill">lens</a>
<a href="#research-skill">research</a>
<a href="#humanizer-skill">humanizer</a>
<a href="#test-skill">test</a>
<a href="#commit-pr">commit / PR</a>
</div>
</nav>
<!-- Content -->
<div class="content">
<!-- Overview -->
<section id="overview">
<h2>개요</h2>
<p>ttutak은 Claude Code 위에서 동작하는 개발 자동화 플러그인입니다. 9개 스킬, 9개 에이전트가 협업하여 자연어 요청 하나로 전체 개발 사이클을 수행합니다.</p>
<div class="card-grid">
<div class="card">
<div class="card-title">자연어 의도 파싱</div>
<div class="card-desc">명령어 없이 자연어로 의도를 전달하면 적절한 스킬과 모드가 자동 발동됩니다.</div>
</div>
<div class="card">
<div class="card-title">에이전트 팀 협업</div>
<div class="card-desc">PO, 설계자, 개발자, QA, 보안 감사자 등 9개 에이전트가 역할별로 협업합니다.</div>
</div>
<div class="card">
<div class="card-title">단계별 승인</div>
<div class="card-desc">PRD, 설계, 구현 계획 — 각 단계에서 사용자 승인 없이 다음으로 넘어가지 않습니다.</div>
</div>
<div class="card">
<div class="card-title">안전장치 내장</div>
<div class="card-desc">PR 머지 차단, force push 차단, 민감 파일 감지 등 다중 안전장치가 내장되어 있습니다.</div>
</div>
</div>
<h3>안전장치</h3>
<table>
<thead><tr><th>항목</th><th>설명</th></tr></thead>
<tbody>
<tr><td><strong>PR 머지 차단</strong></td><td><code>gh pr merge</code> 실행을 설정 수준에서 차단. 머지는 사람이 직접 수행</td></tr>
<tr><td><strong>Force Push 차단</strong></td><td><code>git push --force</code> 차단</td></tr>
<tr><td><strong>보호 브랜치</strong></td><td>main에서 직접 커밋 차단. 작업 브랜치를 먼저 생성</td></tr>
<tr><td><strong>민감 파일 감지</strong></td><td><code>.env</code>, <code>*.key</code>, <code>*.pem</code>, <code>credentials*</code>, <code>*secret*</code> 커밋 전 경고</td></tr>
<tr><td><strong>빌드 아티팩트</strong></td><td><code>build/</code>, <code>node_modules/</code> 등 tracked 시 <code>.gitignore</code> 보강 제안</td></tr>
<tr><td><strong>단계별 승인</strong></td><td>PRD, 설계, 구현 계획 — 사용자 승인 없이 진행하지 않음</td></tr>
<tr><td><strong>Mechanical Gate</strong></td><td>빌드/테스트 통과 후에만 QA 리뷰 진행</td></tr>
</tbody>
</table>
</section>
<!-- Skills -->
<section id="skills">
<h2>9개 스킬</h2>
<table>
<thead>
<tr>
<th>스킬</th>
<th>핵심 역할</th>
<th>에이전트</th>
<th>모드</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="#setup"><strong>setup</strong></a></td>
<td>GH 인증, 웹훅 설정</td>
<td>오케스트레이터 직접</td>
<td>—</td>
</tr>
<tr>
<td><a href="#context-skill"><strong>context</strong></a></td>
<td>도메인 지식 등록/갱신</td>
<td>오케스트레이터 직접</td>
<td>스캔, 신규, 문서기반, 갱신, 동기화</td>
</tr>
<tr>
<td><a href="#dev-pipeline"><strong>dev</strong></a></td>
<td>PRD → 설계 → 구현 → 리뷰 → PR</td>
<td>9개 에이전트 팀</td>
<td>normal, hotfix, 단일단계, 재개</td>
</tr>
<tr>
<td><a href="#lens-skill"><strong>lens</strong></a></td>
<td>코드에서 비즈니스 정책 추출</td>
<td>Explore + architect + security-auditor</td>
<td>요약, 상세, 영향도분석</td>
</tr>
<tr>
<td><a href="#research-skill"><strong>research</strong></a></td>
<td>웹 검색/문서 분석 기반 리서치</td>
<td>오케스트레이터 직접</td>
<td>종합리포트, 비교표, 핵심요약</td>
</tr>
<tr>
<td><a href="#humanizer-skill"><strong>humanizer</strong></a></td>
<td>AI 글쓰기 패턴 감지/교정</td>
<td>오케스트레이터 직접</td>
<td>audit, rewrite</td>
</tr>
<tr>
<td><a href="#test-skill"><strong>test</strong></a></td>
<td>도메인별 단위/통합/E2E 테스트 자동 작성</td>
<td>coder</td>
<td>--type, --coverage</td>
</tr>
<tr>
<td><a href="#commit-pr"><strong>commit</strong></a></td>
<td>브랜치 타입 파싱 + 한국어 커밋</td>
<td>오케스트레이터 직접</td>
<td>—</td>
</tr>
<tr>
<td><a href="#commit-pr"><strong>pull-request</strong></a></td>
<td>커밋 히스토리 분석 + PR 생성</td>
<td>오케스트레이터 직접</td>
<td>—</td>
</tr>
</tbody>
</table>
</section>
<!-- Setup -->
<section id="setup">
<h2>setup — 초기 설정</h2>
<p>플러그인 설치 후 최초 1회 실행합니다. 필수 도구(gh CLI)와 GitHub 인증을 확인하고, Slack 웹훅을 연동합니다.</p>
<pre><code>/ttutak:setup</code></pre>
<h3>설정 항목</h3>
<table>
<thead><tr><th>항목</th><th>설명</th><th>필수</th></tr></thead>
<tbody>
<tr><td><strong>gh CLI</strong></td><td>GitHub CLI 설치 및 인증 확인</td><td>필수</td></tr>
<tr><td><strong>GitHub 인증</strong></td><td><code>gh auth login</code> 인증 상태 확인</td><td>필수</td></tr>
<tr><td><strong>Slack 웹훅</strong></td><td>PR 생성 시 팀 알림 전송</td><td>선택</td></tr>
</tbody>
</table>
</section>
<!-- Context -->
<section id="context-skill">
<h2>context — 도메인 지식 관리</h2>
<p>기획서, 요구사항 문서, 코드베이스를 분석하여 도메인 지식을 등록합니다.</p>
<h3>5가지 모드 자동 판단</h3>
<table>
<thead><tr><th>조건</th><th>모드</th><th>동작</th></tr></thead>
<tbody>
<tr><td><code>context/</code> 없음</td><td><strong>스캔</strong></td><td>패키지 구조, 엔티티, API 분석 → 도메인 자동 생성</td></tr>
<tr><td>도메인명 지정</td><td><strong>신규</strong></td><td>Q&A 5개 질문으로 도메인 생성</td></tr>
<tr><td><code>--from <파일></code></td><td><strong>문서 기반</strong></td><td>PDF/이미지/텍스트 분석 → context 생성</td></tr>
<tr><td>기존 도메인</td><td><strong>갱신</strong></td><td>변경 제안 → 사용자 확인 후 반영</td></tr>
<tr><td><code>--sync</code></td><td><strong>동기화</strong></td><td>git log + PR 분석 → status.md 갱신</td></tr>
</tbody>
</table>
<h3>생성되는 문서 구조</h3>
<pre><code>context/{도메인}/
├── README.md ← 도메인 개요 (배경, 문제, 사용자, 성공기준, 담당자)
├── PROJECTS.md ← 관련 GHE 레포 매핑
├── glossary.md ← 도메인 용어 사전
├── architecture.md ← 전체 구조 요약 + 주제 문서 링크
├── status.md ← 구현 추적 (AC별 ✅/⬜)
└── {주제}/README.md ← 주제별 상세 정책/설계</code></pre>
<h3>답변 품질 게이트</h3>
<p>context는 모호한 답변을 허용하지 않습니다. "많다", "자주" 대신 정량 수치를 요구하고, "효율화", "개선" 같은 추상어가 나오면 구체화를 요청합니다. 그래도 모르는 항목은 ❓로 남기고 진행합니다.</p>
</section>
<!-- Dev Pipeline -->
<section id="dev-pipeline">
<h2>dev — 전체 개발 파이프라인</h2>
<p>자연어 요청 하나로 PRD 작성부터 PR 생성까지 전체 사이클을 수행합니다. 자연어를 분석하여 모드를 자동 결정합니다.</p>
<h3>자연어 의도 파싱</h3>
<table>
<thead><tr><th>감지 패턴</th><th>모드</th><th>예시</th></tr></thead>
<tbody>
<tr><td><code>상태</code>, <code>진행</code>, <code>어디까지</code></td><td>STATUS</td><td>"지금 어디까지 됐어?"</td></tr>
<tr><td><code>이어서</code>, <code>계속</code>, <code>재개</code></td><td>RESUME</td><td>"아까 하던 작업 이어서 해줘"</td></tr>
<tr><td><code>긴급</code>, <code>핫픽스</code>, <code>급한</code></td><td>HOTFIX</td><td>"로그인 버그 긴급 수정해줘"</td></tr>
<tr><td><code>설계만</code>, <code>PRD만</code>, <code>구현만</code></td><td>단일 Phase</td><td>"설계만 해줘"</td></tr>
<tr><td>위 어디에도 해당 안 됨</td><td>NORMAL</td><td>"로그인 기능 추가해줘"</td></tr>
</tbody>
</table>
<h3>7단계 파이프라인</h3>
<h4>정상 경로 (Normal)</h4>
<div class="pipeline">
<div class="pipeline-step"><div class="step-name">Setup</div><div class="step-agent">환경 준비</div></div>
<div class="pipeline-arrow">→</div>
<div class="pipeline-step"><div class="step-name">Requirements</div><div class="step-agent">PRD Q&A</div></div>
<div class="pipeline-arrow">→</div>
<div class="pipeline-step"><div class="step-name">Design</div><div class="step-agent">기술 설계</div></div>
<div class="pipeline-arrow">→</div>
<div class="pipeline-step"><div class="step-name">Implement</div><div class="step-agent">구현 + 자기점검</div></div>
<div class="pipeline-arrow">→</div>
<div class="pipeline-step"><div class="step-name">Review</div><div class="step-agent">QA + 보안 감사</div></div>
<div class="pipeline-arrow">→</div>
<div class="pipeline-step"><div class="step-name">Test</div><div class="step-agent">테스트 작성</div></div>
<div class="pipeline-arrow">→</div>
<div class="pipeline-step"><div class="step-name">Complete</div><div class="step-agent">커밋 / PR</div></div>
</div>
<h4>긴급 경로 (Hotfix)</h4>
<div class="pipeline">
<div class="pipeline-step"><div class="step-name">Setup</div><div class="step-agent">환경 준비</div></div>
<div class="pipeline-arrow">→</div>
<div class="pipeline-step"><div class="step-name">Requirements</div><div class="step-agent">경량 PRD</div></div>
<div class="pipeline-arrow">→</div>
<div class="pipeline-step"><div class="step-name">Implement</div><div class="step-agent">구현 + 자기점검</div></div>
<div class="pipeline-arrow">→</div>
<div class="pipeline-step"><div class="step-name">Complete</div><div class="step-agent">커밋 / PR</div></div>
</div>
<h3>각 Phase 상세</h3>
<h4>Phase 1: Setup</h4>
<ol class="flow">
<li><span class="flow-title">진행 중 작업 감지 (.dev/state.md)</span> — 이전 작업 있으면 재개 여부 확인</li>
<li><span class="flow-title">Git 저장소 확인</span></li>
<li><span class="flow-title">베이스 브랜치 결정 + 동기화 (git pull)</span></li>
<li><span class="flow-title">프로젝트 정보 수집 (5개 작업 병렬)</span>
<ul class="flow-sub">
<li>프로젝트 타입 감지 (build.gradle.kts → java-spring 등)</li>
<li>디렉토리 구조 수집</li>
<li>CLAUDE.md 컨벤션 확보</li>
<li>도메인 컨텍스트 매칭 (context/*/PROJECTS.md)</li>
<li>외부 규격 참조 탐색 (references/ → REFERENCES 변수)</li>
</ul>
</li>
<li><span class="flow-title">관련 코드 맵 생성</span> — 키워드 추출 → Grep → 핵심 파일 15개 이내</li>
<li><span class="flow-title">작업 브랜치 생성 + .gitignore 보강 + 상태 초기화</span></li>
</ol>
<h4>Phase 2: Requirements — PRD Q&A</h4>
<ol class="flow">
<li><span class="flow-title">product-owner 에이전트 호출 (PRD 작성)</span></li>
<li><span class="flow-title">PRD 전문 표시 + 3관점 품질 자가 검증</span>
<ul class="flow-sub">
<li>유저 경험 검증: 사용자가 자연스럽게 이해하고 행동할 수 있는가</li>
<li>해석 여지 제거: "크게", "적절히" 대신 구체적 수치가 있는가</li>
<li>엣지케이스 커버리지: 빈 상태, 로딩, 에러, 최솟값/최댓값</li>
</ul>
</li>
<li><span class="flow-title">질문 → AskUserQuestion 변환 → 답변 반영</span> — 최대 1회</li>
<li><span class="flow-title">사용자 승인 (승인 / 수정 요청) → .dev/prd.md 저장</span></li>
</ol>
<h4>Phase 3: Design — 설계 Q&A</h4>
<ol class="flow">
<li><span class="flow-title">architect 에이전트 호출 (기술 설계)</span></li>
<li><span class="flow-title">설계 초안 전문 표시</span></li>
<li><span class="flow-title">설계 비판 검토 (중형/대형만)</span>
<ul class="flow-sub">
<li>design-critic이 암묵적 가정 도전, 과잉 설계 식별</li>
<li>MUST-ADDRESS → architect 설계 수정</li>
<li>CONSIDER → 참고 사항으로 기록</li>
</ul>
</li>
<li><span class="flow-title">사용자 승인 (최대 2회 반복) → .dev/design.md 저장</span></li>
</ol>
<h4>Phase 4: Implement — 구현 + 자기점검</h4>
<ol class="flow">
<li><span class="flow-title">구현 계획 제시 (변경 파일, 유형, 배치 테이블) → 사용자 승인</span></li>
<li><span class="flow-title">의존성 분석 → 배치 구성</span>
<ul class="flow-sub">
<li>파일 배타적 잠금: 같은 파일을 수정하는 단계는 같은 배치에 넣지 않음</li>
<li>import/참조 의존: 신규 타입을 참조하면 순차 배치</li>
<li>위상 정렬로 B1 → B2 → B3 배치 배정</li>
</ul>
</li>
<li><span class="flow-title">배치별 coder 디스패치 (병렬 실행)</span>
<ul class="flow-sub">
<li>단일 배치+단일 단계: 기존 전체 모드 coder 호출</li>
<li>배치 내 2개 이상: 동시 coder Task 발행 (각 coder는 담당 파일만 수정)</li>
<li>배치 간 통합 빌드 검증 → 실패 시 원인 coder 특정 후 수정 재호출</li>
</ul>
</li>
<li><span class="flow-title">자기점검 (qa-manager)</span>
<ul class="flow-sub">
<li>Critical → coder 자동 수정 (1회)</li>
<li>Warning/Info → phase-review로 이월</li>
<li>QUESTION → phase-review로 이월</li>
</ul>
</li>
</ol>
<h4>Phase 5: Review — QA + 보안 감사</h4>
<ol class="flow">
<li><span class="flow-title">Mechanical Gate</span>
<ul class="flow-sub">
<li>빌드 실패 → coder 자동 수정 → 1회 재시도</li>
<li>테스트 실패 → coder 자동 수정 → 1회 재시도</li>
</ul>
</li>
<li><span class="flow-title">qa-manager + security-auditor 병렬 호출</span>
<ul class="flow-sub">
<li>QA: 코드 리뷰 + 스펙 충족 검증</li>
<li>종합 검증: PRD + 설계서 + diff 교차 검증</li>
</ul>
</li>
<li><span class="flow-title">결과 합산 → Trust Ledger 생성 → Critical 자동 수정</span> — 최대 2회</li>
</ol>
<h4>Phase 6: Complete</h4>
<ol class="flow">
<li><span class="flow-title">인수 검증 (product-owner)</span> — PRD 수용 기준 대비 검증</li>
<li><span class="flow-title">/commit 스킬 실행</span> — 빌드 체크 + 한국어 커밋</li>
<li><span class="flow-title">/pull-request 스킬 실행</span> — PR 본문 + Trust Ledger 요약</li>
<li><span class="flow-title">도메인 status.md 갱신 + context 환류 제안</span></li>
</ol>
<h3>정체 감지 + 에스컬레이션</h3>
<p>구현/리뷰 단계에서 진전이 없으면 자동으로 전문 에이전트에게 에스컬레이션합니다.</p>
<table>
<thead><tr><th>감지 패턴</th><th>상황</th><th>1차 대응</th><th>2차 대응</th></tr></thead>
<tbody>
<tr><td><strong>SPINNING</strong></td><td>동일 에러 2회 연속</td><td>hacker에 제약 우회 분석</td><td>researcher에 근본 원인 분석</td></tr>
<tr><td><strong>OSCILLATION</strong></td><td>접근법 A→B→A 왕복</td><td>architect에 설계 재검토</td><td>사용자에게 두 접근법 제시</td></tr>
<tr><td><strong>NO_DRIFT</strong></td><td>코드 변경 없이 반복</td><td>hacker에 우회 경로 요청</td><td>researcher에 코드베이스 탐색</td></tr>
<tr><td><strong>DIMINISHING_RETURNS</strong></td><td>수정 줄고 결과 안 나옴</td><td>simplifier에 범위 축소</td><td>사용자에게 방향 전환 확인</td></tr>
</tbody>
</table>
<h3>상태 저장과 재개</h3>
<p><code>.dev/state.md</code>에 현재 진행 상태를 기록합니다. "이어서 해줘"라고 말하면 중단된 Phase의 중단된 Step부터 정확히 재개합니다. 배치 실행 중 중단되면 완료된 배치는 건너뛰고 다음 배치부터 재개합니다.</p>
<pre><code># .dev/state.md 예시
phase: implement
status: in_progress
branch: JIRA-123
base: main
current-step: "coder 구현 (B2)"
phases:
setup: completed
requirements: completed
design: completed
implement: in_progress
steps:
implement:
- 구현 계획 승인: completed
- 배치 구성: completed
- coder 구현 (B1, 2단계 병렬): completed
- 빌드 검증 (B1): completed
- coder 구현 (B2, 1단계): in_progress</code></pre>
<h3 id="agents">9개 에이전트 팀</h3>
<p>dev 스킬의 핵심은 역할이 분리된 에이전트 팀이 협업하는 구조입니다.</p>
<table>
<thead><tr><th>에이전트</th><th>관점</th><th>역할</th><th>모델</th><th>활동 Phase</th></tr></thead>
<tbody>
<tr><td><strong>product-owner</strong></td><td>"뭘 만들지"</td><td>PRD 작성, 인수 검증</td><td><span class="tag tag-sonnet">Sonnet</span></td><td>requirements, complete</td></tr>
<tr><td><strong>architect</strong></td><td>"어떻게 만들지"</td><td>기술 설계</td><td><span class="tag tag-opus">Opus</span></td><td>design</td></tr>
<tr><td><strong>design-critic</strong></td><td>"이 가정이 맞나"</td><td>암묵적 가정 도전</td><td><span class="tag tag-opus">Opus</span></td><td>design (중형 이상)</td></tr>
<tr><td><strong>coder</strong></td><td>"만든다"</td><td>코드 구현 + 수정</td><td><span class="tag tag-opus">Opus</span></td><td>implement, review</td></tr>
<tr><td><strong>qa-manager</strong></td><td>"스펙대로 됐나"</td><td>코드 리뷰, 스펙 검증</td><td><span class="tag tag-sonnet">Sonnet</span></td><td>implement, review</td></tr>
<tr><td><strong>security-auditor</strong></td><td>"뭘 놓쳤나"</td><td>정책/보안 교차 검증</td><td><span class="tag tag-sonnet">Sonnet</span></td><td>review</td></tr>
<tr><td><strong>researcher</strong></td><td>"이해한다"</td><td>코드베이스 조사</td><td><span class="tag tag-sonnet">Sonnet</span></td><td>(독립 호출)</td></tr>
<tr><td><strong>hacker</strong></td><td>"다른 길이 있다"</td><td>제약 우회, 정체 탈출</td><td><span class="tag tag-sonnet">Sonnet</span></td><td>(정체 감지 시)</td></tr>
<tr><td><strong>simplifier</strong></td><td>"더 작게 만들자"</td><td>복잡도 제거</td><td><span class="tag tag-sonnet">Sonnet</span></td><td>(정체 감지 시)</td></tr>
</tbody>
</table>
<h4>모델 라우팅 원칙</h4>
<p>모든 에이전트가 같은 모델을 쓰지 않습니다. 작업 특성에 따라 모델을 배정합니다.</p>
<div class="card-grid">
<div class="card">
<div class="card-title"><span class="tag tag-opus">Opus</span> 비용 높음, 추론 깊음</div>
<div class="card-desc">비판적 분석 (가정 도전, 설계 비판), 구조적 설계 (기술 설계, 아키텍처), 코드 구현 (복잡한 코드 생성)</div>
</div>
<div class="card">
<div class="card-title"><span class="tag tag-sonnet">Sonnet</span> 비용 효율</div>
<div class="card-desc">산출물 생성 (PRD, 리뷰), 정체 탈출 (빠른 판단), 단순 검증 (코드 리뷰, 스펙 체크)</div>
</div>
</div>
<h4>컨텍스트 슬라이싱</h4>
<p>에이전트에게 모든 정보를 전달하면 토큰 낭비입니다. 역할별로 필요한 섹션만 슬라이싱합니다.</p>
<table>
<thead><tr><th>에이전트</th><th>받는 정보</th><th>받지 않는 정보</th></tr></thead>
<tbody>
<tr><td>product-owner (PRD)</td><td>ARGS + 코드 맵 + 프로젝트 구조</td><td>설계서, diff</td></tr>
<tr><td>architect (설계)</td><td>PRD 전체 + 코드 맵 + 컨벤션</td><td>diff</td></tr>
<tr><td>coder (구현)</td><td>설계서 전체 + 코드 맵</td><td>PRD (설계서에 반영됨)</td></tr>
<tr><td>coder (배치 모드)</td><td>담당 단계 설계만 + 담당 파일 목록 + 코드 맵</td><td>설계서 전체, PRD</td></tr>
<tr><td>qa-manager (자기점검)</td><td>PRD 요구사항+수용기준만</td><td>설계서, 배경</td></tr>
<tr><td>security-auditor</td><td>PRD + 설계서 + diff + 코드 맵</td><td>(전체 접근)</td></tr>
</tbody>
</table>
<h3 id="references">references/ — 외부 규격 참조</h3>
<p>프로젝트가 준수해야 할 외부 규격/표준(시큐어코딩 가이드, API 설계 표준, eGovFrame 규칙 등)을 <code>references/</code> 디렉토리에 넣어두면 dev 파이프라인이 자동으로 참조합니다.</p>
<h4>사용법</h4>
<pre><code># 프로젝트 루트에 references/ 디렉토리 생성 후 규격 문서 배치
references/
├── 시큐어코딩-가이드.md
├── API-설계-표준.md
└── eGovFrame/
└── 규칙.md</code></pre>
<h4>파이프라인 연동</h4>
<table>
<thead><tr><th>Phase</th><th>에이전트</th><th>동작</th></tr></thead>
<tbody>
<tr><td><strong>Setup</strong></td><td>오케스트레이터</td><td>references/ 탐색 → 파일 목록 + 한줄 설명으로 REFERENCES 변수 생성</td></tr>
<tr><td><strong>Design</strong></td><td>architect</td><td>관련 규격을 Read하여 설계서에 "준수 규격" 섹션 추가</td></tr>
<tr><td><strong>Implement</strong></td><td>coder</td><td>규격을 준수하며 구현 (전체/배치/hotfix 모드)</td></tr>
<tr><td><strong>Review</strong></td><td>qa-manager</td><td>규격 위반을 CERTAIN으로 보고 → 자동 수정 대상</td></tr>
<tr><td><strong>Review</strong></td><td>security-auditor</td><td>보안 관련 규격 항목을 감사에 포함</td></tr>
</tbody>
</table>
<h4>핵심 설계</h4>
<div class="card-grid">
<div class="card">
<div class="card-title">경량 참조</div>
<div class="card-desc">프롬프트에는 파일 목록 + 한줄 설명만 포함합니다. 에이전트가 필요 시 Read로 원문을 직접 읽습니다.</div>
</div>
<div class="card">
<div class="card-title">없으면 투명</div>
<div class="card-desc">references/ 디렉토리가 없으면 REFERENCES 변수는 빈 상태. 에이전트 프롬프트에 포함되지 않아 토큰 소모가 없습니다.</div>
</div>
<div class="card">
<div class="card-title">사용자 관리</div>
<div class="card-desc">스킬이 references/를 생성하지 않습니다. 사용자가 직접 규격 문서를 관리합니다.</div>
</div>
</div>
<h4>권장 작성 팁</h4>
<p>기존 문서를 그대로 넣어도 동작합니다. 아래 팁을 따르면 에이전트가 더 효과적으로 참조합니다.</p>
<table>
<thead><tr><th>팁</th><th>효과</th><th>예시</th></tr></thead>
<tbody>
<tr><td><strong>문서 상단에 요약/목차</strong></td><td>에이전트가 전체를 읽지 않고 필요한 부분만 탐색</td><td><code># 시큐어코딩 가이드</code> 아래 목차 나열</td></tr>
<tr><td><strong>항목별 번호/ID</strong></td><td>설계서에서 "§3.2 입력값 검증 반영" 식으로 정확히 참조</td><td><code>§3.2 입력값 검증</code>, <code>R-001</code></td></tr>
<tr><td><strong>체크리스트 형태</strong></td><td>QA가 항목별로 준수 여부를 검증</td><td><code>- [ ] SQL 파라미터 바인딩 필수</code></td></tr>
</tbody>
</table>
</section>
<!-- Lens -->
<section id="lens-skill">
<h2>lens — 비즈니스 정책 탐지</h2>
<p>코드에서 비즈니스 정책을 찾아 PO/PD가 읽을 수 있는 보고서로 출력합니다. <strong>읽기 전용</strong> — 코드를 수정하지 않습니다.</p>
<h3>페르소나: 기술 번역자</h3>
<blockquote>
코드를 읽되, 출력은 비즈니스 언어로 번역합니다.<br>
<code>PurchaseLimitPolicy</code> → "구매 한도 정책 (<code>PurchaseLimitPolicy</code>)"<br>
코드 변경을 제안하지 않습니다. 확인이 필요한 사항만 안내합니다.
</blockquote>
<h3>5단계 Phase</h3>
<ol class="flow">
<li><span class="flow-title">Prepare</span> — 쿼리 키워드 추출 → 프로젝트 확정</li>
<li><span class="flow-title">Explore: Agent(Explore)로 코드에서 정책 구현 발견</span>
<ul class="flow-sub">
<li>1단계: 후보 수집 (Glob + Grep, Read 없이)</li>
<li>2단계: 입구 추적 (Controller/Handler Read)</li>
<li>3단계: 핵심 파일 정독 (Service/Policy/Rule Read)</li>
</ul>
</li>
<li><span class="flow-title">Report</span> — "대상에게 무슨 일이 일어나는가" 관점으로 합성</li>
<li><span class="flow-title">(선택) Impact</span> — architect + security-auditor 병렬 분석</li>
<li><span class="flow-title">(선택) Impact-Report</span> — PO 친화적 영향도 보고서</li>
</ol>
</section>
<!-- Research -->
<section id="research-skill">
<h2>research — 도메인 리서치</h2>
<p>웹 검색과 문서 분석을 병행하여 출처가 명확한 조사 결과를 산출합니다. <code>/context --from</code>으로 결과를 context 문서에 반영할 수 있습니다.</p>
<h3>3가지 결과물 형태</h3>
<div class="card-grid">
<div class="card">
<div class="card-title">종합 리포트</div>
<div class="card-desc">요약 → 주요 발견 → 상세 분석 → 출처. 주제를 깊이 있게 조사할 때 사용합니다.</div>
</div>
<div class="card">
<div class="card-title">비교표</div>
<div class="card-desc">비교 기준 표 → 각 항목 요약 → 판단 근거. 기술/도구 선택지를 비교할 때 유용합니다.</div>
</div>
<div class="card">
<div class="card-title">핵심 요약</div>
<div class="card-desc">한 줄 결론 → 핵심 포인트 3-5개 → 출처. 빠르게 핵심만 파악할 때 사용합니다.</div>
</div>
</div>
<h3>4단계 워크플로우</h3>
<ol class="flow">
<li><span class="flow-title">인터뷰</span> — 주제, 결과물 형태, 조사 깊이를 확인 (인자로 지정 시 스킵)</li>
<li><span class="flow-title">검색 실행</span> — 키워드 도출 → WebSearch → URL 선별 → WebFetch로 내용 수집</li>
<li><span class="flow-title">검증 + 보강</span> — 목표 충족, 완성도, 정확성, 균형 4기준 자기검증. 부족 시 1회 보강</li>
<li><span class="flow-title">결과물 생성</span> — 선택한 형태로 <code>.research/</code>에 저장</li>
</ol>
<h3>조사 깊이</h3>
<table>
<thead><tr><th>모드</th><th>키워드</th><th>URL</th><th>특징</th></tr></thead>
<tbody>
<tr><td><strong>꼼꼼하게</strong></td><td>5개</td><td>최대 10개</td><td>다수 소스 교차 검증</td></tr>
<tr><td><strong>빠르게 핵심만</strong></td><td>3개</td><td>최대 5개</td><td>핵심 소스만 빠르게</td></tr>
</tbody>
</table>
<h3>context 연동</h3>
<pre><code>/research 결제 시스템 트렌드
→ .research/결제-시스템-트렌드-20260316.md 생성
/context 결제 --from .research/결제-시스템-트렌드-20260316.md
→ context/결제/ 문서에 리서치 결과 반영</code></pre>
<h3>수칙</h3>
<table>
<thead><tr><th>원칙</th><th>설명</th></tr></thead>
<tbody>
<tr><td><strong>출처 필수</strong></td><td>모든 발견에 URL 또는 문서 출처를 명시한다</td></tr>
<tr><td><strong>구체적 데이터</strong></td><td>"일반적으로", "대부분" 대신 구체적 수치를 찾는다</td></tr>
<tr><td><strong>교차 검증</strong></td><td>단일 출처의 주장은 다른 출처로 확인한다 (꼼꼼 모드)</td></tr>
<tr><td><strong>실패 투명성</strong></td><td>찾지 못한 정보는 ❓로 남기고 명시한다</td></tr>
</tbody>
</table>
</section>
<!-- Humanizer -->
<section id="humanizer-skill">
<h2>humanizer — AI 글쓰기 교정</h2>
<p>AI가 생성한 텍스트에서 40+가지 패턴을 감지하고 교정합니다. Wikipedia의 "Signs of AI writing" 가이드와 한국어 AI 글쓰기 패턴 연구를 기반으로 합니다.</p>
<h3>두 가지 모드</h3>
<div class="card-grid">
<div class="card">
<div class="card-title">audit 모드</div>
<div class="card-desc">패턴을 감지하고 리포트만 출력합니다. 텍스트를 수정하지 않습니다. 어디가 문제인지 확인만 하고 싶을 때 사용합니다.</div>
</div>
<div class="card">
<div class="card-title">rewrite 모드</div>
<div class="card-desc">패턴을 감지하고 직접 교정합니다. AI 흔적을 제거한 최종본이 필요할 때 사용합니다.</div>
</div>
</div>
<h3>심각도 분류</h3>
<table>
<thead><tr><th>심각도</th><th>설명</th><th>처리</th></tr></thead>
<tbody>
<tr><td><span class="tag tag-p1">P1</span></td><td>확실한 AI 흔적 — 사람이 거의 쓰지 않는 패턴</td><td>즉시 수정</td></tr>
<tr><td><span class="tag tag-p2">P2</span></td><td>의심스러운 패턴 — AI가 자주 쓰지만 사람도 가끔 사용</td><td>맥락 판단</td></tr>
<tr><td><span class="tag tag-p3">P3</span></td><td>스타일 개선 — 글 품질 향상 차원</td><td>선택적 수정</td></tr>
</tbody>
</table>
<h3>40+ 감지 패턴</h3>
<h4>한국어 <span class="tag tag-p1">P1</span> — 즉시 수정</h4>
<table>
<thead><tr><th>코드</th><th>패턴</th><th>감지 키워드</th></tr></thead>
<tbody>