Skip to content

idoforgod/AgenticWorkflow

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

88 Commits
.claude
.claude
Β 
Β 
.cursor/rules
.cursor/rules
Β 
Β 
.gemini
.gemini
Β 
Β 
.github
.github
Β 
Β 
coding-resource
coding-resource
Β 
Β 
docs
docs
Β 
Β 
prompt-runner
prompt-runner
Β 
Β 
prompt
prompt
Β 
Β 
translations
translations
Β 
Β 
.gitignore
.gitignore
Β 
Β 
AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md
AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md
Β 
Β 
AGENTICWORKFLOW-USER-MANUAL.md
AGENTICWORKFLOW-USER-MANUAL.md
Β 
Β 
AGENTS-ko-backup.md
AGENTS-ko-backup.md
Β 
Β 
AGENTS.md
AGENTS.md
Β 
Β 
CLAUDE.md
CLAUDE.md
Β 
Β 
COPYRIGHT.md
COPYRIGHT.md
Β 
Β 
DECISION-LOG-ko-backup.md
DECISION-LOG-ko-backup.md
Β 
Β 
DECISION-LOG.md
DECISION-LOG.md
Β 
Β 
GEMINI.md
GEMINI.md
Β 
Β 
README.md
README.md
Β 
Β 
soul-ko-backup.md
soul-ko-backup.md
Β 
Β 
soul.md
soul.md
Β 
Β 

Repository files navigation

AgenticWorkflow

μ–΄λ–€ μ—μ΄μ „νŠΈ μ›Œν¬ν”Œλ‘œμš°λ‘œλ“  λΆ„ν™”ν•  수 μžˆλŠ” 만λŠ₯쀄기세포(Pluripotent Stem Cell) ν”„λ ˆμž„μ›Œν¬.

λ³΅μž‘ν•œ μž‘μ—…μ„ μ›Œν¬ν”Œλ‘œμš°λ‘œ μ„€κ³„ν•˜κ³ , κ·Έ μ›Œν¬ν”Œλ‘œμš°λ₯Ό μ‹€μ œλ‘œ κ΅¬ν˜„ν•˜μ—¬ λ™μž‘μ‹œν‚€λŠ” 것이 λͺ©ν‘œμž…λ‹ˆλ‹€. 쀄기세포가 μ–΄λ–€ μ„Έν¬λ‘œλ“  λΆ„ν™”ν•˜λ“―, 이 ν”„λ ˆμž„μ›Œν¬λŠ” ν•˜λ‚˜μ˜ μ½”λ“œλ² μ΄μŠ€μ—μ„œ μ—°κ΅¬Β·λΆ„μ„Β·κ°œλ°œΒ·μžλ™ν™” λ“± μ–΄λ–€ λ„λ©”μΈμ˜ μ—μ΄μ „νŠΈ μ›Œν¬ν”Œλ‘œμš°λ“  μƒμ„±ν•˜κ³  μ‹€ν–‰ν•  수 μžˆμŠ΅λ‹ˆλ‹€.

그리고 μ€„κΈ°μ„Έν¬μ˜ λΆ„ν™”μ—μ„œ κ°€μž₯ μ€‘μš”ν•œ 사싀 β€” λΆ„ν™”λœ λͺ¨λ“  μ„Έν¬λŠ” λΆ€λͺ¨μ˜ 전체 κ²Œλ†ˆμ„ κ·ΈλŒ€λ‘œ κ°–κ³  μžˆμŠ΅λ‹ˆλ‹€. 이 μ½”λ“œλ² μ΄μŠ€μ—μ„œ νƒœμ–΄λ‚˜λŠ” λͺ¨λ“  μžμ‹ μ‹œμŠ€ν…œμ€, λͺ©μ μ€ λ‹€λ₯΄μ§€λ§Œ, λΆ€λͺ¨μ˜ 전체 DNA(μ ˆλŒ€ κΈ°μ€€, ν’ˆμ§ˆ 보μž₯, μ•ˆμ „μž₯치, κΈ°μ–΅ 체계 λ“±)λ₯Ό ꡬ쑰적으둜 λ‚΄μž₯ν•©λ‹ˆλ‹€. 상세: soul.md

ν”„λ‘œμ νŠΈ λͺ©ν‘œ

Phase 1: μ›Œν¬ν”Œλ‘œμš° 섀계  β†’  workflow.md (섀계도)
Phase 2: μ›Œν¬ν”Œλ‘œμš° κ΅¬ν˜„  β†’  μ‹€μ œ λ™μž‘ν•˜λŠ” μ‹œμŠ€ν…œ (μ΅œμ’… μ‚°μΆœλ¬Ό)

μ›Œν¬ν”Œλ‘œμš°λ₯Ό λ§Œλ“œλŠ” 것은 쀑간 μ‚°μΆœλ¬Όμž…λ‹ˆλ‹€. μ›Œν¬ν”Œλ‘œμš°μ— 기술된 λ‚΄μš©μ΄ μ‹€μ œλ‘œ λ™μž‘ν•˜λŠ” 것이 μ΅œμ’… λͺ©ν‘œμž…λ‹ˆλ‹€.

μ›Œν¬ν”Œλ‘œμš° ꡬ쑰

