Skip to content

Latest commit

 

History

History
755 lines (564 loc) · 25.8 KB

AGENTS.md

File metadata and controls

755 lines (564 loc) · 25.8 KB

에이전트 개발 규칙

로컬 메모리 및 브라우저 보호

  • 테스트는 npm test, npm run test:coverage, npm run mcp:smoke, npm run cli:smoke의 자원 보호 실행기를 사용합니다. 직접 Vitest나 여러 검사 실행기로 공용 잠금을 우회하지 않습니다. Mac 기본 워커는 1개이며 환경 변수로 상한을 올리지 않습니다.
  • 시작 전·진행 중 메모리 여유, CPU, Chrome 본체 수를 관측합니다. 보호 실행기의 자원 거절은 실패이며 검사를 통과한 것으로 처리하지 않습니다. 압박 상태에서 즉시 재시작하지 말고 원인을 확인합니다.
  • 이 Mac의 전체 회귀·커버리지·self-hosted CI·fresh 운영 조회·브라우저 실험을 겹치지 않습니다. 기존 CI 결과를 활용하고 필요한 최소 검증을 순서대로 실행합니다.
  • 브라우저 실험은 소유 세션 1개만 사용하며 성공·실패·중단 모두 finally에서 탭과 세션을 회수합니다. OY 운영 브라우저 외에 추가 본체를 계속 생성하지 않습니다. 종료 후 세션 목록과 프로세스 수를 확인합니다.
  • 공용 Codex cua_node나 사용자 브라우저를 임의 종료하지 않습니다. 공유 보조 프로세스가 누적되면 신규 브라우저 작업을 멈추고 상태를 보고합니다. 단일 RSS나 swap 값만으로 누수로 단정하지 않습니다.

이 Mac의 수동 브라우저

  • 이 Mac의 수동 웹 검증과 ChatGPT 실험은 확장·별도 MCP 서버 없이 safari-minimized 스킬을 기본으로 사용합니다. 스킬의 고정 창 ID, 단일 작업 잠금, 실제 결과 대기와 정리를 따릅니다. 올리브영 운영 중계와 세븐일레븐 예외 복구도 Safari 전송을 사용하며 Chrome으로 자동 대체하지 않습니다.

  • safari-live의 사용자 탭 자동 채택과 keepalive 탭은 끕니다. 작업별 전용 창·페이지 하나를 사용하며, 이 Mac의 Safari 작업은 전체 최대 4개로 제한합니다. 창 생성만 짧게 직렬화하고 실제 작업은 개별 창 잠금으로 분리합니다. Safari의 DOM 성공을 화면 캡처·팝업·SSO·CDP 호환 성공으로 확대하지 않습니다.

  • Safari 로그인이나 권한이 필요하면 구체적으로 알립니다. Chrome을 자동으로 추가 실행하거나 인증 자료를 복사하지 않습니다. 과거 BSK 실험 스크립트는 기록이며 새 실험에 그대로 실행하지 않습니다. 정상 운영 인증을 브라우저 이전 시험만을 위해 교체하지 않습니다.

  • 운영 Safari와 수동 작업은 개별 창 잠금을 사용합니다. 설치된 스킬의 기본 start 또는 start --independent-window를 사용하고 전역 작업 잠금을 요청 전체에 잡지 않습니다. 메모리 여유 20% 미만 또는 CPU 85% 초과 시 새 창을 거절합니다. 다른 작업의 잠금·창을 회수하지 않으며, 회수가 불확실하면 failed 및 페이지 수 미확인으로 보고합니다. 공유 Safari 전체를 메모리 상한 때문에 종료하지 않습니다.

  • 이 Mac의 운영 설정은 OY_RELAY_TRANSPORT=safari, SEVEN_RELAY_TRANSPORT=safari입니다. Chrome 숨김 도우미와 편의점의 SEVEN_BROWSER_EXECUTABLE 설정은 비활성화합니다. 인증·누적 한도 원장은 보존하며 Safari 중계의 검증과 복원 절차를 따릅니다.

  • 2026-11-16 사용자 지시: DAISO MCP 전체 기능의 정상 운영과 장애 복구를 최우선으로 합니다. 올리브영을 포함한 중계 복구에 필요한 Safari 정상 종료·재시작과 중계 재기동은 이미 승인됐으므로 같은 승인을 다시 묻거나 승인 대기로 복구를 중단하지 않습니다. 정상 종료부터 시도하고, 실패 시 원인을 확인해 필요한 대상만 제한적으로 복구합니다. 인증 자료·누적 원장과 사용자 데이터는 보존하고 실제 캐시 우회 조회 및 CLI·MCP 결과로 복구를 판단합니다. 실제 비밀번호·2단계 인증 입력이 필요한 경우에만 즉시 사용자에게 알립니다. 전체 Mac 재부팅과 LaunchAgent 재기동 검증을 구분합니다.

