jihoson/The-Ouroboros
1
0
Fork 0
Code Issues Pull Requests Actions 10 Packages Projects Releases Wiki Activity

리팩토링: CLAUDE.md 문서 분산 구조화 #13

New Issue
Closed
opened 2026-02-04 10:03:49 +09:00 by agentson · 0 comments
agentson commented 2026-02-04 10:03:49 +09:00
Collaborator
Copy Link

문제점

현재 CLAUDE.md에 모든 내용이 집중되어 컨텍스트가 불필요하게 길어짐.
agents.md 전략처럼 주제별로 문서를 분산시켜 필요한 부분만 참조하도록 개선 필요.

제안 구조

CLAUDE.md (개요)

  • 프로젝트 개요
  • 빠른 시작 가이드
  • 다른 문서 링크 허브 역할

docs/workflow.md

  • Git Workflow Policy
  • Agent Workflow
  • 병렬 작업 전략

docs/commands.md

  • Common Command Failures
  • Build & Test Commands
  • 환경 설정 명령어

docs/architecture.md

  • 시스템 아키텍처
  • 컴포넌트 상세 설명
  • 데이터 플로우

docs/constraints.md

  • Key Constraints (기존 agents.md 내용 흡수 또는 링크)
  • 정책 및 제약사항

docs/testing.md

  • Test Structure
  • 테스트 작성 가이드
  • Coverage 요구사항

작업 범위

  1. 새 문서 구조 생성
  2. CLAUDE.md 내용 분산 이동
  3. CLAUDE.md를 간결한 허브 문서로 재작성
  4. 모든 문서 간 상호 링크 설정
  5. agents.md와 중복 내용 통합/정리

기대 효과

  • 컨텍스트 크기 최소화
  • 주제별 빠른 참조
  • 문서 유지보수성 향상
  • 필요한 정보만 선택적 로드
## 문제점 현재 CLAUDE.md에 모든 내용이 집중되어 컨텍스트가 불필요하게 길어짐. agents.md 전략처럼 주제별로 문서를 분산시켜 필요한 부분만 참조하도록 개선 필요. ## 제안 구조 ### CLAUDE.md (개요) - 프로젝트 개요 - 빠른 시작 가이드 - 다른 문서 링크 허브 역할 ### docs/workflow.md - Git Workflow Policy - Agent Workflow - 병렬 작업 전략 ### docs/commands.md - Common Command Failures - Build & Test Commands - 환경 설정 명령어 ### docs/architecture.md - 시스템 아키텍처 - 컴포넌트 상세 설명 - 데이터 플로우 ### docs/constraints.md - Key Constraints (기존 agents.md 내용 흡수 또는 링크) - 정책 및 제약사항 ### docs/testing.md - Test Structure - 테스트 작성 가이드 - Coverage 요구사항 ## 작업 범위 1. 새 문서 구조 생성 2. CLAUDE.md 내용 분산 이동 3. CLAUDE.md를 간결한 허브 문서로 재작성 4. 모든 문서 간 상호 링크 설정 5. agents.md와 중복 내용 통합/정리 ## 기대 효과 - 컨텍스트 크기 최소화 - 주제별 빠른 참조 - 문서 유지보수성 향상 - 필요한 정보만 선택적 로드
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
Something is not working
 duplicate
This issue or pull request already exists
 enhancement
New feature
 help wanted
Need some help
 invalid
Something is wrong
 question
More information is needed
 wontfix
This won't be fixed
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
agentson jihoson
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: jihoson/The-Ouroboros#13
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?