Files

T

Antigravity Agent f8b21af4be Wiki cleanup: error-doc removal, dedup merge, link normalization

10_Wiki/Topics 대규모 정리:
- 오류 캡처/미완성 stub 문서 227개 제거
- 교차폴더 중복 43클러스터 병합 (63파일 → redirect)
- 링크명 정규화: 깨진 링크 수정·redirect 직결·개념 매핑 ~2,400건
- 카테고리 MOC 6개 신규 생성
- Graph 섹션 미해결 related-keyword 링크 10,058건 제거

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-20 23:52:15 +09:00

4.7 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack

title

Sprout Method (스프라우트 메서드)

매 한 줄

"매 untestable 한 method 의 옆에 매 새 method 의 sprout — 매 새 logic 의 isolation, 매 test 의 가능". Michael Feathers 의 Working Effectively with Legacy Code (2004) 의 핵심 technique. 매 legacy code 의 modification 시 매 직접 수정 X — 매 옆에 새 method 의 grow.

매 핵심

매 motivation

Legacy method: 매 too long, too coupled, 매 test 의 X.
새 feature 의 add 필요: 매 직접 수정 → 매 risk 의 폭발.
Sprout: 매 new logic 의 separate method, 매 test 의 first, 매 caller 의 단순 call.

매 절차

Identify 매 change point.
Write 매 새 method (with tests) — empty 매 body, 매 signature first.
Test-drive 매 새 method 의 구현.
Call 매 새 method 의 from legacy code (one line).
매 legacy code 의 거의 untouched.

매 응용

Bug fix 의 add — 매 새 validation 의 sprout.
Feature flag 의 add — 매 새 conditional 의 sprout.
Logging 의 add — 매 새 logger call 의 sprout.

💻 패턴

Before sprout

public class OrderProcessor {
    public void process(Order order) {
        // 100+ lines of untested legacy logic
        repository.save(order);
        emailService.send(order.getCustomer(), "thanks");
    }
}

Sprout method 의 적용

public class OrderProcessor {
    public void process(Order order) {
        // 100+ lines untouched
        repository.save(order);
        sendOrderConfirmation(order); // sprouted
    }

    // New method — fully tested
    void sendOrderConfirmation(Order order) {
        var template = order.isPriority()
            ? "priority-thanks"
            : "thanks";
        emailService.send(order.getCustomer(), template);
    }
}

Test 의 새 method (JUnit 5)

@Test
void priorityOrder_usesPriorityTemplate() {
    var order = new Order(customer, true);
    var sut = new OrderProcessor(repo, emailMock);
    sut.sendOrderConfirmation(order);
    verify(emailMock).send(customer, "priority-thanks");
}

Sprout function (procedural)

def process_order(order):
    # Legacy logic untouched
    db.save(order)
    notify_customer(order)  # sprouted free function

def notify_customer(order):
    # New, tested logic
    template = "priority" if order.priority else "standard"
    email.send(order.customer, template)

Sprout 의 static helper

class LegacyService {
    void run() {
        var data = fetch();
        var clean = LegacyService.normalize(data); // sprouted static
        write(clean);
    }
    static String normalize(String s) { return s.strip().toLowerCase(); }
}

Visibility 의 package-private (testability)

// package-private for test access
void sendOrderConfirmation(Order order) { ... }

매 결정 기준

상황	Approach
Legacy method 의 too risky to refactor	Sprout method
매 새 logic 의 self-contained	Sprout method
매 변경 의 cross-cutting	Sprout class 의 사용
매 method 의 caller 의 wrapping 필요	Wrap method (sibling technique)
매 ample test coverage 의 존재	매 직접 refactor

기본값: 매 legacy code change → sprout method first. 매 직접 수정 X.

🔗 Graph

부모: Refactoring_Best_Practices
변형: Sprout & Wrap Techniques (스프라우트 & 랩 기법)
응용: Test-Driven Development

🤖 LLM 활용

언제: 매 legacy codebase 의 small additive change, 매 surrounding code 의 untested. 언제 X: 매 greenfield code (그냥 inline), 매 logic 의 deeply intertwined (Wrap 의 사용).

❌ 안티패턴

Sprout 의 then leave: 매 sprouted method 의 grow 의 indefinite — 매 결국 same problem.
No tests for sprout: 매 point 의 lost — 매 sprout 의 핵심 value 의 testability.
Sprout into same class: 매 class 의 already God class → sprout class 의 사용.

🧪 검증 / 중복

Verified (Feathers, WELC ch.6, 2004; Fowler refactoring catalog).
신뢰도 A.

🕓 Changelog

날짜	변경
2026-05-08	Phase 1
2026-05-10	Manual cleanup — full sprout method spec with Java/Python patterns

4.7 KiB Raw Blame History