Skip to content

refactor(atelier): clarify skill/rule boundary and reorganize components#796

Merged
kys0213 merged 4 commits into
mainfrom
chore/normalize-skill-command-frontmatter
Jun 13, 2026
Merged

refactor(atelier): clarify skill/rule boundary and reorganize components#796
kys0213 merged 4 commits into
mainfrom
chore/normalize-skill-command-frontmatter

Conversation

@kys0213

@kys0213 kys0213 commented Jun 13, 2026 •
edited
Loading

Copy link
Copy Markdown
Owner

왜

  • atelier 가 6개 플러그인을 합치면서 `skill` 과 `rule` 의 경계가 흐려졌어요.
  • 같은 지식이 skill·rule·CLAUDE.md 에 중복으로 흩어지고, 진입점도 어떤 건 command 어떤 건 skill 로 제각각이었어요.
  • "skill 은 뭐고 rule 은 뭐냐"를 명확히 정의해서 앞으로 흔들리지 않게 하고 싶었어요.

무엇을

  • 경계 정의: skill = 코드·문서로 알 수 없는 암묵지·전문성, rule = 프로젝트 종속적이고 언젠가 사라질 컨벤션.
  • orchestrator: 직접 호출 + 자동 트리거가 둘 다 되는 entry-point skill 로 승격 (`user-invocable: false` 제거).
  • coding-style: skill 삭제. 코딩 원칙은 코드 쓸 때마다 항상 적용되는 컨벤션이라 `templates/claude-md`→CLAUDE.md(setup 주입)가 단일 출처예요. 기존 skill 은 빈 포인터였어요.
  • issue-label: autopilot 전용 라벨링 프로토콜이라 `skills/issue-label` → `skills/autopilot/references/issue-label.md` 로 이동 (git rename, history 보존).
  • agent-design-principles: skill 에 '경계 교리'와 '진입점 분류(Command vs user-invocable Skill)'를 추가하고, 배포/repo-dev rule 2개를 skill 참조 포인터로 다이어트(각 ~160줄 제거).
  • cross-ref(workflow·interview·autopilot references·README) 일괄 갱신.
  • (1st commit) skill/command frontmatter 일관성 정규화.

어떻게

  • 판단 기준 한 줄: "코드를 읽어서 나오는가?" → 나오면 rule, 안 나오는 전문성이면 skill.
  • 전문성이 컨벤션으로 굳을 때: 합치지 않고 두 층으로 — skill 이 '왜'의 단일 출처, rule 은 `paths` 로 강제하되 skill 을 참조만 하고 내용을 재서술하지 않아요. 교본 복붙 금지(따로 늙어서 어긋남).
  • 진입점: "모델이 자동 트리거해도 되나?"로 가름 — 곤란하면 Command(setup·autopilot), 알아서 꺼내써야 하면 user-invocable Skill(git·interview·spec·workflow·orchestrator).

확인 방법

  • `skills/` 에 coding-style·issue-label 디렉터리가 없고 8개 skill 만 남았는지
  • `skills/autopilot/references/issue-label.md` 가 frontmatter 없이 reference 형식인지
  • coding-style/issue-label 을 skill 로 지칭하는 잔여 참조가 없는지 (`grep`)
  • agent 가 선언한 skill 이 전부 존재하는지 — validate 의 skill-reference 통과
  • frozen plugin gate: 변경이 전부 `plugins/atelier/` + `.claude/rules/` 라 frozen 미저촉

🤖 Generated with Claude Code

김용성 and others added 2 commits June 13, 2026 14:14
@claude
docs(atelier): normalize skill/command frontmatter
fa69033 
Add required version field to 5 skills (agent-design-principles, autopilot, coding-style, git, spec-review) per plugin-skill.md.
Unify frontmatter field order to name -> description -> version -> user-invocable.
Remove unneeded name from commands/setup.md and add argument-hint per plugin-command.md.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
@claude
refactor(atelier): clarify skill/rule boundary and reorganize components
6fbb78a 
스킬/룰 경계를 '암묵지(skill) vs 프로젝트 컨벤션(rule)'으로 재정의하고 그에 맞게 컴포넌트를 재배치.

- orchestrator: user-invocable 로 승격 (자동 트리거 + 직접 호출 가능한 entry-point skill)
- coding-style: skill 삭제 — 지식은 항상 적용되는 컨벤션이라 templates/claude-md→CLAUDE.md(setup 주입)가 단일 출처. skill 은 빈 포인터였음
- issue-label: autopilot 전용 라벨링 프로토콜이라 skills/issue-label → skills/autopilot/references/issue-label.md 로 강등 이동 (history 보존)
- agent-design-principles: skill 에 'skill vs rule 경계'·'진입점(Command vs user-invocable Skill)' 교리 추가, 배포/repo-dev rule 2개를 skill 참조 포인터로 다이어트 (교본 중복 제거)
- cross-ref(workflow·interview·autopilot references·README) 일괄 갱신

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
@kys0213 kys0213 changed the title docs(atelier): normalize skill/command frontmatter refactor(atelier): clarify skill/rule boundary and reorganize components Jun 13, 2026
김용성 and others added 2 commits June 13, 2026 15:22
@claude
refactor(atelier): tighten rule pointers and fix stale skill labels
19c228a 
/simplify findings 적용:
- plugin.json description 에서 coding-style 제거 (더 이상 skill 아님)
- agent-design-principles skill §3.6 예시 spec → spec-write·spec-review
- 두 agent-design-principles rule 을 동사+cross-ref 만 남기게 슬림화 (§3.5 '왜' 재서술·§3.6 인라인 재유도 제거 — 포인터가 자기 원칙을 위반하던 부분)

Simplify findings (skipped): SKILL §3.5 litmus·❌ 콜아웃은 교본의 의도된 강조라 유지, §3 always-loaded 비용 재언급은 on-demand 라 사소하여 유지.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
@claude
refactor(atelier): fix stale manifest refs and doctrine taxonomy gap
56a2bf6 
/code-review findings 적용:
- marketplace.json atelier description: coding-style 제거 + workflow-guide→workflow (plugin.json 과 정합)
- autopilot SKILL references 테이블: issue-label 소비자 과장 수정 (gap-watch·qa-boost 는 GitHub 이슈 생성 안 함 → '이슈/PR 생성·라벨링 단계'로 일반화)
- agent-design-principles §3.6: on-demand 로드되는 Reference Skill 범주 추가 (agent-design-principles 자신을 분류 — 기존 user-invocable/Protocol 두 슬롯에 안 맞던 갭)
- agent-design-principles §3.5: rule 예시에서 '라벨 규칙' 제거 (issue-label 을 reference 로 둔 PR 행위와 충돌)
- README 슬래시 인벤토리: orchestrator(이번 승격)·interview 추가

Review findings (refuted): 배포 rule dangling siblings — simplify 커밋이 이미 sibling 참조 제거함. git 'ALWAYS'/on-demand — 도메인 게이트 트리거라 모순 아님.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
@kys0213 kys0213 merged commit 8f93124 into main Jun 13, 2026
1 check passed
@kys0213 kys0213 deleted the chore/normalize-skill-command-frontmatter branch June 13, 2026 06:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@kys0213