스킬 codebase-design

📦

codebase-design

Name: codebase-design
Author: mattpocock

콘텐츠 리비전 r2 안전 ⚙️ 외부 명령어

깊이 있는 코드 모듈 설계

대규모 코드베이스에는 넓은 인터페이스와 흩어진 동작을 가진 얕은 모듈이 쌓이는 경우가 많습니다. 이 skill은 Claude, Codex, Claude Code가 더 깊이 있는 모듈과 더 깔끔한 테스트를 설계하도록 돕습니다.

지원: Claude Codex Code(CC)

🥉 77 브론즈

Maintain this Skill? Claim it 🥉 77 브론즈

내 에이전트로 설치

이 요청을 에이전트에 복사하세요. 공식 Skill 페이지와 매니페스트가 포함되어 있습니다.

에이전트 요청

Review the Skillstore skill "codebase-design" from https://skillstore.io/skills/mattpocock-codebase-design.md and its manifest at https://skillstore.io/api/skills/mattpocock-codebase-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

에이전트는 계속해서 계획을 표시하고 보안 정책에서 요구하는 확인을 요청해야 합니다.

에이전트가 읽기 쉬운 리소스

AI 에이전트, 크롤러, 스크립트가 전체 페이지 대신 정리된 컨텍스트만 필요할 때 이 링크를 사용하세요.

Markdown 상세 GET /skills/mattpocock-codebase-design.md 서명된 manifest GET /api/skills/mattpocock-codebase-design/manifest 서명된 lockfile GET /api/skills/mattpocock-codebase-design/lockfile

테스트해 보기

"codebase-design" 사용 중입니다. 얇은 래퍼가 많은 결제 오케스트레이션 모듈을 검토합니다.

예상 결과:

응답은 얕은 래퍼를 식별하고, 하나의 더 깊이 있는 워크플로 인터페이스를 제안하며, 어떤 의존성이 어댑터가 되어야 하는지 설명합니다.

"codebase-design" 사용 중입니다. 리팩터링된 리포팅 모듈의 테스트를 설계합니다.

예상 결과:

응답은 리포팅 인터페이스에서의 테스트를 권장하고, 검증해야 할 관찰 가능한 결과를 나열합니다.

"codebase-design" 사용 중입니다. 검색 인덱싱 모듈의 인터페이스 옵션을 비교합니다.

예상 결과:

응답은 호출자 노력, 숨겨진 복잡성, seam 배치, 의존성 전략, 유지보수성을 비교합니다.

보안 감사

안전

v5 • 2026. 7. 23. 버전별 보고서 열기

All nine static findings are false positives. Eight findings identify Markdown code fences as shell execution, while the remaining finding identifies an illustrative TypeScript function as reconnaissance. No malicious intent, prompt injection, or executable command behavior was found.

스캔된 파일

198

분석된 줄 수

검토 항목

오탐 무시됨

위험 요인

⚙️ 외부 명령어 (8)

SKILL.md:34-42 SKILL.md:42-46 SKILL.md:46-52 SKILL.md:52-73 SKILL.md:73-81 SKILL.md:81-85 SKILL.md:85-93 SKILL.md:93-108

가장 최근에 완료된 정적·의미론적 감사에서 확인된 보안 발견 사항이 감지되지 않았습니다. 이는 스킬에 부작용이 없음을 증명하지 않습니다.

감사자: codex 감사 이력 보기 →

이 보고서 공유 및 인용

버전이 지정된 평가 보고서, 중립 배지, 임베드 카드 및 인용을 공유하세요. Skillstore는 근거를 보고하지만 이 Skill의 안전 여부를 판단하지 않습니다.

버전별 보고서 열기

보고서 링크 복사

https://skillstore.io/skills/mattpocock-codebase-design/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 배지