λͺ¨λ“  μ›Œν¬ν”Œλ‘œμš°λŠ” 3λ‹¨κ³„λ‘œ κ΅¬μ„±λ©λ‹ˆλ‹€:

  1. Research β€” 정보 μˆ˜μ§‘ 및 뢄석
  2. Planning β€” κ³„νš 수립, ꡬ쑰화, μ‚¬λžŒμ˜ κ²€ν† /승인
  3. Implementation β€” μ‹€μ œ μ‹€ν–‰ 및 μ‚°μΆœλ¬Ό 생성

ν”„λ‘œμ νŠΈ ꡬ쑰

AgenticWorkflow/
β”œβ”€β”€ CLAUDE.md              # Claude Code μ „μš© μ§€μ‹œμ„œ (κ²½λŸ‰ TOC)
β”œβ”€β”€ AGENTS.md              # λͺ¨λ“  AI μ—μ΄μ „νŠΈ 곡톡 μ§€μ‹œμ„œ (Hub β€” 방법둠 SOT)
β”œβ”€β”€ GEMINI.md              # Gemini CLI μ „μš© (Spoke)
β”œβ”€β”€ AGENTICWORKFLOW-USER-MANUAL.md                    # μ‚¬μš©μž 맀뉴얼
β”œβ”€β”€ AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md    # 섀계 μ² ν•™ 및 μ•„ν‚€ν…μ²˜ 전체 쑰감도
β”œβ”€β”€ DECISION-LOG.md           # ν”„λ‘œμ νŠΈ 섀계 κ²°μ • 둜그 (ADR, 51개+)
β”œβ”€β”€ COPYRIGHT.md              # μ €μž‘κΆŒ
β”œβ”€β”€ soul.md                   # ν”„λ‘œμ νŠΈ 영혼 (μžμ‹ μ‹œμŠ€ν…œμ— μœ μ „λ˜λŠ” DNA μ •μ˜)
β”œβ”€β”€ docs/protocols/           # 상세 ν”„λ‘œν† μ½œ (on-demand μ°Έμ‘°)
β”‚   β”œβ”€β”€ autopilot-execution.md       # μ›Œν¬ν”Œλ‘œμš° μ‹€ν–‰ 체크리슀트 + NEVER DO
β”‚   β”œβ”€β”€ quality-gates.md             # L0-L2 4계측 + P1 검증 14ν•­λͺ© 상세
β”‚   β”œβ”€β”€ ulw-mode.md                  # ULW κ°•ν™” κ·œμΉ™ 3개 + λŸ°νƒ€μž„ λ©”μ»€λ‹ˆμ¦˜
β”‚   β”œβ”€β”€ context-preservation-detail.md  # Hook λ‚΄λΆ€ λ©”μ»€λ‹ˆμ¦˜ + D-7 μΈμŠ€ν„΄μŠ€
β”‚   └── code-change-protocol.md      # CCP 3단계 + CAP + λΉ„λ‘€μ„± κ·œμΉ™
β”œβ”€β”€ .claude/
β”‚   β”œβ”€β”€ settings.json      # Hook μ„€μ •
β”‚   β”œβ”€β”€ agents/            # μ„œλΈŒμ—μ΄μ „νŠΈ (reviewer, fact-checker, translator)
β”‚   β”œβ”€β”€ commands/          # Slash Commands (6개: /install, /maintenance, /run-prompts, /resume-prompts, /setup-prompts, /verify-prompts)
β”‚   β”œβ”€β”€ hooks/scripts/     # 22개 Hook 슀크립트 + Setup 2개 + ν…ŒμŠ€νŠΈ 3개 (CP 5 + Safety 5 + Validation 9 + Obs/Diag 2 + 곡유 라이브러리 1 + Setup 2 + Test 3)
β”‚   β”œβ”€β”€ context-snapshots/ # λŸ°νƒ€μž„ μŠ€λƒ…μƒ· (gitignored)
β”‚   └── skills/
β”‚       β”œβ”€β”€ workflow-generator/ # μ›Œν¬ν”Œλ‘œμš° 섀계·생성 μŠ€ν‚¬
β”‚       └── doctoral-writing/   # 박사급 ν•™μˆ  κΈ€μ“°κΈ° μŠ€ν‚¬
β”œβ”€β”€ prompt-runner/            # ν”„λ‘¬ν”„νŠΈ λŸ¬λ„ˆ β€” 110개 ν”„λ‘¬ν”„νŠΈ μžλ™ 순차 μ‹€ν–‰ 도ꡬ
β”‚   β”œβ”€β”€ run.py                # μ„Έμ…˜ ID 캑처·재개, 3계측 검증, stagnation 감지
β”‚   β”œβ”€β”€ manifest.json         # 110개 ν”„λ‘¬ν”„νŠΈ 메타데이터 (ν•΄μ‹œ, 크기, /clear ν”Œλž˜κ·Έ)
β”‚   β”œβ”€β”€ prompt-refining-strategy.md  # ν”„λ‘¬ν”„νŠΈ μž¬μ„€κ³„ ν”„λ ˆμž„μ›Œν¬
β”‚   └── prompts/              # 001.txt ~ 110.txt (35개 μ„Έμ…˜, /clear 블둝 포함)
β”œβ”€β”€ prompt/                   # PRD 심측쑰사 ν”„λ ˆμž„μ›Œν¬ + μ—μ΄μ „νŠΈ ν”„λ‘¬ν”„νŠΈ 자료
β”‚   β”œβ”€β”€ prd_teammate_executable.md
β”‚   β”œβ”€β”€ Coding_Implementation_DeepDive_PRD_Teammate_Executable.md
β”‚   β”œβ”€β”€ Technology_Development_DeepDive_PRD_Teammate_Executable.md
β”‚   β”œβ”€β”€ External_Integration_DeepDive_PRD_Teammate_Executable.md
β”‚   └── (crystalize-prompt.md, distill-partner.md λ“±)
β”œβ”€β”€ translations/glossary.yaml  # λ²ˆμ—­ μš©μ–΄ 사전 (@translator SOT)
└── coding-resource/            # 이둠적 기반 자료
    └── recursive language models.pdf  # MIT CSAIL RLM λ…Όλ¬Έ

