Communitygithub.com

프로젝트 컨텍스트 생성기

Claude가 대화마다 사용할 프로젝트별 컨텍스트 파일(`.claude/docs/project.md`)을 생성하거나 업데이트합니다. 사용자가 프로젝트 컨텍스트 생성, 업데이트, 재생성 또는 새로고침을 요청하거나, 'project.md 업데이트', '프로젝트 컨텍스트 생성', '이 리포지토리에 project.md가 필요해요', 'Claude가 이 프로젝트에 대해 몰라요'와 같은 말을 할 때 이 스킬을 사용하세요.

프로젝트 컨텍스트 생성기란 무엇인가요?

이 스킬은 Claude가 대화마다 자동으로 로드하는 프로젝트 컨텍스트 파일(`.claude/docs/project.md`)을 생성하거나 업데이트합니다. README가 사람을 위해 작성된 반면, `project.md`는 Claude를 위해 설계된 밀도 있고 사실적인 참조 파일입니다. 이 파일이 없거나 오래되면 Claude는 기술 스택, 테스트 명령어, 아키텍처를 매번 새로 파악해야 하므로 비효율적입니다. 이 스킬은 코드베이스를 3단계(프로젝트 메타데이터, 아키텍처 스캔, 데이터 소스 및 인프라)로 분석하고, 불확실한 항목에 대해 사용자에게 명확히 질문한 후, 정해진 출력 구조에 따라 `project.md`를 생성합니다. 생성 후에는 `CLAUDE.md`에서 이 파일을 참조하도록 제안합니다. 이 스킬은 Claude Code를 포함한 모든 Claude 기반 에이전트에서 사용 가능하며, 이미 `project.md`가 존재하는 경우 덮어쓰기 전에 사용자 확인을 받습니다.

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

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

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

문서

프로젝트 컨텍스트 생성기은(는) 무엇을 하나요?

.claude/docs/project.md 파일을 생성하거나 업데이트합니다. 이 파일은 Claude가 매 대화마다 로드하는 간결한 프로젝트 참조 파일입니다. 사람을 위해 작성된 README와 달리, project.md는 Claude를 위해 작성됩니다: 밀도 있고, 사실적이며, 마케팅 문구가 없습니다.

이 스킬이 필요한 이유

.claude/docs/project.md는 CLAUDE.md를 통해 모든 Claude 대화에 자동으로 로드됩니다. 이 파일이 없거나 오래되면 Claude는 기술 스택, 테스트 명령어, 아키텍처를 다시 파악하는 데 많은 시간을 낭비합니다. 이 스킬은 이러한 자동 발견 과정을 자동화하고 간결하고 정확한 참조 파일을 생성합니다.

워크플로우

1단계: 코드베이스 분석

구조화된 3단계 분석을 실행하여 프로젝트 사실을 수집합니다. 모든 사실에 신뢰도 수준을 태그하세요: [confirmed] (소스에서 직접 읽음), [inferred-high] (강력한 증거), [inferred-low] (부분적 증거), [unknown].

자세한 도구 동작, glob/grep 패턴, 레코드 템플릿은 references/analysis-methodology.md를 참조하세요.

1단계 — 프로젝트 메타데이터: 패키지 관리자 파일, 환경 템플릿, CI 설정, 툴체인 파일을 찾기 위해 glob을 사용합니다. 추출할 항목: 프로젝트 이름, 언어, Python 버전, 의존성 (용도 포함), 스크립트/명령어, 환경 변수, CI 단계, 테스트 마커.

2단계 — 아키텍처 스캔: 모든 소스 파일을 검색합니다. 진입점 식별, 임포트 그래프 작성, 모듈 분류 (코어/리프/오케스트레이터), 아키텍처 패턴 식별. 소스 코드에서 참조하는 설정 파일을 읽습니다.

3단계 — 데이터 소스 및 인프라: 외부 데이터 소스 (데이터베이스, API, 파일), 출력 대상 (파일, 업로드, API), 테스트 구조, 사용자 정의 예외 계층 구조를 식별합니다.

2단계: 명확한 질문

