Files
llm-wiki/vault/30-knowledge/projects/ca-tmpl/knowledge-capture-workflow.md
T

4.4 KiB

title, source_type, status, confidence, tags, related_projects, last_reviewed
title source_type status confidence tags related_projects last_reviewed
ca-tmpl - Knowledge Capture Workflow 결정 project verified medium
ca-tmpl
workflow
documentation
agent-workflow
documented-only
ca-tmpl
2026-07-02

ca-tmpl - Knowledge Capture Workflow 결정

Layer: wiki/projects/ — ca-tmpl 작업 종료 조건에 지식 캡처를 포함한 workflow 결정. 블로그/면접 파생은 이 canonical을 review/verify한 뒤 진행한다.

프로젝트 컨텍스트

ca-tmpl 작업에서는 비자명한 구현이 끝난 뒤 코드만 남고, 왜 그렇게 했는지/어떤 오류를 겪었는지/면접과 블로그로 옮길 만한 학습이 무엇인지가 채팅 로그에 흩어지는 문제가 있었다. 이를 줄이기 위해 branch-note, error note, interview prep, blog-topic을 작업 종료 흐름의 일부로 기록하는 workflow를 repo-local rule로 둔 결정이 있다.

실제 구현 내용 (actually-implemented)

없음. 이 문서가 기록하는 것은 runtime 기능이나 애플리케이션 코드가 아니라 workflow rule과 문서화 결정이다. verified 범위도 애플리케이션 동작이 아니라 repo-local documentation workflow에 한정한다.

로컬/dev 검증 (locally-verified)

부분적이다. feature-application-port-usecase-contract 등 일부 branch에서 branch-note 갱신과 derived raw note 생성이 실제로 수행된 사례가 있고, 이번 raw/blog-topics 59개 ingest batch도 workflow의 raw→canonical 승격 사례다. 다만 자동 강제 장치가 아니라 agent workflow rule에 의존한다.

운영 검증 (prod-verified)

없음. 운영 시스템 기능이 아니며 prod verification 대상이 아니다.

문서/계획만 존재 (documented-only / planned)

  • non-trivial 구현 종료 조건에 LLM Wiki capture를 포함한다.
  • 캡처 단위는 raw/branch-notes/, raw/errors/, raw/interviews/, raw/blog-topics/로 나눈다.
  • canonical(wiki/concepts/, wiki/projects/)과 derived(wiki/blog/, wiki/interview/, wiki/portfolio/)는 명시 요청과 게이트를 거친다.
  • derived raw note는 ## Parent로 branch-note를 가리키고, branch-note는 ## Cluster에서 되돌아 링크한다.
  • 자동 강제(git hook/CI)는 아직 없다.

면접에서 말할 수 있는 범위

  • 자신 있게: 구현 종료 조건에 decision/error/interview/blog-topic capture를 포함한 이유와 raw/canonical/derived 계층 분리.
  • 적당히: agent workflow rule만으로 누락을 줄이는 방식의 장단점.
  • 답하면 안 됨: CI나 git hook으로 자동 강제했다고 말하면 안 된다.

과장 금지 지점

  • "자동으로 캡처된다" → 금지. 현재는 documented workflow rule이며 runtime/CI enforcement가 아니다.
  • "모든 branch에서 누락 없이 동작했다" → 금지. 사례는 누적 중이다.
  • "raw에서 바로 blog를 만든다" → 금지. blog는 canonical 경유 후 파생한다.

Blog-topic ingest: post-implementation-knowledge-capture-workflow (2026-07-02)

raw/blog-topics/post-implementation-knowledge-capture-workflow-2026-05-28 는 구현 완료 조건에 branch-note와 파생 raw note 캡처를 포함하는 workflow를 글감으로 풀기 위한 raw seed다.

  • canonical 반영 범위: ca-tmpl 작업 종료 조건과 LLM Wiki capture workflow 결정으로 연결했다.
  • blogify 전 조건: 충족. 이 문서는 workflow 적용 사례와 자동 강제 부재를 분리해 verified로 승격했다.
  • 블로그 전 과장 방지: documented workflow rule을 자동화된 enforcement처럼 쓰지 않는다.

관련 개념

Sources

Cluster / 묶음