Harness/architecture
-
Session 48, 큐잉 아키텍처 리팩토링: 3중 게이트에서 SessionLane까지Harness/architecture 2026. 3. 30. 16:27
Date: 2026-03-30Author: geode-teamTags: agent-architecture, queue-system, session-lane, releaseTable of Contents세션 개요문제 인식 — "지금 너무 복잡하지 않아?"진행 순서 — 6 PRs (#531-#536)Before → After 아키텍처검증 — 5-Persona Verification Team측정치1. 세션 개요Session 48은 큐잉 아키텍처 전면 재설계 세션입니다. v0.36.0 릴리스 직후, 실행 제어 경로에 쌓여 있던 3중 동시성 게이트를 2개 컴포넌트(SessionLane)로 축소하고, standalone REPL을 폐기하여 실행 경로를 단일화했습니다.MetricBefore (v0.36.0)After..
-
Thin-Only: standalone REPL을 없애기까지Harness/architecture 2026. 3. 30. 08:14
Date: 2026-03-30Author: geode-teamTags: agent-architecture, ipc, unix-socket, thin-clientTable of Contents2개 코드 경로의 문제"standalone을 없앨 수는 없다" → "왜 안 돼?"SessionMode.IPCServe auto-startIPC 프로토콜 확장결과1. 2개 코드 경로의 문제GEODE에는 사용자가 에이전트를 호출하는 두 가지 경로가 있었습니다.standalone REPL (uv run geode): bootstrap_geode() → MCP, Skills, Hooks, Memory 자체 부트스트랩 → AgenticLoop 직접 실행.thin IPC client (uv run geode + serve 감지)..
-
GEODE Hook System: 이벤트 기반 리플 패턴으로 라이프사이클을 제어Harness/architecture 2026. 3. 28. 02:45
모듈: core/hooks/ (cross-cutting concern, L0~L5 전 레이어에서 접근)진입점: from core.hooks import HookSystem, HookEvent이벤트: 45개 | 등록 핸들러: 17개 | 플러그인: YAML + class-basedHook 성숙도 모델Hook System은 단순한 이벤트 로깅을 넘어 관측 → 반응 → 판단 → 자율의 4단계로 발전합니다.┌─────────────────────────────────────────────────────────────────┐│ L4 AUTONOMY 패턴에서 규칙을 자율 학습 ││ ..
-
Kent Beck Simple Design으로 에이전트 코드베이스 리팩토링Harness/architecture 2026. 3. 26. 23:59
Date: 2026-03-26Author: geode-team (Claude Code Opus 4.6)Tags: refactoring, kent-beck, simple-design, dry, srp, python, clean-architecture God Object 하나를 분해했더니 나머지 여섯 개가 보였습니다.이 글은 7개 파일 48K줄에 숨어있던 Kent Beck Simple Design 위반을 5개 Phase로 제거하고,835줄을 절감하며 전체 테스트 3,224개를 유지한 과정을 기록합니다.목차도입: God Object 한 개를 잡으면 여섯 개가 나온다감사(Audit) 결과: 7개 파일 위반 지도Kent Beck Simple Design 4규칙과 소크라틱 게이트Phase 1 — 유틸 추출: dry..
-
God Object 해체: 2,554줄 __init__.py를 분해하고 3,000줄을 삭제한 기록Harness/architecture 2026. 3. 24. 04:33
14개의 책임이 하나의 파일에 뭉쳐져 있었습니다.파이프라인 실행, 보고서 렌더링, 도구 핸들러, IP 해석, 세션 관리, 캐싱...이 글은 2,554줄 God Object를 분할하고, 데드코드를 찾아 삭제하고,184개 모듈을 178개로 줄인 리팩토링 과정을 기록합니다.Date: 2026-03-24 Author: geode-team Tags: refactoring, god-object, dead-code, clean-architecture, cli, dataclass목차도입: 2,554줄 파일의 무게문제 진단: 14개 책임 식별설계: 추출 전략과 순환 참조 해법1단계 — God Object 분할2단계 — 핸들러 단일 소스화3단계 — 데드코드 6모듈 삭제4단계 — RuntimeBuilder 30→3결과와 교..
-
Graceful Degradation: 실패해도 시스템이 멈추지 않는 설계Harness/architecture 2026. 3. 21. 03:22
Date: 2026-03-21Author: geode-teamTags: graceful-degradation, MCP, config, frontier, resilience, OpenClaw, Claude-Code목차도입 — "11/14 서버 연결, 3건 실패. 시스템은 정상"프론티어 4종의 실패 대응 패턴GEODE 실전: MCP 카탈로그 패키지명 오류 5건소크라틱 게이트로 "수정하지 않을 것" 결정.env cascade는 왜 과잉 엔지니어링인가마무리 — 실패를 설계하는 체크리스트1. 도입 — "11/14 서버 연결, 3건 실패. 시스템은 정상"자율 에이전트 시스템에서 외부 의존성은 반드시 실패합니다. npm 패키지가 404를 반환하고, API 키가 만료되고, 서버가 타임아웃됩니다. 문제는 실패 자체가 아..
-
GEODE Hook System: 이벤트로 파이프라인을 오가는 이벤트 버스Harness/architecture 2026. 3. 16. 02:57
Date: 2026-03-16Author: Claude Code Opus 4.6, mangowhoiscloudTags: [hooks, event-driven, orchestration, plugin, bootstrap, stuck-detection, run-log, pub-sub]목차도입 — 노드 사이의 보이지 않는 연결27개 이벤트 — 전체 분류 체계HookSystem — 우선순위 기반 동기 실행파이프라인 관통 — 노드 래핑 패턴Bootstrap — 실행 전 컨텍스트 주입소비자들 — 로그, 탐지, 메모리, 자동화플러그인 확장 — YAML과 클래스 기반 디스커버리합성 패턴 — 팬아웃, 체이닝, 루프백왜 Sync인가 — async 전환 시도와 좌절서브에이전트와 Hook의 관계 — as_completed 패..