최우선: 공개 MCP 도구는 10개 고정

공개 tools/list의 도구는 정확히 10개이며 절대 늘리지 않습니다. 새 서비스와 기능은 기존 도구의 service/operation/requestType에 통합합니다. 기존 이름은 deprecated 호출 별칭으로만 보존하며 공개 목록에는 추가하지 않습니다. 일반 MCP와 PlayMCP에 동일하게 적용합니다. 공개 도구 계약과 tests/core/compact, tests/app/compact-contract.test.ts 검사를 반드시 유지합니다.

이 문서는 AI 에이전트가 이 프로젝트에서 코드를 작성하고 기여할 때 따라야 하는 규칙과 가이드라인을 정의합니다.

목차


코드 작성 규칙

파일 크기 제한

모든 코드 파일은 450줄 내외로 작성되어야 합니다.

  • 최대 줄 수: 450줄
  • 권장 줄 수: 300-400줄
  • 초과 시 조치: 파일이 450줄을 초과하면 기능별로 분리하여 모듈화
  • 자동 검사: src/**/*.ts의 450줄 제한은 CI에서 자동으로 강제
  • 예외: 현재 src 아래 예외는 없으며 OpenAPI 생성 산출물은 저장소 루트에 위치

파일 분리 예시

// ❌ 나쁜 예: 하나의 파일에 모든 기능 (600줄)
// src/products.ts (600줄)

// ✅ 좋은 예: 기능별로 분리
// src/products/search.ts (200줄)
// src/products/filter.ts (150줄)
// src/products/formatter.ts (100줄)
// src/products/index.ts (50줄)

코드 품질

  • 명확성: 코드는 명확하고 이해하기 쉽게 작성
  • 재사용성: 중복 코드를 최소화하고 공통 로직은 함수로 추출
  • 타입 안정성: TypeScript의 타입 시스템을 적극 활용
  • 에러 핸들링: 모든 비동기 작업과 외부 API 호출에 적절한 에러 처리 구현

예시

// ✅ 좋은 예
async function fetchData(url: string): Promise<ApiResponse> {
  try {
    const response = await fetch(url);
    if (!response.ok) {
      throw new Error(`HTTP 에러: ${response.status}`);
    }
    return await response.json();
  } catch (error) {
    console.error('데이터 가져오기 실패:', error);
    throw error;
  }
}

// ❌ 나쁜 예
async function fetchData(url) {
  const response = await fetch(url);
  return await response.json();
}

커밋 규칙

커밋 빈도

  • 주기적인 커밋: 논리적인 작업 단위마다 커밋
  • 작은 단위: 한 번에 하나의 기능이나 수정사항만 포함
  • 완성된 코드: 빌드 실패나 런타임 에러가 없는 상태에서만 커밋

커밋 메시지 컨벤션

접두사는 영어, 메시지는 한국어를 사용합니다.

커밋 메시지 형식

<타입>: <제목>

<본문> (선택사항)

<푸터> (선택사항)

