docs: OpenSpec agent skill을 이관합니다#1013
Merged
Merged
Conversation
OpenSpec authoring, maintenance, task execution 지침을 querypie-docs의 agent skill 체계에 맞춰 이관합니다. Skill root를 .agents/skills로 정렬하고 .claude는 호환 symlink로 유지합니다. Constraint: repository skill 본문과 내부 지침은 한국어로 작성해야 합니다 Rejected: .claude/skills를 canonical skill root로 유지 | 사용자가 .agents/skills로 디렉토리 이름 변경을 요청했습니다 Confidence: high Scope-risk: narrow Directive: 새 repository-local skill은 .agents/skills에 추가하고 .claude는 호환 symlink로만 취급합니다 Tested: git diff --cached --check; readlink .claude; test -f .agents/skills/openspec-authoring.md; rg로 corp-web-app 및 .claude/skills 잔여 참조 확인 Not-tested: OpenSpec scaffold 생성과 실제 OpenSpec task 실행은 이번 변경 범위가 아닙니다
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Repo-local skill을 .agents/skills/<skill-name>/SKILL.md layout으로 옮겨 후속 skill 확장과 부가 자료 배치를 일관되게 만듭니다. README, AGENTS, docs 및 skill 간 상대 링크를 새 구조에 맞춰 정리합니다. Constraint: PR #1013 범위 안에서 skill 이관 구조만 조정해야 합니다 Rejected: .agents/skills/<name>.md flat layout 유지 | 사용자가 skill별 디렉터리 구조를 요청했습니다 Confidence: high Scope-risk: narrow Directive: 새 repo-local skill은 .agents/skills/<skill-name>/SKILL.md로 추가합니다 Tested: git diff --cached --check; find .agents/skills -maxdepth 1 -type f -name '*.md'; find .agents/skills -mindepth 2 -maxdepth 2 -type f -name SKILL.md; rg로 old flat skill path, .claude/skills, corp-web-app 잔여 참조 확인 Not-tested: production build; 문서와 skill 경로만 변경했습니다
기존 CLAUDE.md의 실질 repository 지침을 AGENTS.md로 옮기고, CLAUDE.md는 AGENTS.md를 참조하는 Claude Code 호환 wrapper로 축소합니다. Constraint: CLAUDE.md는 thin wrapper로 남겨야 합니다 Rejected: AGENTS.md와 CLAUDE.md에 동일 지침을 중복 유지 | guidance drift를 만들 수 있습니다 Confidence: high Scope-risk: narrow Directive: repository agent 지침의 canonical source는 AGENTS.md입니다 Tested: git diff --check; AGENTS.md에서 content-structure, Skeleton 비교, commit guide 지침 확인; CLAUDE.md wrapper 확인 Not-tested: production build; guidance 문서만 변경했습니다
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.
Summary
OpenSpec 기반 작업을 querypie-docs에서도 일관되게 수행할 수 있도록 repo-local agent skill 체계를 정리합니다.
.claude/skills를.agents/skills로 이동하고.claude는.agentssymlink로 유지합니다..agents/skills/<skill-name>/SKILL.md구조로 정리합니다.AGENTS.md를 canonical repository guidance로 정리하고, 기존CLAUDE.md의 실질 지침을 AGENTS로 옮깁니다.CLAUDE.md는AGENTS.md를 참조하는 Claude Code 호환 thin wrapper로 남깁니다.docs/README.md,.agents/skills/README.md의 skill 경로와 목록을 새 구조에 맞게 갱신합니다..agents/settings.local.json이 실수로 커밋되지 않도록 ignore 규칙을 추가합니다.Test plan
git diff --checkreadlink .claude로.claude -> .agentssymlink 확인find .agents/skills -maxdepth 1 -type f -name "*.md"로 root markdown은README.md만 남은 것 확인find .agents/skills -mindepth 2 -maxdepth 2 -type f -name SKILL.md로 skill별SKILL.md16개 확인rg로corp-web-app,.claude/skills, 오래된 flat skill path 잔여 참조 확인AGENTS.md에 기존CLAUDE.md의 content-structure, Skeleton 비교, commit guide 지침이 들어간 것 확인CLAUDE.md가AGENTS.mdthin wrapper로 축소된 것 확인Notes
🤖 Generated with Codex