μŠ€ν‚¬

μŠ€ν‚¬ μ„€λͺ…
workflow-generator Research β†’ Planning β†’ Implementation 3단계 ꡬ쑰의 workflow.mdλ₯Ό 섀계·생성. Sub-agents, Agent Teams, Hooks, Skillsλ₯Ό μ‘°ν•©ν•œ κ΅¬ν˜„ 섀계 포함.
doctoral-writing 박사급 ν•™μœ„ λ…Όλ¬Έμ˜ 학문적 μ—„λ°€μ„±κ³Ό λͺ…λ£Œμ„±μ„ κ°–μΆ˜ κΈ€μ“°κΈ° 지원. ν•œκ΅­μ–΄Β·μ˜μ–΄ λͺ¨λ‘ 지원.

μ‚¬μš©μž μ„œλΈŒμ—μ΄μ „νŠΈ (Sub-agents)

.claude/agents/에 μ •μ˜λœ μ „λ¬Έ μ—μ΄μ „νŠΈ. μ›Œν¬ν”Œλ‘œμš°μ˜ Review: λ˜λŠ” Translation: ν•„λ“œλ‘œ 호좜되며, 각자 λΆ€λͺ¨ DNA(μ ˆλŒ€ κΈ°μ€€, ν’ˆμ§ˆ 게이트, SOT, pACS μžκΈ°μ±„μ )λ₯Ό λ‚΄μž₯ν•©λ‹ˆλ‹€.

μ„œλΈŒμ—μ΄μ „νŠΈ μ—­ν•  μ£Ό 호좜 지점
@reviewer μ λŒ€μ  리뷰어 β€” Enhanced L2 ν’ˆμ§ˆ 계측. μ‚°μΆœλ¬Όμ„ 곡격적으둜 λΉ„νŒν•˜μ—¬ 약점·논리적 비약·미검증 μ£Όμž₯을 발꡴. 독립적 pACS(F/C/L) μž¬μ±„μ  Review: ν•„λ“œκ°€ μ§€μ •λœ 단계
@fact-checker 사싀 검증 μ „λ¬Έκ°€ β€” claim-by-claim 뢄석. μ™ΈλΆ€ 좜처 검증(WebSearch/WebFetch) + 인용 μ •ν™•μ„± + μˆ˜μΉ˜Β·λ‚ μ§œΒ·κ³ μœ λͺ…사 크둜슀체크 Review: ν•„λ“œμ— + @fact-checker μΆ”κ°€ μ‹œ
@translator μ˜β†’ν•œ λ²ˆμ—­ μ „λ¬Έκ°€ β€” translations/glossary.yaml μš©μ–΄ 사전 기반 일관성. 7단계 ν”„λ‘œν† μ½œ(pre-mortem β†’ λ²ˆμ—­ β†’ μžκΈ°κ²€ν†  β†’ pACS) + 4계측 μ™„κ²°μ„± 검증. ADR-051둜 memory: project 채택 Translation: @translator ν•„λ“œκ°€ μ§€μ •λœ 단계

μŠ¬λž˜μ‹œ λͺ…λ Ήμ–΄ (Slash Commands)

.claude/commands/에 μ •μ˜λœ 6개 λͺ…λ Ήμ–΄. μ„Έμ…˜ λ‚΄μ—μ„œ /λͺ…λ Ήμ–΄λ‘œ ν˜ΈμΆœν•©λ‹ˆλ‹€.

λͺ…λ Ήμ–΄ μ—­ν• 
/install Setup Init 검증 β€” Python, PyYAML, 슀크립트 ꡬ문, 디렉터리, SOT μ“°κΈ° νŒ¨ν„΄ 무결성 확인
/maintenance 주기적 건강 검진 β€” stale archives, knowledge-index, work_log 크기, doc-code 동기화(DC-1~DC-6)
/setup-prompts ν”„λ‘¬ν”„νŠΈ λŸ¬λ„ˆ μ΄ˆκΈ°ν™” β€” 110개 ν”„λ‘¬ν”„νŠΈμ˜ placeholder(제λͺ©Β·λͺ©ν‘œ) μΉ˜ν™˜
/verify-prompts ν”„λ‘¬ν”„νŠΈ 파일 무결성 검증 β€” ν•΄μ‹œΒ·ν¬κΈ°Β·κ΅¬λ¬Έ 확인
/run-prompts ν”„λ‘¬ν”„νŠΈ λŸ¬λ„ˆ μ‹œμž‘ β€” 001.txtλΆ€ν„° 순차 μžλ™ μ‹€ν–‰
/resume-prompts μ€‘λ‹¨λœ λŸ¬λ„ˆ 재개 β€” state.json에 μ €μž₯된 λ§ˆμ§€λ§‰ μœ„μΉ˜λΆ€ν„° μ΄μ–΄μ„œ μ‹€ν–‰