타입 종류

  • feat: - 새로운 기능 추가
  • fix: - 버그 수정
  • docs: - 문서 수정
  • style: - 코드 포맷팅, 세미콜론 누락 등 (로직 변경 없음)
  • refactor: - 코드 리팩토링 (기능 변경 없음)
  • test: - 테스트 코드 추가/수정
  • chore: - 빌드 설정, 패키지 매니저 설정 등
  • perf: - 성능 개선
  • ci: - CI/CD 설정 변경
  • revert: - 커밋 되돌리기

커밋 메시지 예시

# ✅ 좋은 예
feat: 제품 검색 필터링 기능 추가
fix: 매장 찾기 시 거리 계산 오류 수정
docs: API 사용 예시 문서 업데이트
refactor: 재고 확인 로직을 별도 모듈로 분리
test: 가격 정보 조회 API 테스트 추가
chore: TypeScript 버전 5.7.2로 업데이트

# ❌ 나쁜 예
feat: add feature (영어로만 작성)
update (타입 접두사 누락)
fix: bug fix (구체적이지 않음)
여러 기능 추가 (타입 접두사 누락)

제목 작성 규칙

  • 명확하고 구체적으로: 무엇을 변경했는지 명확히 기술
  • 50자 이내: 제목은 간결하게 작성
  • 명령형: "~했음" 대신 "~함" 또는 "~추가" 형태 사용
  • 마침표 없음: 제목 끝에 마침표를 붙이지 않음

본문 작성 규칙 (선택사항)

feat: 제품 카테고리별 필터링 기능 추가

사용자가 제품을 카테고리별로 필터링할 수 있는 기능을 추가했습니다.
지원 카테고리:
- 주방/생활
- 문구
- 완구/취미
- 화장품/미용

관련 이슈: #123

커밋 전 체크리스트

커밋하기 전에 다음 사항을 반드시 확인하세요:

  • 코드가 빌드되는가?
  • TypeScript 타입 에러가 없는가?
  • 개인정보나 민감한 정보가 포함되어 있지 않은가?
  • API 키, 비밀번호, 토큰 등이 포함되어 있지 않은가?
  • 테스트가 통과하는가? (테스트가 있는 경우)
  • npm run test:coverage가 100% (Statements/Branches/Functions/Lines)를 만족하는가?
  • 주석이 한국어로 작성되어 있는가?
  • 파일이 450줄을 초과하지 않는가?

보안 및 개인정보

절대 커밋하지 말아야 할 항목

다음 항목들은 절대 Git 저장소에 커밋되어서는 안 됩니다:

1. 인증 정보

// ❌ 절대 금지
const API_KEY = 'sk-1234567890abcdef';
const PASSWORD = 'mypassword123';
const DATABASE_URL = 'postgresql://user:pass@localhost/db';
// ✅ 올바른 방법: 환경 변수 사용
const API_KEY = process.env.API_KEY;
const PASSWORD = process.env.PASSWORD;
const DATABASE_URL = process.env.DATABASE_URL;

2. 개인정보

  • 실제 이메일 주소
  • 전화번호
  • 주소
  • 신용카드 정보
  • 주민등록번호
  • 기타 식별 가능한 개인정보

3. 민감한 설정 파일

# ❌ 커밋 금지
.env
.env.local
.env.production
.env.development
secrets.json
credentials.json
service-account-key.json

# ✅ .gitignore에 추가되어 있는지 확인

4. 프라이빗 키 및 인증서

  • SSH private keys (id_rsa, id_ed25519 등)
  • SSL/TLS 인증서의 private key
  • JWT secret keys
  • OAuth client secrets

환경 변수 사용

민감한 정보는 반드시 환경 변수로 관리하세요.

.env.example 파일 제공

# .env.example (커밋 가능)
API_KEY=your_api_key_here
DATABASE_URL=your_database_url_here
SECRET_KEY=your_secret_key_here
# .env (커밋 금지, .gitignore에 포함)
API_KEY=sk-real-api-key-1234567890
DATABASE_URL=postgresql://user:pass@localhost/db
SECRET_KEY=super-secret-key-xyz

