Community라이팅 & 에디팅github.com

do fastted/AgentDock

프로젝트별 코딩 가이드라인을 시작 전에 탐색하고 적용합니다. .trellis/spec/에서 사양 인덱스, 개발 전 체크리스트, 공유 생각 가이드를 읽습니다. 새 코딩 작업을 시작할 때, 코드를 작성하기 전에, 다른 패키지로 전환할 때, 또는 프로젝트 규칙과 표준을 새로고침해야 할 때 사용하세요.

AgentDock란 무엇인가요?

AgentDock은 개발자가 코드를 작성하기 전에 프로젝트별 코딩 가이드라인과 표준을 자동으로 탐색하고 주입하는 AI 에이전트 스킬입니다. 특히 .trellis/spec/ 디렉토리 구조를 기반으로 사양 인덱스, 개발 전 체크리스트, 공유 생각 가이드를 읽어 개발자가 프로젝트 규칙을 따르도록 돕습니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트에서 실행되며, 새 작업을 시작할 때나 다른 패키지로 전환할 때 필수적으로 적용됩니다. 핵심 동작은 현재 작업과 관련된 패키지와 레이어를 식별하고, 해당 사양 파일을 순차적으로 읽은 후, 비자명한 변경의 경우 변경 경계를 문서화하도록 요구함으로써 코드 품질과 일관성을 유지합니다. 개발자는 이 스킬을 통해 프로젝트 표준 위반을 피하고, 더 나은 코드 리뷰 경험과 유지보수성을 얻을 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dofastted/AgentDock/tree/HEAD/.claude/skills/trellis-before-dev

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

작업을 시작하기 전에 관련 개발 가이드라인을 읽으세요.

다음 단계를 실행하세요:

  1. 현재 작업 아티팩트 읽기:

    • prd.md: 요구사항 및 승인 기준
    • design.md (있는 경우): 기술 설계
    • implement.md (있는 경우): 실행 순서 및 검증 계획
  2. 패키지 및 해당 사양 레이어 탐색:

    python3 ./.trellis/scripts/get_context.py --mode packages
    
  3. 작업에 적용되는 사양 식별:

    • 수정 중인 패키지 (예: cli/, docs-site/)
    • 작업 유형 (백엔드, 프론트엔드, 유닛 테스트, 문서 등)
    • 작업 아티팩트에서 참조하는 사양/연구 경로
  4. 관련 모듈의 사양 인덱스 읽기:

    cat .trellis/spec/<package>/<layer>/index.md
    

    인덱스의 "개발 전 체크리스트" 섹션을 따르세요.

  5. 개발 전 체크리스트에 나열된 관련 특정 가이드라인 파일 읽기. 인덱스 자체가 목표가 아니라 실제 가이드라인 파일(예: error-handling.md, conventions.md, mock-strategies.md)을 가리킵니다. 코딩 표준과 패턴을 이해하기 위해 해당 파일을 읽으세요.

  6. 항상 공유 가이드 읽기:

    cat .trellis/spec/guides/index.md
    
  7. 비자명한 작업의 경우 코드를 작성하기 전에 변경 경계를 명시하세요. 비자명하다는 것은 둘 이상의 파일을 건드리거나, 레이어를 넘거나, 공개 인터페이스를 변경하거나, 방금 작성하지 않은 코드를 수정하는 것을 의미합니다. 다음을 기록하세요:

    • 현재 동작과 예상 동작 사이의 가장 작은 동작 차이
    • 해당 동작이 실제로 존재하는 위치 (가장 쉽게 가로챌 수 있는 위치가 아님)
    • 변경할 것으로 예상되는 파일과 각 파일이 필요한 이유
    • 이 작업에서 명시적으로 수행하지 않는 작업
    • 로컬 리팩터링이 필요한 경우, 동작을 변경하지 않았음을 어떻게 입증할지

    작고 범위가 명확한 변경은 이 단계가 필요하지 않습니다. 바로 수행하세요.

    실제 범위가 명백히 이보다 더 크다면, 계속 진행하기 전에 그 이유와 함께 말씀해 주세요. 스스로 변경 범위를 넓히지 마세요.

  8. 따라야 할 코딩 표준과 패턴을 이해한 후 개발 계획을 진행하세요.

이 단계는 코드를 작성하기 전에 필수입니다.

Individual skills in this repo

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

관련 스킬