Harness Engineering

{
  "agentSettings": {
    "coreTools": {
      "terminalTool": {
        "terminalExecutionMode": "REQUEST_REVIEW"
      },
      "readFileTool": {
        "allowedPaths": ["./src", "./tests", "./docs"]
      },
      "writeFileTool": {
        "allowedPaths": ["./src", "./tests"]
      },
      "browserTool": {
        "allowedDomains": ["docs.python.org", "github.com", "stackoverflow.com"]
      }
    },
    "mcpServers": {
      "github": {
        "httpUrl": "https://api.githubcopilot.com/mcp/",
        "headers": { "Authorization": "Bearer ${GITHUB_TOKEN}" }
      }
    },
    "hooks": {
      "postTurn": [
        { "command": "git add -A && git status" }
      ]
    }
  }
}

"browserTool": {
  "allowedDomains": [
    "docs.python.org",
    "developer.mozilla.org",
    "github.com",
    "stackoverflow.com",
    "pypi.org"
  ]
}

"agentSettings": {
  "sandboxMode": true,
  "workspaceRoot": "./my-project"
}

{
  "permissions": {
    "allow": [
      "Read(**/*.md)",
      "Edit(**/*.py)",
      "Write(**/*.json)",
      "Bash(git diff:*)"
    ],
    "deny": [
      "Read(**/.env)",
      "Edit(**/secrets/**)"
    ]
  }
}

{
  "agentSettings": {
    "hooks": {
      "preTurn": [
        {
          "command": "echo '=== Current Git Status ===' && git status --short",
          "description": "대화 시작 시 현재 git 상태를 에이전트에게 제공"
        }
      ],
      "postTurn": [
        {
          "command": "black . --check --quiet || black .",
          "description": "Python 코드 자동 포맷팅 (black)"
        },
        {
          "command": "flake8 src/ --max-line-length=88 --statistics",
          "description": "린트 검사 실행"
        },
        {
          "command": "git add -A && git status",
          "description": "변경 사항 스테이징 및 상태 확인"
        }
      ]
    }
  }
}

{
  "agentSettings": {
    "hooks": {
      "preTurn": [
        {
          "command": "node --version && npm --version",
          "description": "환경 버전 확인"
        }
      ],
      "postTurn": [
        {
          "command": "npx prettier --write \"src/**/*.{js,ts,jsx,tsx}\"",
          "description": "Prettier 코드 포맷팅"
        },
        {
          "command": "npm run lint 2>&1 | tail -5",
          "description": "ESLint 검사 (마지막 5줄만 출력)"
        },
        {
          "command": "npm test -- --passWithNoTests 2>&1 | tail -10",
          "description": "테스트 실행"
        }
      ]
    }
  }
}

{
  "agentSettings": {
    "hooks": {
      "preTurn": [
        {
          "command": "[ -f data/train.csv ] && python -c \"import pandas as pd; df = pd.read_csv('data/train.csv'); print(f'shape={df.shape} cols={list(df.columns)} mem={df.memory_usage(deep=True).sum()/1e6:.1f}MB null_rate={df.isnull().mean().mean():.2%}')\" || echo '⚠ data/train.csv 없음 — 경로를 프로젝트에 맞게 수정하세요'",
          "description": "현재 데이터셋의 shape·컬럼·메모리·결측치 비율을 컨텍스트에 주입 (파일 부재 시 안내 메시지만 출력)"
        },
        {
          "command": "ls -lt artifacts/ 2>/dev/null | head -5",
          "description": "최근 생성된 분석 산출물 5개를 컨텍스트에 노출"
        },
        {
          "command": "python -c \"import koreanize_matplotlib\" 2>/dev/null || true",
          "description": "한글 폰트 자동 설정(koreanize-matplotlib) — plot의 한글 깨짐 방지 (스타일은 분석 코드에서 자유롭게 지정)"
        }
      ],
      "postTurn": [
        {
          "command": "black notebooks/ src/ --quiet 2>&1 || true",
          "description": "분석 코드 자동 포맷팅 (black)"
        },
        {
          "command": "[ -f tests/test_data_schema.py ] && pytest tests/test_data_schema.py -x -q 2>&1 | tail -10 || echo '⚠ tests/test_data_schema.py 없음 — Pandera 스키마 작성 후 등록하세요'",
          "description": "Pandera 스키마 기반 데이터 무결성 테스트 실행 (테스트 파일 부재 시 안내)"
        },
        {
          "command": "mkdir -p artifacts/$(date +%F) && find . -maxdepth 2 -name '*.png' -newer .last_run -exec mv {} artifacts/$(date +%F)/ \\; 2>/dev/null && touch .last_run",
          "description": "이번 턴에 생성된 plot을 일자별 아카이브 디렉토리로 이동"
        },
        {
          "command": "[ -f data/train.csv ] && [ $(wc -l < data/train.csv) -lt 10000 ] && python -m ydata_profiling data/train.csv -o artifacts/profile.html --silent 2>&1 | tail -3 || true",
          "description": "행 10000 미만일 때만 ydata-profiling 보고서 생성 (파일 부재·대용량은 자동 스킵)"
        }
      ]
    }
  }
}