Cloudflare Workers Secrets

Cloudflare Workers 환경 변수는 다음과 같이 관리:

# 로컬 개발용 (.dev.vars 파일 - .gitignore에 포함)
API_KEY=test-key-for-local-dev

# 프로덕션 배포용 (wrangler를 통해 설정)
npx wrangler secret put API_KEY

보안 체크리스트

커밋 전 다음 사항을 확인하세요:

  • .env 파일이 .gitignore에 포함되어 있는가?
  • 하드코딩된 API 키나 비밀번호가 없는가?
  • console.log()에 민감한 정보가 출력되지 않는가?
  • 주석에 실제 계정 정보가 포함되어 있지 않는가?
  • 테스트 데이터가 실제 개인정보를 포함하지 않는가?

파일 구조

플러그인 기반 아키텍처

이 프로젝트는 확장 가능한 플러그인 아키텍처로 설계되었습니다. 다이소 외에 편의점, 백화점, 영화관 등 다양한 서비스를 쉽게 추가할 수 있습니다.

핵심 설계 원칙

  1. ServiceProvider 인터페이스: 모든 서비스가 구현해야 하는 표준 계약
  2. ServiceRegistry: 서비스를 동적으로 등록하고 MCP 서버에 연결
  3. 도구 이름 네임스페이스: 서비스별 접두사 사용 (예: daiso_, cu_, cgv_)

디렉토리 구조

daiso-mcp/
├── src/
│   ├── index.ts              # MCP 서버 진입점 (450줄 이하)
│   ├── core/                 # 핵심 모듈 (확장 기반)
│   │   ├── types.ts          # 공통 타입 정의
│   │   ├── interfaces.ts     # ServiceProvider 인터페이스
│   │   └── registry.ts       # ServiceRegistry 클래스
│   ├── services/             # 서비스 프로바이더
│   │   └── daiso/            # 다이소 서비스
│   │       ├── index.ts      # 서비스 팩토리
│   │       ├── types.ts      # 다이소 전용 타입
│   │       ├── api.ts        # API 엔드포인트 중앙화
│   │       └── tools/        # 도구 구현
│   │           ├── searchProducts.ts
│   │           ├── findStores.ts
│   │           ├── checkInventory.ts
│   │           └── getPriceInfo.ts
│   └── utils/                # 유틸리티 함수
├── docs/                     # 네트워크 파싱/리서치 문서
├── examples/                 # 사용 예시
├── tests/                    # 테스트 파일
└── scripts/                  # 빌드/배포 스크립트

### 네트워크 파싱 기록

`docs/` 폴더에는 API 엔드포인트 분석을 위한 네트워크 파싱 기록이 저장됩니다.
새로운 서비스를 추가할 때 네트워크 분석 결과를 이 폴더에 `{서비스명}-` 접두사를 붙여 저장하세요.

docs/ ├── daiso-network-analysis-result.md # 다이소 API 분석 결과 ├── daiso-playwright-network-analysis.md # Playwright 네트워크 분석 ├── daiso-replay-session-test.html # 세션 테스트 HTML └── daiso-test-replay.js # 테스트 리플레이 스크립트


### 문서 기록

`docs/` 폴더에는 네트워크 파싱 기록과 API 리서치 문서를 함께 저장합니다.
새로운 서비스를 추가할 때 관련 문서를 이 폴더에 `{서비스명}-` 접두사로 저장하세요.

docs/ ├── daiso-network-analysis-result.md # 다이소 API 분석 결과 ├── daiso-playwright-network-analysis.md # Playwright 네트워크 분석 ├── daiso-replay-session-test.html # 세션 테스트 HTML └── daiso-test-replay.js # 테스트 리플레이 스크립트


### 새 서비스 추가 방법

새로운 서비스(예: CU 편의점)를 추가하려면:

#### 1. 서비스 디렉토리 생성

src/services/cu/ ├── index.ts # CuService 클래스 및 팩토리 ├── types.ts # CU 전용 타입 정의 ├── api.ts # CU API 엔드포인트 └── tools/ # CU 도구 구현 ├── searchProducts.ts └── findStores.ts


#### 2. ServiceProvider 구현

```typescript
// src/services/cu/index.ts
import type { ServiceProvider } from '../../core/interfaces.js';
import type { ToolRegistration } from '../../core/types.js';

class CuService implements ServiceProvider {
  readonly metadata = {
    id: 'cu',
    name: 'CU 편의점',
    version: '1.0.0',
    description: 'CU 편의점 제품 검색 및 매장 찾기',
  };

  getTools(): ToolRegistration[] {
    return [
      // cu_search_products, cu_find_stores 등
    ];
  }
}

export function createCuService(): ServiceProvider {
  return new CuService();
}

3. 레지스트리에 등록

// src/index.ts
import { createDaisoService } from './services/daiso/index.js';
import { createCuService } from './services/cu/index.js';

registry.registerAll([createDaisoService, createCuService]);

도구 이름 규칙

서비스별 도구는 접두사로 구분합니다:

서비스 접두사 예시
다이소 daiso_ daiso_search_products
CU cu_ cu_search_products
CGV cgv_ cgv_search_movies

파일 명명 규칙

  • camelCase: 함수, 변수명
  • PascalCase: 클래스, 인터페이스, 타입명
  • kebab-case: 파일명 (선택사항)
  • SCREAMING_SNAKE_CASE: 상수
// 함수, 변수
const userName = 'John';
function getUserData() {}

// 클래스, 인터페이스, 타입
class UserService {}
interface UserData {}
type UserId = string;

// 상수
const MAX_RETRY_COUNT = 3;
const API_BASE_URL = 'https://api.example.com';

코드 스타일

주석 작성

모든 주석은 한국어로 작성합니다.

파일 헤더 주석

/**
 * 제품 검색 도구
 *
 * 다이소 제품을 검색하고 필터링하는 기능을 제공합니다.
 * 검색 조건: 키워드, 카테고리, 가격 범위
 *
 * @module tools/searchProducts
 */

함수 주석

/**
 * 제품을 검색하고 필터링된 결과를 반환합니다.
 *
 * @param query - 검색 키워드
 * @param category - 제품 카테고리 (선택사항)
 * @param maxPrice - 최대 가격 (선택사항)
 * @returns 검색 결과 객체
 * @throws {Error} API 호출 실패 시
 */
async function searchProducts(
  query: string,
  category?: string,
  maxPrice?: number,
): Promise<SearchResult> {
  // 구현
}

인라인 주석

// 사용자 입력 검증
if (!query || query.trim().length === 0) {
  throw new Error('검색어를 입력해주세요');
}

// TODO: 캐싱 기능 추가 필요
const results = await fetchFromAPI(query);

// FIXME: 대소문자 구분 없이 검색하도록 수정 필요
const filtered = results.filter((item) => item.name.includes(query));

TypeScript 타입 정의

// 인터페이스 정의
interface Product {
  id: string;
  name: string;
  category: string;
  price: number;
  description?: string; // 선택적 속성
  inStock: boolean;
}

// 타입 별칭
type ProductId = string;
type ProductCategory = '주방/생활' | '문구' | '완구/취미' | '화장품/미용';

// 유니온 타입
type SearchFilter = {
  query: string;
  category?: ProductCategory;
  maxPrice?: number;
};

코드 포맷팅

  • 들여쓰기: 2 spaces
  • 따옴표: single quotes (') 우선
  • 세미콜론: 사용
  • 줄 길이: 최대 100자 권장
// ✅ 좋은 예
const message = '안녕하세요';
const user = {
  name: '홍길동',
  age: 30,
};

// ❌ 나쁜 예
const message = '안녕하세요';
const user = { name: '홍길동', age: 30 };

문서화

  • 문서 제목·본문·안내 문구에는 em dash(U+2014)를 사용하지 않습니다. 문맥에 맞게 콜론, 쉼표, 괄호 또는 문장 분리를 사용합니다.

README.md

프로젝트의 메인 문서로 다음 내용을 포함:

  • 프로젝트 개요
  • 설치 방법
  • 사용 방법
  • API 문서
  • 배포 가이드

API 문서

각 도구의 입력/출력 스키마를 명확히 문서화:

/**
 * 제품 검색 API
 *
 * 요청 예시:
 * ```json
 * {
 *   "name": "search_products",
 *   "arguments": {
 *     "query": "수납박스",
 *     "category": "주방/생활",
 *     "maxPrice": 5000
 *   }
 * }
 * ```
 *
 * 응답 예시:
 * ```json
 * {
 *   "content": [{
 *     "type": "text",
 *     "text": "{ ... }"
 *   }]
 * }
 * ```
 */

CHANGELOG.md (권장)

주요 변경사항을 기록:

# Changelog

## [1.1.0] - 2025-03-01

### Added

- 제품 카테고리별 필터링 기능 추가
- 가격 히스토리 조회 기능 추가

### Fixed

- 매장 찾기 시 거리 계산 오류 수정

### Changed

- API 응답 형식 개선

테스트

테스트 작성 원칙

  • 모든 도구는 테스트를 작성해야 합니다
  • 엣지 케이스를 고려한 테스트 작성
  • 에러 처리 로직도 테스트
  • 코드 커버리지 100% 유지: 커밋 전 npm run test:coverage를 실행해 100%를 유지해야 합니다

테스트 파일 명명

src/tools/searchProducts.ts
tests/tools/searchProducts.test.ts

테스트 예시

import { searchProducts } from '../src/tools/searchProducts';

describe('제품 검색', () => {
  test('키워드로 제품을 검색할 수 있다', async () => {
    const result = await searchProducts({ query: '수납박스' });
    expect(result.content).toBeDefined();
    expect(result.content[0].type).toBe('text');
  });

  test('존재하지 않는 제품은 빈 결과를 반환한다', async () => {
    const result = await searchProducts({ query: '존재하지않는제품xyz' });
    const data = JSON.parse(result.content[0].text);
    expect(data.count).toBe(0);
  });

  test('빈 검색어는 에러를 발생시킨다', async () => {
    await expect(searchProducts({ query: '' })).rejects.toThrow();
  });
});

체크리스트 요약

코드 작성 전

  • 어떤 기능을 구현할지 명확히 이해했는가?
  • 파일이 450줄을 초과하지 않도록 설계했는가?
  • 적절한 파일 구조와 모듈 분리를 계획했는가?

코드 작성 중

  • TypeScript 타입을 명확히 정의했는가?
  • 주석을 한국어로 작성했는가?
  • 에러 핸들링을 적절히 구현했는가?
  • 보안에 취약한 코드가 없는가?

커밋 전

  • 빌드가 성공하는가?
  • 타입 에러가 없는가?
  • 개인정보나 민감한 정보가 포함되지 않았는가?
  • 커밋 메시지가 컨벤션을 따르는가?
  • 파일이 450줄 이하인가?
  • npm run test:coverage 결과가 100% (Statements/Branches/Functions/Lines)인가?

커밋 메시지 작성 시

# 형식 확인
<타입>: <한국어 제목>

# 예시
feat: 제품 검색 필터링 기능 추가
fix: 매장 거리 계산 오류 수정
docs: API 사용 가이드 업데이트

릴리스 절차

npm 패키지를 배포할 때는 게시된 버전과 Git 기록이 같은 커밋을 가리키도록 아래 순서를 지킵니다.

npm version patch
npm run release:dry-run
git push origin main --follow-tags
npm publish
npm view daiso version
  • npm version은 버전 변경 커밋과 vX.Y.Z 태그를 함께 만듭니다.
  • npm run release:dry-run으로 dist, openapi.json, openapi.yaml 포함 여부를 확인합니다.
  • git push origin main --follow-tags가 성공한 뒤 npm publish를 실행합니다.
  • 게시 후 npm view daiso version으로 registry 반영 버전을 확인합니다.

운영 메모

  • GS25 재고 인증·갱신·상품 선택 장애를 복구할 때는 정상 로그인 복구 운영 절차를 먼저 읽습니다. 정상 GS 세션은 Mac의 비공개 파일에만 보관하고, 재로그인 후 파일 교체와 중계 재기동을 함께 수행합니다. 오래된 무인증 리플레이·Frida 문서를 현재 운영 절차로 사용하지 않습니다. 가상기기 종료 후 REST·MCP·게시 CLI의 상품명/코드/지역/수량을 검증하고 호출 원장을 보존합니다.
  • 이 저장소의 기본 작업 브랜치는 main이며, open PR 또는 open issue가 있으면 먼저 triage합니다.
  • 사용자가 정기체크합시다라고 요청하면 별도 확인 질문 없이 아래 항목을 자동으로 조회하고 요약합니다.
    • 열린 PR과 각 PR의 CI/Coverage/CodeQL 상태
    • 열린 issue
    • Dependabot security alerts
    • CodeQL code scanning alerts
    • Secret scanning alerts
    • 최신 main 기준 npm audit 결과
    • 최신 main 커밋과 최근 GitHub Actions 상태(CI, Coverage, CodeQL, Deploy, Health Checks, External Smoke)
    • 로컬 작업트리 상태
  • 모든 src/**/*.ts 파일은 450줄 이하를 유지합니다.
  • npm daiso 배포 전에는 npm run check, npm run test:coverage, npm audit를 확인합니다.
  • 외부 사이트 응답 회귀는 .github/workflows/external-smoke.yml의 서비스별 CLI/MCP matrix로 야간 및 수동 확인합니다.
  • Actions 목록에서 수정 전 커밋의 과거 실패가 보일 수 있으므로, 최신 main 커밋의 실행 결과를 기준으로 판단합니다.
  • 개인 작업 메모는 /Users/hm/Documents/personal-agent/projects/daiso-mcp/PROJECT.md에 둘 수 있지만, 여러 에이전트가 알아야 하는 규칙은 이 파일에 반영합니다.

참고 자료


이 규칙을 따라 일관되고 안전하며 유지보수 가능한 코드를 작성해주세요.

프로젝트 판단 기준

  • 작업 시작 시 ALIGNS.md를 읽고 작업 범위, 중요한 결정, 결과 검토에 적용합니다. 이 파일의 구현·검증·보안 규칙도 함께 유지합니다.
  • 기준 정리 요청이나 중요한 판단 불일치 검토에는 설치된 align 스킬을 읽고 사용합니다. 출처는 https://github.com/hmmhmmhm/aligns.md이며 업데이트 정책은 ALIGNS.md를 따릅니다. 다른 필수 스킬의 적용 범위는 유지합니다.
  • 세션에서 처음 관련 작업을 할 때 현재 스킬 목록에서 발견 가능한지 확인합니다. 설치 파일만으로 활성화를 단정하지 않으며, 발견되지 않으면 신뢰할 수 있는 로컬 파일을 직접 읽었다는 사실을 밝힙니다.
  • 일반 작업은 기존 기준을 적용하며 새 정렬 인터뷰를 시작하지 않습니다. 이미 확인한 답은 재사용하고, 명확한 오류는 수정하며, 결과를 바꾸는 미결정 사항만 묻습니다.
  • 기준 변경은 사용자가 명시적으로 요청하거나 확인한 범위만 저장합니다. 스킬 업데이트나 개별 항목 확인을 전체 합의의 재확인으로 취급하지 않습니다. 선택한 PR·대화 범위 밖의 개인 기록을 임의로 수집하지 않습니다.