structure-first는 코드의 성공 흐름(Primary Flow) 을 먼저 읽히게 정리하는 스킬입니다.
경계는 필요한 만큼만 두고, 세부는 아래로 내리며, 테스트는 계약 중심으로 맞춥니다.
복잡한 변경에서도 변경 반경과 부수 효과를 줄이는 데 초점을 둡니다.
Spec: agentskills.io | License: MIT | Agents: Codex, Claude Code
선택 스킬인 structure-first-docs는 같은 철학을 설계 문서, 계획 문서, 런북 같은 엔지니어링 문서에 적용합니다.
설치
npx skills add perhapsspy/structure-first바로 사용
$structure-first 를 활용해서 기능을 구현해줘
- 상태 분기/조건이 많아 코드가 위에서 아래로 읽히지 않을 때
- AI가 수정할 때 사이드이펙트가 자주 발생할 때
- 리팩터링 후 테스트가 구현 세부에 끌려 자주 깨질 때
기본 경로는 structure-first부터 시작하고, companion skill은 필요할 때만 추가하는 방식입니다.
- skills.sh 빠른 설치:
npx skills add perhapsspy/structure-first - 로컬 설치:
skills/structure-first폴더를 에이전트 스킬 디렉터리에 복사
structure-first-review: 후기 작성/게시용 선택 스킬structure-first-docs: 같은 구조 철학을 문서 작성/리뷰에 적용하는 companion 스킬
# 구현할 때
$structure-first 를 활용해서 기능을 구현해줘
# 기존 코드 개선 할 때
$structure-first 관점으로 코드를 분석하고 개선 제안 해줘
# 같은 철학을 문서에 적용할 때
$structure-first-docs 관점으로 설계 문서를 작성/리뷰 해줘
# 재미용 후기 작성
$structure-first-review 로 후기 작성해
- Detailed skill rules: 한국어 | English
- Docs companion skill: 한국어 | English
- Dev story: 한국어 | English
- Background notes: 한국어 | English