"""data/ 또는 프로젝트 루트의 CSV 파일을 자동 탐지해 메타정보를 출력."""
import sys, glob
import pandas as pd

candidates = sorted(glob.glob('data/*.csv') + glob.glob('*.csv'))[:3]
if not candidates:
    print('데이터 파일 없음 — data/ 폴더에 CSV를 두거나 경로를 수정하세요')
    sys.exit(0)

for path in candidates:
    try:
        df = pd.read_csv(path, nrows=10000)  # 큰 파일 가드
        null_rate = df.isnull().mean().mean()
        mem = df.memory_usage(deep=True).sum() / 1e6
        print(f'{path}: shape={df.shape} cols={list(df.columns)[:8]} mem={mem:.1f}MB null_rate={null_rate:.2%}')
    except Exception as e:
        print(f'{path}: 읽기 실패 ({type(e).__name__})')

{
  "agentSettings": {
    "hooks": {
      "preTurn": [
        {
          "command": "python scripts/dataset_meta.py 2>/dev/null || true",
          "description": "프로젝트 내 CSV 파일을 자동 탐지해 메타정보를 컨텍스트에 주입"
        }
      ]
    }
  }
}

# 전역 에이전트 규칙

## 코딩 스타일
- 모든 주석은 한국어로 작성한다
- Python: PEP 8 준수, 타입 힌트 필수
- 함수 길이는 50줄 이하로 유지
- 변수명은 snake_case, 클래스명은 PascalCase

## 응답 방식
- 코드 변경 전에 변경 계획을 먼저 설명한다
- 파일을 수정하면 수정 요약을 마지막에 제공한다
- 불확실한 경우 가정 사항을 명시한다

## 보안
- API 키와 비밀번호는 코드에 하드코딩하지 않는다
- .env 파일을 절대 커밋하지 않는다
- SQL 쿼리는 파라미터화된 방식으로 작성한다

# 프로젝트별 규칙 - my-data-project

## 프로젝트 구조
- 데이터: data/raw/, data/processed/
- 분석 코드: src/analysis/
- 시각화: src/visualization/
- 테스트: tests/

## 데이터 처리 규칙
- DataFrame 변수명은 df_ 접두사 사용
- 원본 데이터(data/raw/)는 절대 수정하지 않는다
- 모든 분석 결과는 data/processed/에 저장한다
- pandas 대신 polars를 우선 사용한다

## 의존성
- Python 3.11+
- 주요 패키지: polars, matplotlib, seaborn, pytest
- 패키지 추가 시 requirements.txt 업데이트 필수

{
  "agentSettings": {
    "mcpServers": {
      "github": {
        "httpUrl": "https://api.githubcopilot.com/mcp/",
        "headers": {
          "Authorization": "Bearer ${GITHUB_TOKEN}"
        }
      },
      "filesystem": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "./src"]
      },
      "postgres": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-postgres"],
        "env": {
          "POSTGRES_URL": "${DATABASE_URL}"
        }
      },
      "custom-internal-api": {
        "httpUrl": "https://internal.mycompany.com/mcp",
        "headers": {
          "X-API-Key": "${INTERNAL_API_KEY}"
        }
      }
    }
  }
}

"coreTools": {
  "readFileTool": {
    "allowedPaths": [
      "./src/**",
      "./tests/**",
      "./docs/**",
      "./README.md"
    ],
    "deniedPaths": [
      "./.env",
      "./.env.*",
      "./secrets/**"
    ]
  },
  "writeFileTool": {
    "allowedPaths": [
      "./src/**",
      "./tests/**"
    ]
  }
}

