Communitygithub.com

인터페이스 설계하기

병렬 하위 에이전트를 사용하여 모듈에 대해 근본적으로 다른 여러 인터페이스 디자인을 생성합니다. 사용자가 API를 설계하거나, 인터페이스 옵션을 탐색하거나, 모듈 형태를 비교하거나, "두 번 설계"를 언급할 때 사용합니다.

인터페이스 설계하기란 무엇인가요?

이 스킬은 소프트웨어 공학 분야의 저서 『소프트웨어 디자인 철학』에서 영감을 받은 '두 번 설계하기(Design It Twice)' 원칙을 구현한 것입니다. 사용자가 단일 인터페이스를 제시하는 대신, 3개 이상의 하위 에이전트를 동시에 실행하여 각각 완전히 다른 접근 방식의 인터페이스 디자인을 생성합니다. 각 에이전트는 '메서드 수 최소화', '유연성 극대화', '일반 사용 사례에 최적화' 등 서로 다른 제약 조건을 부여받아 진정한 다양성을 보장합니다. 이 스킬은 Claude Code, Cursor, Codex 등 병렬 작업 실행이 가능한 모든 AI 에이전트 플랫폼에서 사용할 수 있습니다. 최종 목표는 생성된 디자인들을 체계적으로 비교 평가하고, 각각의 장점을 종합하여 최적의 인터페이스를 도출하는 것입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cdcoonce/Portfolio_Website/tree/HEAD/.claude/skills/design-an-interface

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

인터페이스 설계하기은(는) 무엇을 하나요?

『소프트웨어 디자인 철학』의 "두 번 설계하기"에 기반합니다. 첫 번째 아이디어가 최선일 가능성은 낮습니다. 근본적으로 다른 여러 디자인을 생성한 후 비교하세요.

워크플로

1. 요구 사항 수집

설계하기 전에 다음을 이해하세요.

  • 이 모듈은 어떤 문제를 해결하나요?
  • 호출자는 누구인가요? (다른 모듈, 외부 사용자, 테스트)
  • 핵심 작업은 무엇인가요?
  • 제약 조건이 있나요? (성능, 호환성, 기존 패턴)
  • 내부에 숨겨야 할 것과 외부에 노출해야 할 것은 무엇인가요?

질문: "이 모듈이 수행해야 할 작업은 무엇이며, 누가 사용할 것인가?"

2. 디자인 생성 (병렬 하위 에이전트)

작업 도구를 사용하여 3개 이상의 하위 에이전트를 동시에 생성하세요. 각 에이전트는 근본적으로 다른 접근 방식을 제시해야 합니다.

각 하위 에이전트를 위한 프롬프트 템플릿:

인터페이스 설계 대상: [모듈 설명]

요구 사항: [수집된 요구 사항]

이 설계의 제약 조건: [각 에이전트에 다른 제약 조건 할당]
- 에이전트 1: "메서드 수를 최소화하세요 - 최대 1~3개의 메서드를 목표로 함"
- 에이전트 2: "유연성을 극대화하세요 - 다양한 사용 사례를 지원"
- 에이전트 3: "가장 일반적인 사용 사례에 최적화하세요"
- 에이전트 4: "[특정 패러다임/라이브러리]에서 영감을 얻으세요"

출력 형식:
1. 인터페이스 시그니처 (타입/메서드)
2. 사용 예제 (호출자가 사용하는 방식)
3. 이 설계가 내부에 숨기는 것
4. 이 접근 방식의 트레이드오프

3. 디자인 제시

각 디자인을 다음 정보와 함께 보여주세요.

  1. 인터페이스 시그니처 - 타입, 메서드, 매개변수
  2. 사용 예제 - 호출자가 실제로 사용하는 방법
  3. 내부에 숨기는 것 - 내부에서 관리되는 복잡성

사용자가 각 접근 방식을 비교하기 전에 충분히 이해할 수 있도록 디자인을 순차적으로 제시하세요.

4. 디자인 비교

모든 디자인을 보여준 후 다음 기준으로 비교하세요.

  • 인터페이스 단순성: 더 적은 메서드, 더 간단한 매개변수
  • 범용성 vs 특수성: 유연성 대 집중성
  • 구현 효율성: 설계 형태가 효율적인 내부 구현을 허용하는가?
  • 깊이: 적은 인터페이스로 상당한 복잡성을 숨기는 것(좋음) 대 큰 인터페이스에 얇은 구현(나쁨)
  • 올바른 사용 용이성 vs 잘못된 사용 용이성

표 대신 문단 형태로 트레이드오프를 논의하세요. 디자인 간 차이가 가장 큰 부분을 강조하세요.

5. 종합

최상의 디자인은 종종 여러 옵션의 통찰을 결합한 것입니다. 다음 질문을 해보세요.

  • "어떤 디자인이 주요 사용 사례에 가장 적합한가요?"
  • "다른 디자인에서 통합할 만한 요소가 있나요?"

평가 기준

『소프트웨어 디자인 철학』에서 발췌:

인터페이스 단순성: 더 적은 메서드, 더 간단한 매개변수 = 배우고 올바르게 사용하기 쉬움.