ν”„λ‘¬ν”„νŠΈ λŸ¬λ„ˆ (Prompt Runner)

μž₯μ‹œκ°„ 닀단계 ν”„λ‘¬ν”„νŠΈ μ‹œν€€μŠ€λ₯Ό 무인 μžλ™ μ‹€ν–‰ν•˜λŠ” λ„κ΅¬μž…λ‹ˆλ‹€. 110개의 λ²ˆν˜Έκ°€ 맀겨진 ν”„λ‘¬ν”„νŠΈ 블둝(001.txt~110.txt)을 μˆœμ„œλŒ€λ‘œ Claude Code에 μ£Όμž…ν•˜λ©°, 3번째 ν”„λ‘¬ν”„νŠΈλ§ˆλ‹€ /clear둜 μ»¨ν…μŠ€νŠΈλ₯Ό λΆ„λ¦¬ν•˜μ—¬ 총 35개 독립 μ„Έμ…˜μœΌλ‘œ 병렬 탐색·검증·톡합을 μˆ˜ν–‰ν•©λ‹ˆλ‹€.

핡심 κΈ°λŠ₯

  • μ„Έμ…˜ 관리: pipe λͺ¨λ“œλ‘œ μ„Έμ…˜ ID 캑처 ν›„ --resume으둜 이어 μ‹€ν–‰. /clear 블둝 μžλ™ 처리
  • 3계측 검증:
    1. Silent Failure ν‚€μ›Œλ“œ 탐지 β€” "μƒλž΅", "μŠ€ν‚΅", "TODO" λ“± μ‹€νŒ¨ μ§€ν‘œ 감지 μ‹œ μž¬μ‹œλ„
    2. 파일 λ³€κ²½ μŠ€λƒ…μƒ· β€” ν”„λ‘¬ν”„νŠΈ μ‹€ν–‰ μ „Β·ν›„ 파일 μ‹œμŠ€ν…œ diff둜 μ‹€μ œ μ‚°μΆœλ¬Ό 확인
    3. State Tracking β€” state.json에 μ‹€ν–‰ μƒνƒœΒ·μ™„λ£Œ λ³΄κ³ μ„œ μ €μž₯ (재개 기반)
  • Extended Thinking: ν”„λ‘¬ν”„νŠΈλ‹Ή ~16K ν† ν°μ˜ ν™•μž₯ 사고 μ˜ˆμ‚° ν• λ‹Ή
  • Stagnation Watchdog: idle timeout 감지 μ‹œ μžλ™ 회수
  • Rate-limit λŒ€μ‘: intelligent retry + μ§€μˆ˜ λ°±μ˜€ν”„
  • μ™„λ£Œ λ³΄κ³ μ„œ κ°•μ œ μ£Όμž…: 각 ν”„λ‘¬ν”„νŠΈ μ’…λ£Œ μ‹œ meta(exit code, session ID, μ†Œμš” μ‹œκ°„, 파일 λ³€κ²½ λͺ©λ‘) μžλ™ 기둝

μ—­ν• 

Research λ‹¨κ³„μ˜ 병렬 심측쑰사 μžλ™ν™”κ°€ μ£Ό μš©λ„μž…λ‹ˆλ‹€. prompt/ λ””λ ‰ν„°λ¦¬μ˜ PRD ν”„λ ˆμž„μ›Œν¬(기술 κ°œλ°œΒ·μ½”λ”© κ΅¬ν˜„Β·μ™ΈλΆ€ 톡합 심측쑰사)와 κ²°ν•©ν•˜μ—¬, 각 μ„Έμ…˜μ΄ λ…λ¦½μ μœΌλ‘œ νŠΉμ • 관점을 νƒμƒ‰ν•œ λ’€ μ΅œμ’… 톡합 λ‹¨κ³„μ—μ„œ final-research.md둜 μˆ˜λ ΄ν•©λ‹ˆλ‹€.

상세: prompt-runner/prompt-refining-strategy.md

Context Preservation System

