init: llm-wiki-haness 하네스 설계
This commit is contained in:
DongHyeonka
@@ -0,0 +1,75 @@
|
||||
---
|
||||
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 / 묶음
|
||||
|
||||
<!-- GENERATED: derived-blogs:start -->
|
||||
- [[wiki/blog/ca-tmpl-knowledge-capture-workflow-2026-07-02]]
|
||||
<!-- GENERATED: derived-blogs:end -->
|
||||
Reference in New Issue
Block a user