[🛠] 회사 실무 글을 workstream별 3단 카테고리로 나누기

✨ GPT-5.6 Sol의 요약 　

한 카테고리에 섞여 있던 회사 실무 기술 기록을 workstream별 연속 서사로 나누고, 경로·번호·내비게이션·기존 URL을 함께 정리한 기록.

회사 실무 devlog가 늘어나자 한 카테고리 안에서 서로 다른 이야기가 섞이기 시작했다. AI Orchestration과 Operations Automation은 이어지는 작업의 기준도, 다음 글을 읽는 순서도 달랐다. 그런데 둘을 모두 devlog/company-work에 두니 제목 번호가 회사 실무 전체 번호인지 프로젝트별 번호인지부터 애매했다.

devlog/company-work/<workstream> 경로와 번호를 함께 고정했다

글의 파일 경로, categories, permalink를 같은 workstream slug로 맞췄다. 제목 번호도 회사 실무 전체가 아니라 workstream 안에서 #1부터 이어지게 했다.

devlog/company-work/ai-orchestration
devlog/company-work/operations-automation

이제 URL만 봐도 어느 연속 서사에 속한 글인지 알 수 있고, 서로 다른 프로젝트의 번호가 부딪히지 않는다.

navigation.yml 한 트리로 sidebar와 모바일 메뉴를 렌더링했다

예전에 모바일 메뉴와 카테고리 overview를 같은 navigation data에 연결했다. 이번에는 그 트리의 company-work 아래에 workstream children을 한 단계 더 넣었다.

sidebar와 모바일 메뉴는 공용 category-nav-groups.html을 사용한다. 상위 회사 실무 archive에서는 모든 workstream 글을 모아 보여 주고, 하위 archive에서는 경로의 모든 category가 일치하는 글만 남긴다. 내비게이션마다 3단 구조를 따로 복사하지 않았다.

기존 2단 URL은 생성 redirect로 보존했다

카테고리를 옮기면 기존 /devlog/company-work/<글>/ 링크가 깨진다. 각 글에 redirect_from을 남기고, Jekyll generator가 새 3단 URL로 보내는 정적 redirect page를 만들게 했다. 잘못된 외부 경로나 서로 충돌하는 redirect는 build 전에 실패한다.

workstream 경로·번호·번역을 한 검사로 묶었다

company_work:verify는 등록된 workstream인지, 파일 경로와 categories가 같은지, 제목 번호가 빠지거나 겹치지 않는지, 활성 locale 번역도 같은 구조인지 함께 검사한다.

회사 실무 글을 더 쓸 때는 이제 먼저 workstream을 고르면 된다. 그러면 URL, archive, 내비게이션과 제목 번호가 같은 연속 서사를 가리킨다.