--- title: ca-tmpl - Knowledge Capture Workflow 결정 source_type: project status: verified confidence: medium tags: [ca-tmpl, workflow, documentation, agent-workflow, documented-only] related_projects: [ca-tmpl] last_reviewed: 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처럼 쓰지 않는다. ## 관련 개념 - [[wiki/concepts/clean-architecture-package-layout]] ## Sources - [[raw/blog-topics/post-implementation-knowledge-capture-workflow-2026-05-28]] — knowledge capture workflow 블로그 글감 raw seed. - [[raw/branch-notes/feature-architecture-enforcement-rules]] — workflow rule 반영 결정. - [[raw/branch-notes/feature-application-port-usecase-contract]] — workflow 적용 사례. - [[raw/errors/apply-patch-auto-approval-rejected-2026-05-28]] — workflow 문서 패치 중 도구 차단 사례. - [[raw/interviews/post-implementation-knowledge-capture]] — 같은 작업에서 파생된 면접 질문. ## Cluster / 묶음 - [[wiki/blog/ca-tmpl-knowledge-capture-workflow-2026-07-02]]