Communitygithub.com

cdcoonce/Portfolio_Website

코드베이스를 탐색하여 아키텍처 개선 기회를 찾고, 특히 얕은 모듈을 깊게 만들어 테스트 용이성을 높입니다. 사용자가 아키텍처 개선, 리팩토링 기회 발굴, 결합도가 높은 모듈 통합, 또는 AI가 탐색하기 쉬운 코드베이스로 만들고자 할 때 사용하세요.

Portfolio_Website란 무엇인가요?

이 스킬은 코드베이스를 AI 에이전트가 탐색하듯 분석하여 아키텍처 마찰 지점을 발견하고, 테스트 가능성을 개선하며, 모듈을 더 깊게 리팩토링하는 GitHub Issue RFC를 제안합니다. '깊은 모듈'(John Ousterhout의 소프트웨어 설계 철학)은 작은 인터페이스 뒤에 큰 구현을 숨겨 테스트 용이성과 AI 탐색성을 높입니다. 이 스킬은 특히 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용하도록 설계되었습니다. 프로세스는 코드베이스 탐색, 후보 제시, 사용자 선택, 문제 공간 프레임, 다중 인터페이스 설계, 최종 인터페이스 선택, GitHub Issue 생성을 포함합니다. 사용자는 자신의 코드베이스에 맞춰 REFERENCE.md 파일을 참조하여 스킬을 구성하고 사용해야 합니다.

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

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

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

문서

코드베이스 아키텍처 개선하기

AI가 코드베이스를 탐색하듯 분석하여 아키텍처 마찰을 발견하고, 테스트 용이성을 개선할 기회를 찾으며, 모듈을 깊게 리팩토링하는 GitHub Issue RFC를 제안합니다.

깊은 모듈(John Ousterhout, "A Philosophy of Software Design")은 작은 인터페이스 뒤에 큰 구현을 숨깁니다. 깊은 모듈은 더 테스트하기 쉽고, AI가 탐색하기 쉬우며, 경계에서 테스트할 수 있게 해줍니다.

프로세스

1. 코드베이스 탐색

subagent_type=Explore를 사용하여 에이전트 도구로 자연스럽게 코드베이스를 탐색하세요. 엄격한 휴리스틱을 따르지 말고 유기적으로 탐색하며 마찰이 느껴지는 지점을 기록하세요:

  • 한 가지 개념을 이해하기 위해 여러 개의 작은 파일 사이를 왔다 갔다 해야 하는 곳은 어디인가요?
  • 인터페이스가 구현만큼 복잡해서 모듈이 너무 얕은 곳은 어디인가요?
  • 테스트 가능성만을 위해 순수 함수가 추출되었지만, 실제 버그는 함수 호출 방식에 숨어 있는 곳은 어디인가요?
  • 강하게 결합된 모듈이 그 경계에서 통합 위험을 만드는 곳은 어디인가요?
  • 코드베이스 중 테스트되지 않았거나 테스트하기 어려운 부분은 어디인가요?

여러분이 경험하는 마찰이 바로 신호입니다.

2. 후보 제시

깊게 만들 기회의 번호가 매겨진 목록을 제시하세요. 각 후보에 대해 다음 정보를 보여주세요:

  • 클러스터: 관련된 모듈/개념
  • 결합 이유: 공유된 타입, 호출 패턴, 개념의 공동 소유
  • 의존성 카테고리: 네 가지 카테고리는 REFERENCE.md를 참조하세요.
  • 테스트 영향: 경계 테스트로 대체될 기존 테스트들

아직 인터페이스를 제안하지 마세요. 사용자에게 물어보세요: "이 중에서 어떤 것을 탐색하시겠습니까?"

3. 사용자가 후보 선택

4. 문제 공간 프레임

하위 에이전트를 생성하기 전에, 선택된 후보에 대한 문제 공간을 사용자에게 설명하세요:

  • 새로운 인터페이스가 만족해야 하는 제약 조건들
  • 의존해야 하는 종속성들
  • 제약 조건을 구체적으로 보여주는 대략적인 예시 코드 스케치 - 제안이 아니라 제약 조건을 구체화하는 수단입니다.

이 내용을 사용자에게 보여준 후 즉시 5단계로 진행하세요. 사용자는 문제를 읽고 생각하는 동안 하위 에이전트가 병렬로 작업합니다.

5. 여러 인터페이스 설계

에이전트 도구를 사용하여 3개 이상의 하위 에이전트를 병렬로 생성하세요. 각 에이전트는 깊어진 모듈에 대해 근본적으로 다른 인터페이스를 생성해야 합니다.

각 하위 에이전트에 별도의 기술 브리핑(파일 경로, 결합 세부 사항, 의존성 카테고리, 숨겨지는 내용)을 프롬프트로 제공하세요. 이 브리핑은 4단계의 사용자 대상 설명과 독립적입니다. 각 에이전트에 다른 설계 제약을 부여하세요:

  • 에이전트 1: "인터페이스를 최소화하세요 - 최대 1-3개의 진입점을 목표로 하세요"
  • 에이전트 2: "유연성을 극대화하세요 - 많은 사용 사례와 확장을 지원하세요"
  • 에이전트 3: "가장 일반적인 호출자에 최적화하세요 - 기본 사례를 간단하게 만드세요"
  • 에이전트 4(해당되는 경우): "경계 간 의존성을 위해 포트 및 어댑터 패턴으로 설계하세요"

각 하위 에이전트는 다음을 출력합니다:

  1. 인터페이스 시그니처(타입, 메서드, 매개변수)
  2. 호출자가 어떻게 사용하는지 보여주는 사용 예시
  3. 내부적으로 숨기는 복잡성
  4. 의존성 전략(의존성 처리 방식 - REFERENCE.md 참조)
  5. 트레이드오프

설계를 순차적으로 제시한 후 산문으로 비교하세요.

비교 후에는 자신의 추천을 제시하세요: 어떤 설계가 가장 강력하고 그 이유는 무엇인지. 서로 다른 설계의 요소가 잘 결합될 수 있다면 하이브리드를 제안하세요. 의견을 분명히 하세요 - 사용자는 단순한 메뉴가 아닌 강력한 의견을 원합니다.

6. 사용자가 인터페이스 선택(또는 추천 수락)

7. GitHub Issue 생성

gh issue create를 사용하여 리팩토링 RFC를 GitHub Issue로 생성하세요. REFERENCE.md의 템플릿을 사용하세요. 생성 전에 사용자에게 검토를 요청하지 말고 그냥 생성하고 URL을 공유하세요.

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

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

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

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.

관련 스킬