μ»¨ν…μŠ€νŠΈ 토큰 초과, /clear, μ»¨ν…μŠ€νŠΈ μ••μΆ• μ‹œ μž‘μ—… 내역이 μƒμ‹€λ˜λŠ” 것을 λ°©μ§€ν•˜λŠ” μžλ™ μ €μž₯·볡원 μ‹œμŠ€ν…œμž…λ‹ˆλ‹€. 5개의 Hook μŠ€ν¬λ¦½νŠΈκ°€ μž‘μ—… 내역을 MD 파일둜 μžλ™ μ €μž₯ν•˜κ³ , μƒˆ μ„Έμ…˜ μ‹œμž‘ μ‹œ RLM νŒ¨ν„΄(포인터 + μš”μ•½ + μ™„λ£Œ μƒνƒœ + Git μƒνƒœ)으둜 이전 λ§₯락을 λ³΅μ›ν•©λ‹ˆλ‹€. Knowledge Archiveμ—λŠ” μ„Έμ…˜λ³„ phase(단계), phase_flow(닀단계 μ „ν™˜ 흐름), primary_language(μ£Όμš” μ–Έμ–΄), error_patterns(Error Taxonomy 12νŒ¨ν„΄ λΆ„λ₯˜ + resolution 맀칭), tool_sequence(RLE μ••μΆ• 도ꡬ μ‹œν€€μŠ€), final_status(μ„Έμ…˜ μ’…λ£Œ μƒνƒœ), tags(경둜 기반 검색 νƒœκ·Έ), session_duration_entries(μ„Έμ…˜ 길이) 메타데이터가 μžλ™ κΈ°λ‘λ©λ‹ˆλ‹€. μŠ€λƒ…μƒ·μ˜ 섀계 결정은 ν’ˆμ§ˆ νƒœκ·Έ μš°μ„ μˆœμœ„λ‘œ μ •λ ¬λ˜μ–΄ λ…Έμ΄μ¦ˆκ°€ 제거되고, μŠ€λƒ…μƒ· μ••μΆ• μ‹œ IMMORTAL μ„Ήμ…˜μ΄ μš°μ„  보쑴되며(μ••μΆ• 감사 좔적 포함), λͺ¨λ“  파일 쓰기에 atomic write(temp β†’ rename) νŒ¨ν„΄μ΄ μ μš©λ©λ‹ˆλ‹€. P1 ν• λ£¨μ‹œλ„€μ΄μ…˜ λ΄‰μ‡„λ‘œ KI μŠ€ν‚€λ§ˆ 검증, λΆ€λΆ„ μ‹€νŒ¨ 격리, SOT μ“°κΈ° νŒ¨ν„΄ 검증, SOT μŠ€ν‚€λ§ˆ 검증이 κ²°μ •λ‘ μ μœΌλ‘œ μˆ˜ν–‰λ©λ‹ˆλ‹€.

슀크립트 트리거 μ—­ν• 
context_guard.py (Hook λ””μŠ€νŒ¨μ²˜) Hook 톡합 μ§„μž…μ . --mode에 따라 μ μ ˆν•œ 슀크립트둜 λΌμš°νŒ…
save_context.py SessionEnd, PreCompact 전체 μŠ€λƒ…μƒ· μ €μž₯
restore_context.py SessionStart 포인터+μš”μ•½μœΌλ‘œ 볡원
update_work_log.py PostToolUse 9개 도ꡬ(Edit, Write, Bash, Task, NotebookEdit, TeamCreate, SendMessage, TaskCreate, TaskUpdate) μž‘μ—… 둜그 λˆ„μ , 75% threshold μ‹œ μžλ™ μ €μž₯
generate_context_summary.py Stop 맀 응닡 ν›„ 증뢄 μŠ€λƒ…μƒ· + Knowledge Archive 아카이빙 (30초 throttling, E5 Guard)
_context_lib.py (곡유 라이브러리) νŒŒμ‹±, 생성, SOT 캑처, 토큰 μΆ”μ •, Smart Throttling, Autopilot μƒνƒœ 읽기·검증, ULW κ°μ§€Β·μ€€μˆ˜ 검증, μ ˆμ‚­ μƒμˆ˜ 쀑앙화(10개), sot_paths() 경둜 톡합, 닀단계 μ „ν™˜ 감지, κ²°μ • ν’ˆμ§ˆ νƒœκ·Έ μ •λ ¬, Error Taxonomy 12νŒ¨ν„΄ λΆ„λ₯˜+Resolution 맀칭, IMMORTAL-aware μ••μΆ•+감사 좔적, E5 Guard 쀑앙화, Knowledge Archive 톡합(λΆ€λΆ„ μ‹€νŒ¨ 격리), KI μŠ€ν‚€λ§ˆ 검증, SOT μŠ€ν‚€λ§ˆ 검증, Adversarial Review P1 검증, Translation P1 검증, pACS P1 검증, Cross-Step Traceability P1 검증, Domain Knowledge P1 검증, Predictive Debugging P1, Abductive Diagnosis Layer(사전 증거 μˆ˜μ§‘ + 사후 검증 + KA 아카이빙 + Fast-Path)
setup_init.py Setup (--init) μ„Έμ…˜ μ‹œμž‘ μ „ 인프라 건강 검증 (Python, PyYAML, 슀크립트 ꡬ문, 디렉터리) + SOT μ“°κΈ° νŒ¨ν„΄ 검증(P1 ν• λ£¨μ‹œλ„€μ΄μ…˜ 봉쇄)
output_secret_filter.py PostToolUse (Bash|Read) 도ꡬ 좜λ ₯ μ‹œν¬λ¦Ώ 탐지 β€” 3-tier μΆ”μΆœ(tool_responseβ†’file_pathβ†’transcript), 25+ νŒ¨ν„΄, 2-패슀 μŠ€μΊ”(raw+decoded). P1 ν• λ£¨μ‹œλ„€μ΄μ…˜ 봉쇄
security_sensitive_file_guard.py PostToolUse (Edit|Write) λ³΄μ•ˆ 민감 파일 μˆ˜μ • κ²½κ³  β€” .env, credentials, *.pem λ“± 12개 νŒ¨ν„΄. exit 0 (κ²½κ³  μ „μš©)
setup_maintenance.py Setup (--maintenance) 주기적 건강 검진 (stale archives, knowledge-index 무결성, work_log 크기, doc-code 동기화 검증(DC-1~DC-6))
block_destructive_commands.py PreToolUse (Bash) μœ„ν—˜ λͺ…λ Ή μ‹€ν–‰ μ „ 차단 (git push --force, git reset --hard, rm -rf / λ“±). exit code 2 + stderr ν”Όλ“œλ°± (P1 ν• λ£¨μ‹œλ„€μ΄μ…˜ 봉쇄)
block_test_file_edit.py PreToolUse (Edit|Write) TDD λͺ¨λ“œ(.tdd-guard 쑴재) μ‹œ ν…ŒμŠ€νŠΈ 파일 μˆ˜μ • 차단. exit code 2 + stderr ν”Όλ“œλ°±
predictive_debug_guard.py PreToolUse (Edit|Write) μ—λŸ¬ 이λ ₯ 기반 μœ„ν—˜ 파일 사전 κ²½κ³ . risk-scores.json μΊμ‹œ 쑰회 β†’ μž„κ³„κ°’ 초과 μ‹œ stderr κ²½κ³  (exit code 0, κ²½κ³  μ „μš©)
diagnose_context.py (독립 슀크립트) Abductive Diagnosis 사전 증거 μˆ˜μ§‘ β€” ν’ˆμ§ˆ 게이트 FAIL μ‹œ 증거 λ²ˆλ“€(retry history, upstream evidence, hypothesis priority) μˆ˜μ§‘. Orchestratorκ°€ μˆ˜λ™ 호좜
validate_diagnosis.py (독립 슀크립트) Abductive Diagnosis P1 사후 검증 β€” AD1-AD10 ꡬ쑰적 무결성 검증. Orchestratorκ°€ μˆ˜λ™ 호좜

