LostCatBox

(책 리뷰) 개발자를 위한 생각의 정리 - 문서작성법

Word count: 973Reading time: 6 min
2025/07/10 Share

왜?

  • 문제점: 논리적 사고 및 정리가 되지 않은 상태로 내 생각의 흐름에 따라 말하며 소통했다.
  • 결과:
    • 겪어본 상황: 프로젝트 관련 일을 할 때, 서로 소통이 되지 않아, 같은 설명을 반복했다.
    • 들어본 말: “그래서 결론이 뭐야?”, “무슨 말 하는지 모르겠어, 다시 이야기해 줘”
  • 해결책: 논리적 사고 및 결과를 정리하는 법을 학습한 후, 사고 정리하여 소통한다.

논리 도해

정보 정리

  • 의미
    • 목적에 맞게 대량의 정보(다른 곳에서 얻은 것)를 분해하여 의미 있는 정보(내 생각)만 남기고 재구성하는 것.
    • 생각을 정리하는 것
  • 과정
    • 대량의 정보를 분해
    • 취사선택
    • 재구성
  • 결과물
    • 논리 도해

논리 도해

  • 목적
    • 논리를 나타내는 것
  • 특징
    • 논리를 정확하고 빠짐없이 표현한다.
    • 도해(그림)이지만 꼭 그림일 필요는 없다. 텍스트로도 작성할 수 있다.
  • 작성법
    • 요소들을 찾기
      • 표준 정보(상식 정보 등)로 분류되는 정보는 보통 글에서 생략되어있다.
        • “A->B에게 정보를 주지 않아서 이슈가 발생했다” -> “기본 절차 중 A ->B에게 정보 전달 과정 존재”
        • (예시에서 절차 참조)
    • 공통점을 가진 요소들 그룹화 및 이름 달기
    • 요소 대응 관계 나타내기
  • 작성 예시
    • 등장인물: 고객,팀장, 담당 직원
    • 문제점 :
      • 고객이 팀장에게 물건 빌려줄 때, 차용증 발급 필요
      • 담당 직원이 빌린 물품인지 인식하지 못함
      • 담당 직원이 팀장님 책상에 반환함
      • 팀장님은 이를 늦게 확인함
    • 절차(표준 정보):
      • 1,2,3,4 가 본래의 절차
1
2
3
4
5
6
7
8
9
sequenceDiagram
participant C as 고객(C)
participant B as 팀장(B)
participant A as 담당 직원(A)

C->>B: 1. 물건 빌려줌(차용)
B->>A: 2. 물건 사용(제공)
A->>B: 3. 물건 반환(반환)
B->>C: 4. 물건 돌려줌(반환)

CS 정리

  • CS는 각각 범주(Category)와 요점(Summary) 뜻한다.
  • 긴 글 정리는 시작점이다.

범주(Category)

  • 특징
    • 같은 정보를 그룹화하여 발견
    • 보통 원문 글에는 생략됨
    • 추상화
  • 예시
    • 문제점, 업무개요, 나쁜 영향, 해결 방법, 크기, 비용, 동작, 목적

요점(Summary)

  • 특징
    • 정보의 구체성을 가짐
    • 구체화
    • 범주의 추상화 정보를 확정하도록 작성
  • 예시
    • 바람직한 예시 : XX 기능 추가, XX 기능 폐지, XX 자동차 부품 검증 필요
    • 부적절한 예시 : XX 기능, XX 자동차 부품

범주와 요점은 원문에 따라 달라진다.

  • 예시 1
    • 원문 : 랜섬웨어에 대한 글
    • 분류 : 악성 소프트웨어의 한 종류
    • 동작 : 이용자가 컴퓨터 시스템에 접근하지 못하게 한다
    • 목적 : 몸값을 요구
  • 예시 2 :

    • 원문 : 바이러스 하나(하데스 653)에 대한 글

    • 계통 : 하데스 653

    • 접근 제어 방식 : 하이브리드 방식으로 암호화

    • 몸값 지출 방법 : 가상 화폐 요구


GPS 정리

  • GPS는 각각 그룹화(Group), 병렬 정리(Parallel), 순서(Series)를 뜻한다.
  • 복잡하게 얽힌 주제에 유용하다.

그룹화(Group)

  • 방법 : 요소들의 공통점을 찾고 분류하여 그룹명을 정한다.
  • 특징
    • 구조화의 출발점이다.
    • 목적이 명확해야 분류도 명확하다.
      • 목적 : 원룸에서 동물 키우고 싶다 -> 분류 : 소형, 중형, 대형
      • 목적 : 더운 지역에서 동물 키우고 싶다 -> 분류 : 더위 내성, 추위 내성

병렬 정리(Parallel)

  • 방법 : 같은 항목 정보를 병렬로 나열
  • 특징
    • 표와 비슷한 형식

순서(Series)

  • 방법 : 요소에 순서 매기기
  • 중요한 이유
    • 빠지거나 중복된 요소 확인 가능
    • 다른 그룹이 없는지 확인
    • 목적을 명확히 할 수 있음

CS와 GPS 차이점

  • CS 목적: “무엇을 써야 하는가?”
  • GPS 목적: “어떻게 써야하는가?”

논리적 사고의 기본

논리적이란?

  • 어떤 것에 대해 체계적으로 정리하고 모순이나 비약 없이 이치를 밝힌 것

  • 문제가 명확해야 로직 트리가 작성되고 MECE를 지킬 수 있다.

    • 로직 트리

      • 결론과 이유를 분기하는 나무 구조로 나타내는 방법

      • 각 분기 부분에는 MECE(중복 없이 그리고 빠짐없이) 를 지켜 분해해야 합니다

        MECE : Mutually Exclusive Collectively Exhaustive

      • 최소한 MECE를 2번째 가지까지는 지켜야 합니다

