내 기술분야 플레이북, 파운드리

mkdir -p ~/capstone/capstone-7 && cd ~/capstone/capstone-7
python3 -m venv .venv && source .venv/bin/activate
pip -q install mkdocs-material pytest
mkdocs --version

cat > PROMPT.md << 'PSKEOF'
# 《도메인》 Playbook, Master 생성 프롬프트

> 목적: 《도메인》 정보 더미(블로그, 논문, 릴리스 노트, 데모)를 그대로 옮겨 담는 게 아니라,
> 신호를 거르고(signal filter), 실행 가능하게 만들고(actionable), 스스로 안 낡게(self-fresh) 만드는
> 참조 자산을 생성하기 위한 시스템 프롬프트.
> 사용법: 페이지 단위로 하나씩 생성하고 검토한 뒤 다음으로 진행한다. 한 번에 전체를 생성하지 않는다.

## 1. 역할과 미션

당신은 《도메인》 큐레이터다. 산출물은 《독자》가 질문을 받았을 때
5분 안에 방향, 근거, 다음 액션을 찾는 참조 자산이다. 뉴스 아카이브가 아니다.

세 가지 원칙을 어기면 산출물을 폐기한다:
1. 신호 > 노이즈: "새로 나왔다"는 이유만으로 포함하지 않는다. THE FILTER를 통과한 것만 담는다.
2. 실행 가능성: 모든 항목은 "그래서 무엇을 하면 되는가"로 끝나야 한다.
3. 자기 갱신성: 모든 페이지에 owner, updated, volatility 메타데이터를 붙인다.

## 2. 독자와 깊이 계층

독자는 《독자》. 성숙도가 제각각이므로 문서를 나누지 않고 깊이를 계층화한다:
- L0 (TL;DR): 1~2문장. 상단만 읽어도 방향을 잡는다.
- L1 (1페이지 요약): 핵심 개념 + 의사결정 기준 + 매핑 표.
- L2 (Deep-dive): 링크나 접기(collapse)로 분리한다.

## 3. 범위, 5개 필러 (IA 고정)

1. 《필러 1》
2. 《필러 2》
3. 《필러 3》
4. 《필러 4》
5. 《필러 5》

각 필러 상단에 "이 필러에서 가장 자주 받는 질문 Top 3"를 배치한다.

## 4. 포함 기준 (THE FILTER)

후보 항목은 아래 4개 중 최소 2개를 충족해야 본문에 들어간다. 미달이면 radar.md에 한 줄로만 기록:
- [ ] ⓐ 《검증 기준: production 또는 실사용에서 검증됨》
- [ ] ⓑ 《매핑 기준: 우리 스택/서비스와 구체적으로 연결 가능》
- [ ] ⓒ 《수요 기준: 실제로 질문받은 이력이 있음》
- [ ] ⓓ 《성숙 기준: GA이거나 명확한 GA 로드맵이 있음》

화려한 데모가 성숙한 역량을 가리는 경우가 많다. "인상적 데모"와 "배포 가능"을 분리 표기한다.

## 5. 성숙도 라벨 (모든 항목 필수)

🟢 GA / 🟡 Preview / 🔵 Research-only / ⚪ Hype(데모만)

## 6. 페이지 규격 (모든 필러 페이지 공통)

- 파일 첫머리에 front matter: owner, updated(YYYY-MM-DD), volatility(1m/3m/6m)
- 순서: L0 TL;DR → 자주 받는 질문 Top 3 → L1 표(항목, 성숙도, 다음 액션) → L2 접기
- 모든 항목 행에 성숙도 라벨과 "다음 액션" 한 줄이 있어야 완성이다
PSKEOF

claude

grep -c '《' PROMPT.md   # 0이어야 완료

mkdir -p docs scripts tests
cat > mkdocs.yml << 'MKDEOF'
site_name: Playbook Foundry
theme:
  name: material
  language: ko
  palette:
    scheme: slate
    primary: deep orange
  features:
    - navigation.sections
    - content.code.copy
nav:
  - 홈: index.md
  - 필러:
      - 필러 1: p1.md
      - 필러 2: p2.md
      - 필러 3: p3.md
      - 필러 4: p4.md
      - 필러 5: p5.md
  - Radar 대기열: radar.md
MKDEOF

cat > docs/index.md << 'IDXEOF'
---
owner: me
updated: 2026-08-09
volatility: 6m
---

# 이 플레이북을 읽는 법

질문을 받았을 때 5분 안에 방향, 근거, 다음 액션을 찾는 참조 자산입니다. 뉴스 아카이브가 아닙니다.

