AGENTS.md - AI 협업 프로토콜
"이 문서를 읽고 있다면, 당신이 바로 그 지능체(The Intelligence)입니다."
이 파일은 당신의 **앵커(Anchor)**입니다. 프로젝트의 법칙, 영토의 지도, 그리고 기억 프로토콜을 정의합니다. 깨어날 때(새 세션 시작 시), 먼저 이 파일을 읽으십시오.
🧠 30초 복구 프로토콜 (Quick Recovery)
새 세션을 시작하거나 "길을 잃었다"고 느낄 때 즉시 실행하십시오:
- 루트 디렉토리의 AGENTS.md 읽기 → 프로젝트 지도 획득
- 아래 "현재 상태" 확인 → 최신 아키텍처 버전 찾기
.anws/v{N}/05_TASKS.md읽기 → 현재 할 일 확인- 작업 시작
🗺️ 지도 (영토 인식)
다음은 이 프로젝트의 구성 방식입니다:
| 경로 | 설명 | 접근 프로토콜 |
|---|---|---|
src/ | 구현 계층. 실제 코드베이스. | Task를 통해 읽기/쓰기 |
.anws/ | 통합 아키텍처 루트 디렉토리. 버전별 아키텍처 상태와 업그레이드 기록 포함. | 읽기 전용(구버전) / 한 번 쓰기(신버전) / changelog는 CLI가 유지 |
.anws/v{N}/ | 현재 진실. 최신 아키텍처 정의. | 항상 가장 큰 v{N}을 찾으십시오. |
.anws/changelog/ | 업그레이드 기록. anws update가 생성한 변경 기록. | CLI가 자동 유지, 삭제 금지 |
target-specific workflow projection | 워크플로우. /genesis, /blueprint 등. | 현재 target에 해당하는 네이티브 프로젝션 파일 읽기 |
target-specific skill projection | 스킬 라이브러리. 원자적 능력. | 현재 target에 해당하는 네이티브 프로젝션 파일 호출 |
.nexus-map/ | 지식 베이스. 코드베이스 구조 매핑. | nexus-mapper가 생성 |
🛠️ 워크플로우 레지스트리
[!IMPORTANT] 워크플로우 우선 원칙: 작업이 특정 워크플로우와 일치하거나, 현재 작업이 어떤 워크플로우의 적용 시나리오에 명백히 부합, 기본적으로 부합, 심지어 의심스럽게 부합한다고 판단되는 경우, 반드시 먼저 해당 파일을 읽고 그 안의 단계를 엄격히 따라 실행하십시오. 워크플로우는 정교하게 설계된 프로토콜이지 선택적 참조가 아닙니다.
트리거 프로세스:
- 사용자가 워크플로우 이름을 언급하거나, 현재 작업이 어떤 워크플로우의 적용 시나리오에 명백히 부합, 기본적으로 부합, 심지어 의심스럽게 부합한다고 판단되는 경우, 반드시 먼저 해당 워크플로우 파일을 읽어야 함
- 즉시 읽기 해당 워크플로우 파일
- 엄격히 따르기 워크플로우의 단계를 따라 실행
- 체크포인트에서 일시 중지하고 사용자 확인 대기
| 워크플로우 | 트리거 시점 | 산출물 |
|---|---|---|
/quickstart | 새 사용자 진입 / 어디서부터 시작해야 할지 모를 때 | 다른 워크플로우 조율 |
/genesis | 새 프로젝트 / 대규모 리팩토링 | PRD, Architecture, ADRs |
/probe | 변경 전 / 프로젝트 인계 | .anws/v{N}/00_PROBE_REPORT.md |
/design-system | genesis 후 | 04_SYSTEM_DESIGN/*.md |
/blueprint | genesis 후 | 05_TASKS.md + AGENTS.md 초기 Wave |
/change | 기존 작업 미세 조정 | TASKS + SYSTEM_DESIGN 업데이트 (수정만) + CHANGELOG |
/explore | 조사 시 | 탐색 보고서 |
/challenge | 결정 전 의문 제기 | 07_CHALLENGE_REPORT.md (문제 개요 목차 포함) |
/forge | 코딩 실행 | 코드 + AGENTS.md Wave 블록 업데이트 |
/craft | 워크플로우/스킬/프롬프트 생성 | Workflow / Skill / Prompt 문서 |
/upgrade | anws update 후 업그레이드 조율 | Minor / Major 판단 후 /change 또는 /genesis로 라우팅 |
📜 헌법 (The Constitution)
- 버전이 곧 법칙: 아키텍처 문서를 "수정"하지 말고 "진화"시키십시오. 변경 시 반드시 새 버전을 생성해야 합니다.
- 명시적 컨텍스트: 결정은 ADR에 기록하고, "채팅 메모리"에 남기지 마십시오.
- 교차 검증: 코딩 전에
05_TASKS.md를 확인하십시오. 내가 계획된 일을 하고 있는가? - 미학: 문서는 아름다워야 합니다. Markdown과 Emoji를 적극 활용하십시오.
🔄 프로젝트 상태 보존 영역
📍 현재 상태 (Workflow가 자동 업데이트)
참고: 이 부분은 프로젝트 파일 내 보존 영역이며,
/genesis,/blueprint,/forge가 자동 유지합니다.
- 최신 아키텍처 버전:
.anws/v1 - 활성 작업 목록:
.anws/v1/05_TASKS.md - 할 일 개수: 차단된 구현 작업 0개; 현재 최종 수동 검토 단계
- 최근 업데이트:
2026-03-16
🌊 Wave 1 — Guided Core + Replay 메인 체인 완료
start / step / replayCLI 메인 경로 완료- 자동 저장,
final.md,replay.md및 현재 디렉토리로 내보내기 완료 verify원클릭 검증 체인 완료.windsurf/skills/sequential-thinking/SKILL.md및skills/sequential-thinking-skills/SKILL.md로 CLI 프로토콜 재작성 완료- 현재 상태: 최종 수동 검토 및 제출 준비 여부 대기 중
🌳 프로젝트 구조 (Project Tree)
참고: 이 부분은
/genesis가 유지 관리합니다.
src/
└── anws/
├── bin/cli.js
├── lib/ (init, update, diff, changelog, copy, manifest, ...)
└── templates/
├── .agents/ (내부 canonical 템플릿 소스, projection을 통해 각 target에 배포)
└── AGENTS.md
.anws/
├── changelog/ (업그레이드 기록)
└── v{N}/ (현재 아키텍처 문서)
🧭 내비게이션 가이드 (Navigation Guide)
참고: 이 부분은
/genesis가 유지 관리합니다.
- 새 아키텍처가 준비되기 전까지: 코드를 대규모로 수정하지 마십시오.
- 아키텍처 개요:
.anws/v{N}/02_ARCHITECTURE_OVERVIEW.md - ADR:
.anws/v{N}/03_ADR/(시스템 간 결정의 유일한 기록 소스) - 아키텍처 문제 발생 시:
.anws/v{N}/03_ADR/를 참조하십시오.
기술 스택 결정
- [.anws/tech-evaluator 또는 /genesis가 자동 채움]
시스템 경계
- [.anws/system-architect 또는 /genesis가 자동 채움]
활성 ADR
- [.anws가 ADR 요약 자동 채움]
현재 작업 상태
T4.3.1완료T1.3.1완료pnpm typecheck / test / build / verify모두 통과- 현재 Git 자동 커밋 안 함, 수동 확인 대기 중
상태 자체 점검: 준비되셨나요? 사용자에게
/quickstart를 실행하여 시작하라고 알려주십시오.