Files
llm-wiki/.agents/workflows/projectize.md

2.5 KiB

description
description
개념 문서를 내 프로젝트 적용 문서로 변환

사용자가 /projectize <concept 문서 경로> 를 입력하면 아래 절차를 수행한다.

wiki/concepts/의 일반 개념 문서를 내 프로젝트 적용 문서로 변환합니다.

대상: <concept 문서 경로>

작업 절차

  1. 개념 문서 읽기

    • wiki/concepts/<...>.md의 Summary / Standard / Sources 파악
  2. 관련 프로젝트 식별

    • 내 프로젝트 자료(wiki/projects/, raw/project-notes/)에서 이 개념이 등장하는 곳 검색
    • 관련 프로젝트가 없으면 사용자에게 어느 프로젝트와 연결할지 물어봄
  3. 증거 등급 판정

    • 관련 프로젝트에서 이 개념이 어떤 등급으로 존재하는지 판정. 등급 어휘는 CLAUDE.md §6 프로젝트 증거 등급표가 SSOT — 인라인 재나열 금지.
    • 모든 진술에 §6 등급 라벨을 붙인다.
  4. project 문서 생성 (rules/naming-conventions.md §2.11 nested 구조)

    • 대상 경로: wiki/projects/<project-slug>/<concept-topic>.mdnested, hyphenated flat (<project>-<concept>.md) 금지
    • <project-slug>raw/project-notes/<project-slug>.md 의 슬러그와 일치 (cluster 정합성)
    • <concept-topic> 은 그 프로젝트 안에서 이 concept 의 적용 측면을 표현 (kebab-case, 4~6 단어)
    • 예: wiki/projects/keycloak-patterns/oidc-handshake-application.md (NOT wiki/projects/keycloak-patterns-oidc-handshake.md)
    • 프로젝트의 wiki sub-hub: sibling named hub wiki/projects/<project-slug>.md (folder-note 패턴, MOC) — 새 토픽 생성 시 hub 의 sub-doc 목록에도 등재. index.md 사용 금지 (rules/linking-rules.md §12).
    • templates/wiki-project-template.md 적용
    • "실제 구현 / 로컬 검증 / 문서·계획 / 면접 가능 범위 / 과장 금지" 섹션을 사실 기반으로 채움
    • 추측이나 일반화는 적지 않음
  5. 양방향 링크

    • 원본 concept 문서의 "Project Application" 섹션에 새 project 문서를 [[...]]로 연결
    • 새 project 문서의 "관련 개념"에 원본 concept를 [[...]]로 연결
  6. 로그 기록

    • wiki/log.md: YYYY-MM-DD HH:mm /projectize — <concept> → <project>

규칙

  • 개념 문서의 일반론을 내가 한 것처럼 옮기지 말 것.
  • 사실 확인이 안 되는 부분은 needs-confirmation으로 두고 사용자에게 질문.
  • 면접에서 말할 수 있는 범위와 말하면 안 되는 부분을 반드시 분리.