Step01 : 동작하는 OS 뼈대 #37
Open
Eundms wants to merge 9 commits into
Open
Conversation
반복 작업을 표준 절차로 굳혀 매번 방식을 고민하지 않도록 함. git-commit은 타입 접두사 없는 좋은 커밋 규칙을 따른다.
어떤 스킬을 얼마나 쓰는지 알아야 OS를 어디에 투자할지 판단할 수 있어, Skill 호출을 PreToolUse 훅으로 집계하고 skill-stat으로 조회한다. 런타임 통계 파일(skill-stats.json)은 개인 기록이라 .gitignore로 제외.
기존 코드를 고치기 전에 맥락을 먼저 파악하도록 강제하기 위함. 읽기 많은 조사·분석은 서브에이전트로 격리해 메인 컨텍스트 오염을 막고, 판단·작성 단계는 스킬로 둬 각 메커니즘의 용도에 맞췄다.
기능을 늘릴 때 "개발을 돕나, OS를 돌보나"로 자리를 정하고, 구성요소 작성 규칙(파일별 로딩 비용 기준)을 한곳에 모아 기준으로 삼기 위함.
컴포넌트마다 흩어지거나 auto-memory에만 있어 서브에이전트에 닿지 않던 지침을 레포 안으로 모아 단일 출처로 만들고, 성격에 맞는 로딩 층위에 배치했다. - 글쓰기 스타일: guides/writing-style.md 한 곳에 두고 CLAUDE.md·design-doc· 노트 생산 에이전트 4곳이 이름으로 참조. 격리된 서브에이전트에도 닿게 함. - 안전 가드레일: 선언은 CLAUDE.md, 강제는 hooks/guardrail.sh(PreToolUse)로 분리. force push·main 직접 push만 차단하고 오탐 큰 것은 선언으로만 둠. - 작업 방식: guides/work-principles.md(가급적 묻고 시킨 것만)를 CLAUDE.md에서 참조. 이미 규칙을 가진 code-writer에는 중복 주입하지 않음. OS.md에는 TDD 테스트 명령이 프로젝트 CLAUDE.md에서 와야 함을 명시했다.
리뷰 협업 관점의 원칙(작게·순서·의미)이 없어 커밋이 제각각이었다. 순서 쌓기와 의도 담긴 메시지를 규칙으로 넣고, 제목은 한국어 관행(명사형·짧게)에 맞추고 rebase는 가드레일과 연결했다.
결정이나 범위가 흐릿할 때 그때그때 즉흥으로 묻던 것을, 한 번에 하나씩·발산 후 수렴·의도 6축으로 캐는 interview 스킬로 표준화했다. 기술·구현 택1은 work-principles가, 유지보수의 범위 모호는 maintenance-mode가 이 스킬로 보낸다. investigate는 격리라 못 물으니 미해결 의문으로만 넘긴다.
설계 합의 후 곧장 구현하면 큰 변경에서 순서가 엉킨다. 설계를 순서 있는 단계로 쪼갠 계획(docs/plan/<티켓>.md)을 먼저 쓰고 code-writer가 한 단계씩 구현하게 했다. maintenance-mode가 계획 없이 구현으로 못 넘어가게 강제한다(비자명한 작업만). 겸해서 interview를 OS.md A-2 공통 스킬로 등록했다.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
구성
에이전트 4종 (.claude/agents/)
▎ code-writer·code-reviewer는 모드 중립 공유 에이전트 — 신규
스킬 5종 (.claude/skills/)
기반 (훅) (.claude/hooks/)
명세
파이프라인
maintenance-mode가 지휘하고, 각 단계 산출물이 다음 단계의 입력
① investigate → ② analyze → ③ design-doc(합의) → ④ code-writ → git-commit
조사(agent) 분석(agent) 설계문서(skill) TDD 구현(agent) QA 판정(agent) 커밋(skill)