GukLabDocs

개요

15개 토이 프로젝트에서 만든 검증 절차·헤드리스 테스트·문서 작성법을 다음 프로젝트에서도 찾고 재사용할 수 있게 정리한 개발 지식 허브입니다.

문서를 한곳에 복사하지 않고, 코드 변경에 따라 달라지는 문서는 각 저장소에 유지합니다. 허브에는 여러 프로젝트에 적용할 수 있는 플레이북과 Skill, 결정 근거만 연결했습니다.

문제와 해결

1. 01

   복사본 없이 문서 연결

   원본 README가 바뀌어도 허브의 사본은 자동으로 갱신되지 않았습니다.

   코드와 함께 변하는 문서는 경로로 연결하고, 허브에는 여러 프로젝트에서 수명이 긴 원칙과 사례만 유지했습니다.

2. 02

   프로젝트 수치의 단일 관리

   같은 숫자를 여러 표에서 직접 수정하면서 누락이 반복됐습니다.

   프로젝트 메타데이터를 한곳에서 관리하고 README와 표를 다시 생성해, 결과에 차이가 남으면 CI가 실패하도록 구성했습니다.

3. 03

   작업 범위에 맞춘 문서 탐색

   모든 규칙을 한 문서에 넣으면 작은 작업을 시작할 때도 관련 없는 맥락까지 읽어야 했습니다.

   규칙을 작업 범위별로 나누고 요청에 필요한 문서만 선택하는 읽기 순서와 라우팅 기준을 정리했습니다.

주요 구현

• ◆15개 프로젝트의 목적·기술·공개 범위·문서 위치를 연결한 카탈로그
• ◆측정·검증·문서화·웹 최적화·CI 보안 공통 플레이북
• ◆프로젝트별 Agent Skill·Rule의 적용 범위와 의존성 색인
• ◆프로젝트 메타데이터 기반 파생 문서 생성과 CI 변경 검사
• ◆개발자와 비개발 직군을 위한 역할별 프로젝트 진입점

회고

문서를 한곳에 모으는 것보다 원본의 위치와 갱신 책임을 분명히 하고, 필요한 문서까지 빠르게 찾아가는 경로를 만드는 편이 오래 유지됐습니다.