~/projects/
├── web-app/                    # 워크스페이스 1
│   ├── GEMINI.md               # 이 프로젝트 전용 규칙
│   ├── .gemini/
│   │   └── settings.json       # 프로젝트별 하네스 설정
│   └── src/
├── data-pipeline/              # 워크스페이스 2
│   ├── GEMINI.md               # 다른 규칙 세트
│   ├── .gemini/
│   │   └── settings.json       # 다른 MCP, 다른 보안 정책
│   └── src/
└── ml-research/                # 워크스페이스 3
    ├── GEMINI.md
    ├── .gemini/
    │   └── settings.json
    └── notebooks/

my-project/
├── .gemini/
│   └── settings.json           # Git에 커밋 (민감 정보 제외)
├── GEMINI.md                   # 프로젝트 규칙 (Git에 커밋)
├── .gemini.env.example         # 환경 변수 템플릿 (Git에 커밋)
├── .gemini.env                 # 실제 환경 변수 (Git 제외 — .gitignore)
└── .gitignore

{
  "agentSettings": {
    "coreTools": {
      "terminalTool": {
        "terminalExecutionMode": "REQUEST_REVIEW"
      },
      "readFileTool": {
        "allowedPaths": ["./src", "./tests", "./docs"],
        "deniedPaths": ["./.env", "./.env.*"]
      },
      "writeFileTool": {
        "allowedPaths": ["./src", "./tests"]
      }
    },
    "mcpServers": {
      "github": {
        "httpUrl": "https://api.githubcopilot.com/mcp/",
        "headers": {
          "Authorization": "Bearer ${GITHUB_TOKEN}"
        }
      }
    },
    "hooks": {
      "postTurn": [
        { "command": "npm run lint --silent 2>&1 | tail -5" },
        { "command": "npm test -- --passWithNoTests 2>&1 | tail -5" }
      ]
    }
  }
}

{
  "agentSettings": {
    "coreTools": {
      "terminalTool": {
        "terminalExecutionMode": "REQUEST_REVIEW"
      },
      "readFileTool": {
        "allowedPaths": ["./data", "./src", "./notebooks", "./docs"],
        "deniedPaths": ["./data/raw", "./.env"]
      },
      "writeFileTool": {
        "allowedPaths": ["./data/processed", "./src", "./notebooks"]
      },
      "browserTool": {
        "allowedDomains": [
          "docs.python.org", "pandas.pydata.org",
          "scikit-learn.org", "matplotlib.org",
          "kaggle.com", "huggingface.co"
        ]
      }
    },
    "hooks": {
      "preTurn": [
        { "command": "python --version && pip list | grep -E 'pandas|numpy|sklearn'" }
      ],
      "postTurn": [
        { "command": "black src/ --check --quiet || black src/" },
        { "command": "pytest tests/ -q --tb=short 2>&1 | tail -10" }
      ]
    }
  }
}

{
  "agentSettings": {
    "coreTools": {
      "terminalTool": {
        "terminalExecutionMode": "ALWAYS_PROCEED"
      },
      "readFileTool": {
        "allowedPaths": ["./src", "./tests", "./public", "./package.json"],
        "deniedPaths": ["./.env", "./.env.*", "./node_modules/.cache"]
      },
      "writeFileTool": {
        "allowedPaths": ["./src", "./tests", "./public"]
      },
      "browserTool": {
        "allowedDomains": [
          "developer.mozilla.org", "react.dev",
          "nextjs.org", "tailwindcss.com",
          "vercel.com", "github.com"
        ]
      }
    },
    "mcpServers": {
      "github": {
        "httpUrl": "https://api.githubcopilot.com/mcp/",
        "headers": { "Authorization": "Bearer ${GITHUB_TOKEN}" }
      }
    },
    "hooks": {
      "postTurn": [
        { "command": "npx prettier --write 'src/**/*.{ts,tsx,js,jsx}' --log-level warn" },
        { "command": "npx eslint src/ --max-warnings 0 2>&1 | tail -5" },
        { "command": "npm test -- --passWithNoTests --silent 2>&1 | tail -5" }
      ]
    }
  }
}