ν…ŒμŠ€νŠΈ 컀버리지: Safety Hook 3쒅에 λŒ€ν•΄ 131개 μžλ™ν™” ν…ŒμŠ€νŠΈ (output_secret_filter: 44 β€” λ‹¨μœ„ 22+Tier3 톡합 8+Tier1 톡합 9+Tier2 톡합 5 / security_sensitive_file_guard: 44 / block_destructive_commands: 43). setup_init.pyκ°€ μ„Έμ…˜ μ‹œμž‘ μ‹œ 전체 검증, setup_maintenance.pyκ°€ DC-1~DC-6으둜 doc-code 동기화 검증.

Autopilot Mode

μ›Œν¬ν”Œλ‘œμš°λ₯Ό λ¬΄μ€‘λ‹¨μœΌλ‘œ μ‹€ν–‰ν•˜λŠ” λͺ¨λ“œμž…λ‹ˆλ‹€. (human) 단계λ₯Ό ν’ˆμ§ˆ κ·ΉλŒ€ν™” κΈ°λ³Έκ°’μœΌλ‘œ μžλ™ μŠΉμΈν•˜κ³ , (hook) exit code 2λŠ” κ·ΈλŒ€λ‘œ μ°¨λ‹¨ν•©λ‹ˆλ‹€.

  • Anti-Skip Guard: 각 단계 μ™„λ£Œ μ‹œ μ‚°μΆœλ¬Ό 파일 쑴재 + μ΅œμ†Œ 크기(100 bytes) 검증
  • Decision Log: μžλ™ 승인 결정은 autopilot-logs/step-N-decision.md에 기둝
  • λŸ°νƒ€μž„ κ°•ν™”: Hook 기반 μ»¨ν…μŠ€νŠΈ μ£Όμž… + μŠ€λƒ…μƒ· λ‚΄ Autopilot μƒνƒœ 보쑴

상세: AGENTS.md Β§5.1

ULW (Ultrawork) Mode

ν”„λ‘¬ν”„νŠΈμ— ulwλ₯Ό ν¬ν•¨ν•˜λ©΄ ν™œμ„±ν™”λ˜λŠ” 철저함 강도(thoroughness intensity) μ˜€λ²„λ ˆμ΄μž…λ‹ˆλ‹€. Autopilot(μžλ™ν™” μΆ•)κ³Ό μ§κ΅ν•˜μ—¬ μ–΄λ–€ 쑰합이든 κ°€λŠ₯ν•©λ‹ˆλ‹€.

  • I-1. Sisyphus Persistence: μ΅œλŒ€ 3회 μž¬μ‹œλ„, 각 μ‹œλ„λŠ” λ‹€λ₯Έ 접근법. 100% μ™„λ£Œ λ˜λŠ” λΆˆκ°€ μ‚¬μœ  보고
  • I-2. Mandatory Task Decomposition: TaskCreate β†’ TaskUpdate β†’ TaskList ν•„μˆ˜
  • I-3. Bounded Retry Escalation: 동일 λŒ€μƒ 3회 초과 μž¬μ‹œλ„ κΈˆμ§€(ν’ˆμ§ˆ κ²Œμ΄νŠΈλŠ” 별도 μ˜ˆμ‚° 적용)
  • Compliance Guard: Python Hook이 3개 κ°•ν™” κ·œμΉ™μ˜ μ€€μˆ˜λ₯Ό κ²°μ •λ‘ μ μœΌλ‘œ 검증 (μŠ€λƒ…μƒ· IMMORTAL 보쑴)