분석 후, [inferred-low] 및 [unknown] 항목에 대해 사용자에게 질문합니다. 집중하세요 — 이미 알고 있는 것에 대해 묻지 마세요. 일반적인 공백:

  • 프로젝트 목적: 이 프로젝트는 어떤 문제를 해결하나요? (코드에서 명확하지 않은 경우)
  • 데이터 소스: 어떤 시스템이 데이터를 제공하나요? 출력은 어디로 가나요?
  • 배포: 이 프로젝트는 어떻게/어디서 실행되나요? (로컬, 예약, 클라우드)

코드베이스가 간단하다면 질문이 1-2개 또는 전혀 없을 수도 있습니다.

3단계: project.md 생성

아래 구조를 사용하여 파일을 작성합니다. .claude/docs/project.md가 이미 존재하는 경우, 덮어쓰기 전에 사용자에게 확인하세요.


출력 구조

생성된 project.md는 다음 구조를 따라야 합니다. 프로젝트 규모에 맞게 깊이를 조정하세요 — 작은 프로젝트는 섹션을 생략할 수 있고, 복잡한 프로젝트는 하위 섹션을 추가할 수 있습니다.

# {프로젝트 이름} — 프로젝트 컨텍스트

{한 줄 설명: 무엇인지, 무엇을 하는지, 핵심 기술.}

## 기술 스택

- **{언어/런타임}** — {버전 제약 조건 (알고 있다면)}
- **{프레임워크}** — {용도}
- **{핵심 라이브러리}** — {목적}
- ...글머리 기호 목록, 도구 이름은 굵게, 용도는 주석 처리

## 프로젝트 레이아웃

```text
{주석이 포함된 디렉터리 트리 — 항목당 하나의 짧은 구문}

데이터 흐름

{소스 → 변환 → 출력 파이프라인을 보여주는 ASCII 다이어그램}

데이터 소스

  • {SOURCE_NAME} — {제공하는 것}
  • ...데이터베이스, API, 로컬 파일 등

테스트 마커

  • {테스트 명령어} — {실행하는 것}
  • {마커 이름} — {게이트하는 것}

주요 아키텍처 패턴

  • {패턴 이름} ({파일}): {한 문장 설명}
  • ...강조할 가치가 있는 비자명한 패턴만

작성 지침

  • 밀도 있게, 장황하지 않게. 모든 줄이 자리를 차지해야 합니다. Claude는 동기 부여나 맥락 설정이 필요하지 않습니다 — 사실만 필요합니다.
  • 구체적으로, 일반적으로 하지 않게. "uv run pytest -m 'not snowflake' 실행"이 "외부 의존성을 제외한 테스트 실행"보다 낫습니다.
  • 패턴당 한 문장. 아키텍처 패턴은 각각 한 줄로 — 이름, 파일, 설명.
  • 실제 명령어. 테스트 명령어는 pyproject.toml이나 CI 설정에서 복사하고, 의역하지 마세요.
  • 의존성에 주석을 답니다. polars만 나열하지 말고 polars — 고성능 DataFrame이라고 씁니다.
  • 데이터 소스는 중요합니다. Claude는 어떤 외부 시스템이 있는지 알아야 합니다. 모든 데이터베이스, API, 파일 소스를 나열하세요.
  • 100줄 미만으로 유지하세요. project.md가 약 100줄을 넘으면 너무 자세한 것입니다 — 세부 사항은 전용 문서로 옮기고 링크를 겁니다.

출력

파일을 .claude/docs/project.md로 저장합니다 (필요하면 디렉터리를 생성합니다). 파일이 이미 존재하는 경우, 덮어쓰기 전에 사용자에게 diff 요약을 보여줍니다.

project.md를 생성한 후, CLAUDE.md가 이를 참조하는지 확인하세요. 참조하지 않는 경우, 다음과 같은 줄을 추가할 것을 제안하세요:

프로젝트 세부 사항 (기술 스택, 아키텍처, 테스트 마커)은 [.claude/docs/project.md](.claude/docs/project.md)를 참조하세요.

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

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 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.

관련 스킬