## 이 사이트의 규칙

- 모든 항목은 THE FILTER(4개 기준 중 2개 이상)를 통과해야 본문에 들어옵니다.
- 미달 후보는 [Radar 대기열](radar.md)에 한 줄로만 기록됩니다.
- 성숙도 라벨: 🟢 GA / 🟡 Preview / 🔵 Research-only / ⚪ Hype(데모만)
- 모든 페이지는 owner, updated, volatility 메타데이터를 가지며 기한이 지나면 게이트가 경고합니다.

## 필러

| 필러 | 한 줄 소개 |
|---|---|
| [필러 1](p1.md) | (M2에서 채웁니다) |
| [필러 2](p2.md) | (M2에서 채웁니다) |
| [필러 3](p3.md) | (M2에서 채웁니다) |
| [필러 4](p4.md) | (M2에서 채웁니다) |
| [필러 5](p5.md) | (M2에서 채웁니다) |
IDXEOF

mkdocs build --strict && mkdocs serve

cat > tests/test_freshness.py << 'TSTEOF'
"""신선도 게이트 스펙. scripts/check_freshness.py가 이 테스트를 전부 통과해야 M3 완료.
실행: .venv/bin/python -m pytest tests/ -q"""
import datetime
import importlib.util
import pathlib

_spec = importlib.util.spec_from_file_location(
    "check_freshness",
    pathlib.Path(__file__).resolve().parents[1] / "scripts" / "check_freshness.py")
assert _spec is not None and _spec.loader is not None
cf = importlib.util.module_from_spec(_spec)
_spec.loader.exec_module(cf)

TODAY = datetime.date(2026, 8, 9)

FRESH = """---
owner: me
updated: 2026-08-01
volatility: 3m
---
# 최근 페이지
"""

STALE = """---
owner: me
updated: 2026-01-05
volatility: 1m
---
# 오래된 페이지
"""

NO_META = """# 메타데이터가 없는 페이지
본문만 있다.
"""


def test_parse_meta_reads_front_matter():
    meta = cf.parse_meta(FRESH)
    assert meta["owner"] == "me"
    assert meta["updated"] == "2026-08-01"
    assert meta["volatility"] == "3m"


def test_parse_meta_returns_none_without_front_matter():
    assert cf.parse_meta(NO_META) is None


def test_classify_fresh_page_is_ok():
    assert cf.classify(cf.parse_meta(FRESH), TODAY) == "ok"


def test_classify_overdue_page_needs_review():
    assert cf.classify(cf.parse_meta(STALE), TODAY) == "review"


def test_classify_missing_meta():
    assert cf.classify(None, TODAY) == "missing"


def test_scan_exit_code(tmp_path):
    docs = tmp_path / "docs"
    docs.mkdir()
    (docs / "a.md").write_text(FRESH)
    (docs / "b.md").write_text(STALE)
    assert cf.scan(docs, TODAY) == 0          # review는 경고일 뿐 통과
    (docs / "c.md").write_text(NO_META)
    assert cf.scan(docs, TODAY) == 2          # 메타데이터 누락은 차단
TSTEOF
.venv/bin/python -m pytest tests/ -q

sed -i 's/^updated: .*/updated: 2026-01-05/' docs/p1.md
python3 scripts/check_freshness.py
sed -i "s/^updated: .*/updated: $(date +%F)/" docs/p1.md
python3 scripts/check_freshness.py

cat > ship.sh << 'SHPEOF'
#!/usr/bin/env bash
# 출고 게이트: 셋 중 하나라도 실패하면 site/를 만들지 않는다.
set -euo pipefail

echo "[1/3] 신선도 메타데이터"
python3 scripts/check_freshness.py

echo "[2/3] 성숙도 라벨 lint"
missing=0
for f in docs/p*.md; do
  if ! grep -q "🟢\|🟡\|🔵\|⚪" "$f"; then
    echo "  성숙도 라벨 없음: $f"
    missing=1
  fi
done
test "$missing" -eq 0

echo "[3/3] mkdocs build --strict"
mkdocs build --strict

echo "GATE PASS, site/ 준비 완료"
SHPEOF
chmod +x ship.sh

./ship.sh

echo "# 라벨도 메타데이터도 없는 페이지" > docs/p9.md
./ship.sh; echo "exit=$?"
rm docs/p9.md
./ship.sh; echo "exit=$?"

./ship.sh

cd ~/capstone/capstone-7
printf '.venv/\nsite/\n' > .gitignore
git init -b main && git add -A && git commit -m "my playbook v1"
gh repo create my-playbook --public --source . --push
mkdocs gh-deploy --force