[![Skillstore security assessment](https://skillstore.io/badges/skills/mattpocock-codebase-design/security.svg)](https://skillstore.io/skills/mattpocock-codebase-design?utm_source=security_passport_badge)

HTML 배지

<a href="https://skillstore.io/skills/mattpocock-codebase-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/mattpocock-codebase-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

임베드 카드

<iframe src="https://skillstore.io/embed/skills/mattpocock-codebase-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

학술 인용 (APA · BibTeX · CFF)

APA 인용

mattpocock. (2026). codebase-design security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/mattpocock-codebase-design/audits/5

BibTeX 인용

@techreport{mattpocock-mattpocock-codebase-design-2026,
  author = {mattpocock},
  title = {codebase-design security audit report (audit version 5)},
  institution = {Skillstore},
  year = {2026},
  number = {5},
  url = {https://skillstore.io/skills/mattpocock-codebase-design/audits/5},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "codebase-design security audit report (audit version 5)"
version: "unspecified"
type: report
authors:
  - name: "mattpocock"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/mattpocock-codebase-design/audits/5"
identifiers:
  - type: other
    value: "skillstore:mattpocock-codebase-design:audit:5"
    description: "Skillstore immutable audit report identifier"

Skillstore 점수

이 점수의 이유 증거 신뢰도: 중간

아키텍처

유지보수성

콘텐츠

커뮤니티

사양 준수

만들 수 있는 것

얕은 모듈 리팩터링

단순 전달 코드를 찾아 호출자가 다루는 표면이 더 작은 깊이 있는 모듈로 재구성합니다.

테스트 가능한 인터페이스 계획

취약한 구현 세부 사항 대신 모듈 인터페이스의 안정적인 동작에 테스트를 맞춥니다.

아키텍처 옵션 비교

여러 인터페이스 설계를 생성하고 깊이, 지역성, 의존성, seam 배치를 비교합니다.

이 프롬프트를 사용해 보세요

얕은 모듈 찾기

codebase-design 어휘를 사용하여 이 모듈을 검토해 주세요. 이 모듈이 깊은지 얕은지 말하고, 호출자 부담을 설명해 주세요.

하나의 인터페이스 개선

이 모듈을 위한 더 작은 인터페이스를 설계해 주세요. 동일한 동작을 유지하고, 더 많은 구현 세부 사항을 숨기며, 새로운 seam을 설명해 주세요.

깊이를 높이는 리팩터링 계획

이 모듈의 의존성을 분류하고, 적절한 seam 전략을 선택한 뒤, 안전하게 깊이를 높이기 위한 단계적 계획을 제안해 주세요.

설계 대안 비교

Design It Twice 프로세스를 사용해 주세요. 세 가지 서로 다른 인터페이스를 만들고, 깊이와 지역성을 비교한 다음, 가장 강력한 설계를 추천해 주세요.

모범 사례

설계 지침을 요청하기 전에 구체적인 파일, 호출 지점, 테스트를 제공하세요.
seam을 선택하기 전에 의존성 분류를 요청하세요.
논의 전반에서 동일한 모듈, 인터페이스, seam, 어댑터 용어를 사용하세요.

피하기

어댑터가 하나뿐일 때는 seam을 추가하지 마세요.
테스트를 더 쉽게 만들기 위해 내부 seam을 노출하지 마세요.
구현 라인 수만으로 모듈 깊이를 판단하지 마세요.

자주 묻는 질문

이 skill은 무엇을 돕나요?

더 작은 인터페이스, 숨겨진 동작, 안정적인 seam 전반의 더 깔끔한 테스트를 갖춘 모듈 설계를 돕습니다.

코드를 자동으로 편집하나요?

아니요. 어시스턴트나 개발자가 적용할 수 있는 아키텍처 어휘와 설계 지침을 제공합니다.

깊이 있는 모듈이란 무엇인가요?

깊이 있는 모듈은 작은 인터페이스를 통해 호출자에게 명확한 규칙과 오류 모드가 있는 실질적인 동작을 제공합니다.

테스트를 어떻게 개선하나요?

공개 모듈 인터페이스를 통한 테스트를 장려하므로, 테스트가 비공개 구현 세부 사항 대신 동작을 설명합니다.

Design It Twice는 언제 사용해야 하나요?

중요한 인터페이스 결정을 내리기 전에 여러 다른 설계가 필요할 때 사용하세요.

어떤 프로젝트 맥락을 제공해야 하나요?

후보 모듈, 중요한 호출자, 의존성, 현재 테스트, 알려진 제약 조건을 제공하세요.

개발자 세부 정보

작성자

mattpocock

라이선스

MIT

Skillstore 리비전

버전 안내

작성자가 버전을 선언하지 않았습니다.

리포지토리

https://github.com/mattpocock/skills/tree/main/skills/engineering/codebase-design/

참조

ebdfe608f5de2b66ff37ab4af12af8ac4f5e8006

유지보수 최신성

2026. 7. 26.

사용량

6 다운로드 · 0 조회

파일 구조

📄 DEEPENING.md

📄 DESIGN-IT-TWICE.md

📄 SKILL.md