Kiroignore¶

.kiroignore 파일은 Kiro가 작업 공간의 특정 파일을 읽지 못하도록 방지합니다. 친숙한 gitignore 구문을 사용하여 비공개로 유지해야 하는 파일(자격 증명, 비밀 또는 에이전트 컨텍스트에서 제외하려는 콘텐츠)에 대한 패턴을 정의합니다.

.kiroignore를 사용하는 이유는 무엇인가요?¶

보안 - Kiro가 자격 증명, API 키 또는 기타 민감한 데이터가 포함된 파일에 액세스하지 못하도록 방지합니다
프라이버시 - AI 상호 작용에서 기밀 정보를 제외합니다
규정 준수 - Kiro가 외부 서비스와 공유해서는 안 되는 파일에 액세스하지 않도록 보장합니다
집중 - 대용량 파일이나 빌드 아티팩트를 제외하여 Kiro의 컨텍스트를 관련성 있게 유지합니다

작업 공간 ignore 설정¶

특정 프로젝트에서 파일을 제외하려면:

프로젝트 루트(또는 하위 디렉터리)에 .kiroignore 파일을 만듭니다
제외하려는 파일에 대한 패턴을 추가합니다:

bash

# Secrets and credentials .env .env.* !.env.example *.pem *.key # Private directories secrets/ private/

설정을 엽니다(Mac에서는 Cmd+,, Windows/Linux에서는 Ctrl+,)
Agent Ignore Files를 검색합니다(설정: kiroAgent.agentIgnoreFiles)
배열에 .kiroignore를 추가합니다

이제 Kiro는 패턴과 일치하는 모든 파일을 건너뜁니다.

팁

자격 증명과 비밀부터 시작하세요. 이것들이 보호해야 할 가장 우선순위가 높은 파일입니다. 프로젝트가 발전함에 따라 언제든지 패턴을 확장할 수 있습니다.

설정 옵션¶

kiroAgent.agentIgnoreFiles 설정은 파일 이름 배열을 허용합니다:

여러 ignore 파일 유형을 동시에 사용: [".gitignore", ".kiroignore"]
작업 공간 수준 ignore 파일을 비활성화하려면 []로 설정

하위 디렉터리 ignore 파일¶

.gitignore와 마찬가지로 하위 디렉터리에 .kiroignore 파일을 배치하여 상위 디렉터리의 패턴을 재정의하거나 확장할 수 있습니다. 하위 디렉터리 ignore 파일의 패턴은 해당 하위 디렉터리 내의 파일에 대해 우선합니다.

전역 ignore 파일¶

Kiro는 전역 ignore 파일이 있는 경우 자동으로 존중합니다. 구성이 필요 없습니다:

~/.kiro/settings/kiroignore - 전역 Kiro ignore 패턴
Git의 전역 ignore 파일(git 구성의 core.excludesfile을 통해 구성) - git 저장소에만 적용됩니다

모든 프로젝트에 적용하려는 패턴에는 전역 ignore 파일을 사용합니다.

패턴 구문¶

.kiroignore는 표준 gitignore 구문을 사용합니다:

패턴	효과
`file.txt`	특정 파일 무시
`*.log`	확장자별로 무시
`folder/`	디렉터리 무시
`**/temp`	모든 하위 디렉터리에서 무시
`!keep.txt`	무시하지 않음 (부정)

정보

상위 디렉터리가 제외된 경우 파일을 다시 포함할 수 없습니다. 예를 들어 secrets/를 무시하면 !secrets/public.txt를 추가해도 작동하지 않습니다. 디렉터리에서 특정 파일을 포함하려면 전체 디렉터리를 제외하는 대신 더 구체적인 패턴을 사용합니다.

예시¶

API 키 및 비밀 보호¶

bash

# Environment files with credentials .env .env.local .env.production # Keep the template accessible !.env.example # Certificate and key files *.pem *.key *.p12 credentials/

빌드 아티팩트 및 데이터 파일 제외¶

bash

# Build outputs dist/ build/ .next/ # Data files *.sql *.dump data/exports/

팀 규정 준수 설정¶

bash

# Customer data directories customer-data/ pii/ # Audit and compliance docs compliance/internal/ audit-reports/

정보

버전 컨트롤과 에이전트 액세스에 대한 다른 규칙이 필요하거나 git에서 추적되지만 Kiro가 읽어서는 안 되는 파일을 차단해야 할 때 .kiroignore를 사용합니다.

모범 사례¶

파일이 무시되는 이유를 문서화하기 위해 주석을 사용합니다. 팀 구성원에게 도움이 됩니다
무시된 파일을 읽도록 Kiro에 요청하여 패턴을 테스트합니다. 액세스가 차단되었음을 나타냅니다
프로젝트 구조가 발전함에 따라 주기적으로 패턴을 검토합니다
작업 공간 간에 일관된 동작을 위해 팀과 전역 패턴을 조정합니다