상세: docs/protocols/ulw-mode.md

4계측 ν’ˆμ§ˆ 보μž₯ (Quality Assurance Stack)

μ›Œν¬ν”Œλ‘œμš° 각 λ‹¨κ³„μ˜ μ‚°μΆœλ¬Όμ΄ κΈ°λŠ₯적 λͺ©ν‘œλ₯Ό 100% λ‹¬μ„±ν–ˆλŠ”μ§€ κ²€μ¦ν•˜λŠ” 닀계측 ν’ˆμ§ˆ 보μž₯ μ‹œμŠ€ν…œμž…λ‹ˆλ‹€.

계측 이름 검증 λŒ€μƒ 성격
L0 Anti-Skip Guard 파일 쑴재 + β‰₯ 100 bytes 결정둠적 (Hook)
L1 Verification Gate κΈ°λŠ₯적 λͺ©ν‘œ 100% 달성 의미둠적 (Agent μžκΈ°κ²€μ¦)
L1.5 pACS Self-Rating F/C/L 3차원 신뒰도 Pre-mortem Protocol 기반
L2 Adversarial Review (Enhanced) μ λŒ€μ  κ²€ν†  (@reviewer + @fact-checker) Review: ν•„λ“œ 지정 단계
  • 검증 κΈ°μ€€ μ„ ν–‰ μ„ μ–Έ: μ›Œν¬ν”Œλ‘œμš°μ˜ 각 단계에 Verification ν•„λ“œλ‘œ ꡬ체적·츑정 κ°€λŠ₯ν•œ 기쀀을 Task μ•žμ— μ •μ˜
  • pACS (predicted Agent Confidence Score): Pre-mortem Protocol ν›„ F(Factual Grounding), C(Completeness), L(Logical Coherence) 채점. min-score 원칙: pACS = min(F,C,L)
  • 행동 트리거: GREEN(β‰₯70) μžλ™ 진행, YELLOW(50-69) ν”Œλž˜κ·Έ ν›„ 진행, RED(<50) μž¬μž‘μ—…
  • Adversarial Review (L2): @reviewer(μ½”λ“œ/μ‚°μΆœλ¬Ό λΉ„νŒμ  뢄석) + @fact-checker(μ™ΈλΆ€ 사싀 검증) Sub-agent둜 독립적 κ²€ν† . P1 검증(validate_review.py)으둜 리뷰 ν’ˆμ§ˆ 보μž₯
  • Team 3계측 검증: L1(Teammate μžκΈ°κ²€μ¦) + L1.5(pACS μžκΈ°μ±„μ ) + L2(Team Lead 쒅합검증 + 단계 pACS)
  • 검증 둜그: verification-logs/step-N-verify.md, pacs-logs/step-N-pacs.md
  • Abductive Diagnosis: ν’ˆμ§ˆ 게이트(Verification/pACS/Review) FAIL β†’ μž¬μ‹œλ„ 사이에 3단계 κ΅¬μ‘°ν™”λœ 진단(P1 사전 증거 μˆ˜μ§‘ β†’ LLM 원인 뢄석 β†’ P1 사후 검증) μˆ˜ν–‰. Fast-Path(FP1-FP3)둜 결정둠적 단좕 κ°€λŠ₯
  • ν•˜μœ„ ν˜Έν™˜: Verification ν•„λ“œ μ—†λŠ” κΈ°μ‘΄ μ›Œν¬ν”Œλ‘œμš°λŠ” Anti-Skip Guard만으둜 λ™μž‘

상세: AGENTS.md Β§5.3, Β§5.4, Β§5.5, Β§5.6

μ ˆλŒ€ κΈ°μ€€