범용성: 변경 없이 미래의 사용 사례를 처리할 수 있어야 함. 그러나 지나친 일반화를 경계하세요.

구현 효율성: 인터페이스 형태가 효율적인 구현을 가능하게 하는가? 아니면 어색한 내부 구조를 강제하는가?

깊이: 작은 인터페이스로 상당한 복잡성을 숨기는 것 = 깊은 모듈(좋음). 큰 인터페이스에 얇은 구현 = 얕은 모듈(피해야 함).

안티 패턴

  • 하위 에이전트가 유사한 디자인을 생성하도록 두지 마세요. 근본적인 차이를 강제해야 합니다.
  • 비교를 건너뛰지 마세요. 가치는 대조에서 나옵니다.
  • 구현하지 마세요. 이는 순전히 인터페이스 형태에 대한 것입니다.
  • 구현 노력을 기준으로 평가하지 마세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cdcoonce/Portfolio_Website

Git commit workflow with enforced conventional commit style. Use when Claude needs to stage and commit changes, craft commit messages, or the user asks to commit, make a commit, or save their work. Ensures consistent commit message format, proper scoping, and atomic commits across the project.

cdcoonce/Portfolio_Website

AI-powered code quality analysis for Python, Markdown, and Mermaid diagrams. Use this skill when: (1) reviewing code for quality issues, (2) checking Python files for PEP8 violations, unused code, missing type hints, docstring problems, complexity issues, or potential runtime errors, (3) validating Markdown documentation for broken links, heading structure, or formatting issues, (4) validating Mermaid diagram syntax, (5) the user asks for a "code review" or "quality check", (6) analyzing code snippets pasted in conversation, or (7) suggesting and applying fixes for code quality issues.

cdcoonce/Portfolio_Website

Deploy the portfolio chat agent Lambda function to AWS. Use when the user asks to deploy, redeploy, push to Lambda, update the chat agent, or after updating context files or lambda_function.py. Rebuilds the knowledge base, packages dependencies, and deploys to AWS Lambda.

cdcoonce/Portfolio_Website

Orchestrate the full GitHub-issues-driven development lifecycle. 7-phase pipeline from brainstorm through PR with state tracking and cross-conversation resume. Use when user says "dev cycle", "development workflow", "full development pipeline", or invokes /dev-cycle.

cdcoonce/Portfolio_Website

Production Python coding standards with automatic version detection (3.10-3.13). Use when writing, reviewing, or refactoring Python to ensure adherence to modern type syntax, LBYL exception handling, pathlib operations, ABC-based interfaces, and production-tested patterns. Not Dagster-specific - applies to any Python project.

cdcoonce/Portfolio_Website

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

cdcoonce/Portfolio_Website

GitHub CLI (gh) integration for managing issues, pull requests, branches,

cdcoonce/Portfolio_Website

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

cdcoonce/Portfolio_Website

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

cdcoonce/Portfolio_Website

CEO/founder-mode plan review. Rethink the problem, find the 10-star product, challenge premises, expand scope when it creates a better product. Three modes: SCOPE EXPANSION (dream big), HOLD SCOPE (maximum rigor), SCOPE REDUCTION (strip to essentials). Use when the user asks for a plan review, CEO review, mega review, or wants a plan challenged/stress-tested before implementation.

cdcoonce/Portfolio_Website

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

cdcoonce/Portfolio_Website

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved as a local Markdown file in docs/plans/. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions "tracer bullets".

cdcoonce/Portfolio_Website

Generate or update the `.claude/docs/project.md` file that gives Claude project-specific context. Use this skill when the user asks to create, update, regenerate, or refresh project context, or says things like "update project.md", "generate project context", "this repo needs a project.md", or "Claude doesn't know about this project". Also trigger when onboarding Claude to a new repository for the first time.

cdcoonce/Portfolio_Website

Generate comprehensive, high-quality README.md files for code repositories. Use this skill whenever the user asks to create, write, generate, update, or improve a README for any project or repository. Also trigger when the user says things like "document this project", "write docs for this repo", "this repo needs a README", "help me onboard developers to this codebase", or asks for project documentation in markdown. Even if the user just says "README" or "readme" in the context of a codebase, use this skill.

cdcoonce/Portfolio_Website

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

cdcoonce/Portfolio_Website

Set up pre-commit hooks for the current repo. Use when user wants to add pre-commit hooks, configure commit-time linting, formatting, type checking, or testing. Triggers on "pre-commit", "git hooks", "linting hooks", or /setup-pre-commit.

cdcoonce/Portfolio_Website

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

cdcoonce/Portfolio_Website

Triage a bug or issue by exploring the codebase to find root cause, then create a GitHub issue with a TDD-based fix plan. Use when user reports a bug, wants to file an issue, mentions "triage", or wants to investigate and plan a fix for a problem.

cdcoonce/Portfolio_Website

Rewrites the prose sections of wiki pages in-place. Reads source files to understand current context, then updates only the content inside <!-- claude:prose --> ... <!-- claude:prose:end --> markers. Never touches <!-- generated:start --> ... <!-- generated:end --> blocks. Supports targeting a single page with /update-wiki {PageName}.

cdcoonce/Portfolio_Website

Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.

관련 스킬