논리적 사고

  • 보편적인 질문 과정 : 질문 -> (사고 과정) -> 결론 -> 행동
  • 필요한 과정 : 사고 과정
  • 보편적인 방법 : 일반법칙(모두가 납득하는 지식) -> 관찰 대상 -> 관찰 결과
    • 일반 법칙과 일반 법칙으로 설명되지 않는 것 또한 모두 증거형(3자가 확인할 수 있는 증거)으로 채택해야 한다.

로직 트리 활용

  • 조건 : 생각할 내용이 많을 때

  • 특징

    • 문제 설정 중요 : 명확한 문제(이유, 기준 포함) 일수록 MECE를 지킬 수 있음
  • 작성법

    • 검토하고자 하는 주제를 왼쪽에 1개 쓰고 오른쪽으로 분기한다
    • 분기할 때 가능한 한 MECE가 되도록 한다
    • 분기한 자식 요소는 부모 요소를 1개만 가지도록 한다.
  • 예시

    • flowchart LR
          회원["회원"]
          미성년["미성년"]
          성년["성년"]
          초등["초등 이하"]
          중등["중등 이하"]
          남성["남성"]
          여성["여성"]
      
          회원 --> 미성년
          회원 --> 성년
          미성년 --> 초등
          미성년 --> 중등
          성년 --> 남성
          성년 --> 여성

질문과 보고서

  • 목적 : 과거의 이해를 위한 것

질문과 답변

  • 특징

    • 질문의 의도에 따라 답변도 달라짐
    • 좋은 질문: 명확한 질문의 의도를 포함한다.
    • 좋은 답변: 현 상황 파악 및 (질문자의 행동을 의도하는) 제안을 포함한 답변을 한다.
  • 예시 :

    • 현 상황 : 90도의 500ml 뜨거운 물 있음
    • 질문 1: (커피 타 먹을 정도 양의 75도의 ) 뜨거운 물 있어?
    • 답변 1: 네 하지만 너무 뜨거워서 시간이 필요합니다
    • 질문 2 :(빙판길 녹여야 하는데) 뜨거운 물 있어?
    • 답변 2: 아니요 없습니다.
  • 결론 :

    • “결론부터 말해”가 가능한 상황 : 답변자는 이미 질문자의 의도와 행동을 알아야만 가능하다

보고서 작성

  • 보고서 및 답변자의 정보 정리 패턴
    • 상태, 트리거, 사고 손해 패턴
    • 구조 사전,대책 패턴
    • 기반, 행동, 사건, 판단 패턴(IAEJ)
    • 목적 방침 패턴

기획서 및 제안서

  • 목적 : 미래를 향한 행동 촉구
  • 특징 :
    • 항상 하위 4개 항목으로 분류가능하며, 분석할 수 있다.
      • 목표
      • 현상
      • 정책
      • 성과
  • 주요 패턴
    • PREP
    • FABE

교육용 문서

패턴 종류 및 작성 팁

  • CASE + MEASURE 패턴 : 항상 조건과 XXX를 분류하여 나열하자
    • 조건 + 지시 패턴
    • 조건 + 이유 패턴
  • 사실 + 해설 + 방침 + 영향 패턴 : 해설은 생략하지 말고 항상 명시하자

문제 해결에 도움되는 정보 정리 노하우

업무

  • 업무의 종류

    • 정형 업무
  • 비정형 업무
  • 업무 과정 추상화 필요성

    • 다양한 종류의 업무를 한번에 요약, 정리가능
  • 업무 과정을 추상화 결과

    • 목적 : 구성원들의 공통 인식
    • 문제: 목적을 가로막는 것
    • 목표: 목적에 부합하는 정량적 구체적 기준 제시
    • 방침: 목표 달성에 도움이 되는 것
    • 정책: 실제 실행할 수 있는 행동

전략과 전술

  • 전략 : 전략 결정 지점(하나의 선택이 크게 영향을 미치는 분기점)에서 결정되는 것
    • 전략 결정 지점에서는 쉽게 바꿀 수 없기 때문에, 장단점을 명확히 조사하고 결정해야 함.
  • 전술: 결정이 수용된 후 구체적인 작업으로 수행되는 것

장애와 문제

  • 장애 : 목표로 향해 가고 있을 때 그 진행을 방해하는 것
    • 해결 방법 : 원인을 알고 해결책을 찾는다
  • 문제 : 목표에 도달하지 않은 것
    • 해결 방법 : 목표 변경을 통한 해결이 가능하다.
CATALOG
  1. 1. 왜?
  2. 2. 논리 도해
    1. 2.1. 정보 정리
    2. 2.2. 논리 도해
  3. 3. CS 정리
    1. 3.1. 범주(Category)
    2. 3.2. 요점(Summary)
    3. 3.3. 범주와 요점은 원문에 따라 달라진다.
  4. 4. GPS 정리
    1. 4.1. 그룹화(Group)
    2. 4.2. 병렬 정리(Parallel)
    3. 4.3. 순서(Series)
    4. 4.4. CS와 GPS 차이점
  5. 5. 논리적 사고의 기본
    1. 5.1. 논리적이란?
    2. 5.2. 논리적 사고
    3. 5.3. 로직 트리 활용
  6. 6. 질문과 보고서
    1. 6.1. 질문과 답변
    2. 6.2. 보고서 작성
  7. 7. 기획서 및 제안서
  8. 8. 교육용 문서
    1. 8.0.1. 패턴 종류 및 작성 팁
  • 9. 문제 해결에 도움되는 정보 정리 노하우
    1. 9.1. 업무
    2. 9.2. 전략과 전술
    3. 9.3. 장애와 문제