이 ν”„λ‘œμ νŠΈμ˜ λͺ¨λ“  μ„€κ³„Β·κ΅¬ν˜„ μ˜μ‚¬κ²°μ •μ— μ μš©λ˜λŠ” μ΅œμƒμœ„ κ·œμΉ™:

  1. ν’ˆμ§ˆ μ΅œμš°μ„  β€” 속도, λΉ„μš©, μž‘μ—…λŸ‰λ³΄λ‹€ μ΅œμ’… 결과물의 ν’ˆμ§ˆμ΄ μœ μΌν•œ κΈ°μ€€
  2. 단일 파일 SOT β€” Single Source of Truth + 계측적 λ©”λͺ¨λ¦¬ ꡬ쑰둜 데이터 일관성 보μž₯
  3. μ½”λ“œ λ³€κ²½ ν”„λ‘œν† μ½œ (CCP) β€” μ½”λ“œ λ³€κ²½ μ „ μ˜λ„ νŒŒμ•… β†’ 영ν–₯ λ²”μœ„ 뢄석 β†’ λ³€κ²½ 섀계 3단계 μˆ˜ν–‰. 뢄석 κΉŠμ΄λŠ” λ³€κ²½ 규λͺ¨μ— λΉ„λ‘€. μ½”λ”© 기쀀점(CAP-1~4): μ½”λ”© μ „ 사고, λ‹¨μˆœμ„± μš°μ„ , λͺ©ν‘œ 기반 μ‹€ν–‰, 외과적 λ³€κ²½
  4. ν’ˆμ§ˆ > SOT, CCP β€” μ„Έ 기쀀이 μΆ©λŒν•˜λ©΄ ν’ˆμ§ˆμ΄ μš°μ„ . SOT와 CCPλŠ” μˆ˜λ‹¨μ΄μ§€ λͺ©μ μ΄ μ•„λ‹˜

이둠적 기반

coding-resource/recursive language models.pdf β€” μž₯κΈ°κΈ°μ–΅(long-term memory) κ΅¬ν˜„μ— ν•„μˆ˜μ μΈ 이둠을 담은 λ…Όλ¬Έμž…λ‹ˆλ‹€. μ—μ΄μ „νŠΈκ°€ μ„Έμ…˜μ„ λ„˜μ–΄ 지식을 μΆ•μ ν•˜κ³  ν™œμš©ν•˜λŠ” λ©”μ»€λ‹ˆμ¦˜μ˜ 이둠적 ν† λŒ€μž…λ‹ˆλ‹€.

AI 도ꡬ ν˜Έν™˜μ„±

이 ν”„λ‘œμ νŠΈλŠ” Hub-and-Spoke νŒ¨ν„΄μœΌλ‘œ λͺ¨λ“  AI CLI λ„κ΅¬μ—μ„œ λ™μΌν•œ 방법둠이 μžλ™ μ μš©λ©λ‹ˆλ‹€.

Hub (방법둠 SOT):

파일 μ—­ν• 
AGENTS.md λͺ¨λ“  AI 도ꡬ 곡톡 β€” μ ˆλŒ€ κΈ°μ€€, 섀계 원칙, μ›Œν¬ν”Œλ‘œμš° ꡬ쑰 μ •μ˜

Spoke (도ꡬ별 ν™•μž₯):

AI CLI 도ꡬ μ‹œμŠ€ν…œ ν”„λ‘¬ν”„νŠΈ 파일 μžλ™ 적용
Claude Code CLAUDE.md Yes
Gemini CLI GEMINI.md + .gemini/settings.json Yes
Codex CLI AGENTS.md (직접 읽음) Yes
Copilot CLI .github/copilot-instructions.md Yes
Cursor .cursor/rules/agenticworkflow.mdc Yes

λͺ¨λ“  Spoke 파일의 μ ˆλŒ€ κΈ°μ€€κ³Ό 섀계 원칙은 AGENTS.md와 λ™μΌν•©λ‹ˆλ‹€. μ°¨μ΄λŠ” 도ꡬ별 κ΅¬ν˜„ λ§€ν•‘μ˜ κ΅¬μ²΄μ„±λΏμž…λ‹ˆλ‹€.

λ¬Έμ„œ 읽기 μˆœμ„œ

μˆœμ„œ λ¬Έμ„œ λͺ©μ 
1 README.md (이 파일) ν”„λ‘œμ νŠΈ κ°œμš” νŒŒμ•…
1.5 soul.md ν”„λ‘œμ νŠΈ 영혼 β€” κ·œμΉ™ μ•„λž˜μ˜ 이유, DNA μœ μ „ μ² ν•™
2 AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md 섀계 μ² ν•™κ³Ό μ•„ν‚€ν…μ²˜ 이해
2.5 DECISION-LOG.md λͺ¨λ“  섀계 κ²°μ •μ˜ λ§₯락과 κ·Όκ±° 좔적 (ADR)
3 AGENTICWORKFLOW-USER-MANUAL.md μ‹€μ œ μ‚¬μš©λ²• ν•™μŠ΅
4 AGENTS.md / CLAUDE.md μ‚¬μš©ν•˜λŠ” AI 도ꡬ에 λ§žλŠ” μ§€μ‹œμ„œ μ°Έμ‘°
5 docs/protocols/*.md νŠΉμ • 주제(AutopilotΒ·ULWΒ·ν’ˆμ§ˆ 게이트·CCPΒ·Context Preservation) 심화

이 μ½”λ“œλ² μ΄μŠ€λ‘œ λ§Œλ“  κ°œλ³„ ν”„λ‘œμ νŠΈμ˜ μ‚¬μš©λ²•κ³Ό ν˜Όλ™ν•˜μ§€ λ§ˆμ„Έμš”. κ°œλ³„ ν”„λ‘œμ νŠΈμ˜ 맀뉴얼은 ν•΄λ‹Ή ν”„λ‘œμ νŠΈ 내에 λ³„λ„λ‘œ μ‘΄μž¬ν•©λ‹ˆλ‹€.

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

63 stars

Watchers

0 watching

Forks

85 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages