BL-088: MSA 통합 audit 지원 — marker file / config-based scope discovery

[bluejayA]

배경

BL-085 (Knowledge System Phase 1) PR #157의 hook 설계 중 Microservice Architecture (MSA) 대응 논의 발생.

현재 (Phase 1)

~/projects/my-app/          ← NOT git repo (project container)
├── frontend/               ← git repo → audit: frontend/devflow-docs/
├── backend-api/            ← git repo → audit: backend-api/devflow-docs/
└── backend-db/             ← git repo → audit: backend-db/devflow-docs/

기본 동작: per-repo audit. 서비스별 독립.

Escape hatch (PR #157 머지 후)

DEVFLOW_ROOT 환경변수 opt-in으로 통합 audit 가능:

export DEVFLOW_ROOT=~/projects/my-app
# 이제 frontend/ backend-api/ backend-db/ 내부 편집이
# ~/projects/my-app/devflow-docs/audit.md에 통합 기록됨

한계

• DEVFLOW_ROOT 수동 설정 필요 (onboarding friction)
• 설정 실수/누락 시 사용자가 감지하기 어려움
• 조직 규모로 확산 시 표준화 부담

Phase 2 후보 대안

C. Marker file discovery

• devflow-docs/ 디렉토리 존재 여부로 scope 결정. cwd 상위로 탐색
• 자동, 설정 불필요
• 비용: ~10줄 + 테스트 매트릭스 확장

D. Config file

• .devflow/scope 또는 devflow-docs/.scope 파일로 project root 선언
• 명시적 + 팀 공유 가능
• 비용: 설정 관리 복잡

트리거

Phase 2 재검토 조건 (Codex 추천):

• MSA 사용자 비율 증가
• DEVFLOW_ROOT 설정 실수/운영 부담 반복 관측

관련

• PR BL-085: Knowledge System Phase 1 — taxonomy + Solution layer + L1 ingest hook #157 (BL-085 Phase 1)
• BL-087: post-tool-file-edit hook 보안 가드 강화 #156 (BL-087) — 이번 PR로 close
• docs/plans/2026-04-13-knowledge-system-phase1-plan.md §Phase 2 Re-evaluation Criteria