Concept (개념)aiverifiedFri May 01
SNLM 카드 표준 (Structured Natural Language Markup) — 6 frontmatter + 9 section body
별칭: SNLM · SNLM Card Standard · Structured Natural Language Markup · 9 section body
#snlm#card-standard#frontmatter#body-9-sections#lecture-core
요약
본 강의 위키의 카드 작성 표준 — Structured Natural Language Markup. 6 mandatory frontmatter + 9 section body. 읽을 수 있는 카드(human-readable) = 실행 가능한 카드(agent-executable). AI Ready Codebase 5 questions 와 isomorphic.
상세
6 mandatory frontmatter
---
wiki_id: <code>_<type>_<slug> # e.g. HRN_concept_multi-layer-guardrail
title: <한 줄 명제>
created: 2026-05-01
status: draft # human promotes to active
visibility: public | internal
subdomain: ai | lecture
---
The LLM must never omit them. (term/claude-md 의 frontmatter 와 정합)
9 section body (고정 순서)
| # | 섹션 | 역할 | AI Ready Codebase 5Q 매핑 |
|---|---|---|---|
| 1 | Purpose | 목적 | What |
| 2 | Context | 맥락 | Dependencies |
| 3 | Key Concepts | 핵심 개념 | What + Implicit |
| 4 | Input | 입력 | (HIAO 5요소 I) |
| 5 | Output | 출력 | (HIAO 5요소 O) |
| 6 | Constraints ★ | 제약 (anti-patterns 명시) | Don't |
| 7 | Agent Usage ★ | HIAO level 명시 | How |
| 8 | Example | 예시 | How |
| 9 | Checklist | 체크리스트 (clear · testable · reusable) | (검증) |
→ 9 섹션 ⊇ 5 questions — 본 카드 표준이 AI Ready Codebase 의 슈퍼셋.
concept/ai-ready-codebase 5 questions ↔ 9 sections
| 5Q (모듈 CLAUDE.md) | 9S (위키 카드) |
|---|---|
| What | Section 1 Purpose + Section 3 Key Concepts |
| How | Section 7 Agent Usage + Section 8 Example |
| Don't | Section 6 Constraints (anti-example) |
| Dependencies | Section 2 Context (wikilinks ≥ 2) |
| Implicit | Section 3 Key Concepts |
→ 카드 분해 ↔ AI Ready Codebase 동형 (isomorphism) — 위키 카드 = 모듈별 CLAUDE.md.
HIAO 5 요소 프롬프트 계약 통합
위 9 섹션이 concept/hiao-1-n-n 의 5 요소 프롬프트 계약 도 내장:
- Structural definition → frontmatter
hiao_level - Input parsing (I) → Section 4 Input
- Persona (A) → Section 7 Agent Usage
- Downstream control protocol → Section 7 (L1·L2 만)
- Output schema (O) → Section 5 Output
→ 읽을 수 있는 카드 = 실행 가능한 프롬프트. 그대로 LLM 에 붙여넣기 → 실행.
Lesson 카드의 추가 권장 필드
session_number: 1
duration_min: 90
difficulty: beginner
prerequisites: []
exercises: []
핵심 규칙
- 모든 카드 6 필드:
wiki_id,title,created,status,visibility,subdomain❌ 누락 subdomain은 폴더 아님 — frontmatter 필드 (커스텀 viewer 가 필터링)[[wikilink]]만 내부 참조. 외부 URL 은10_source/에서만status: draftLLM 출력 →active사람이 승격 (Canon 8)
방법론
강의 활용 (Ch 7 — 카드 표준 단원의 핵심):
- 6 frontmatter (1분): 6 필드 표 + 누락 절대 금지 강조.
- 9 sections + 5Q + HIAO 5 요소 매핑 (3분): 한 슬라이드 — 세 표준의 isomorphism.
- 읽기 = 실행 (1분): 카드 그대로 LLM 에 붙여넣기 데모.
- lint 규칙 (1분): 외부 URL 차단, wikilink 검증, 6 필드 검증.
주의사항
- SNLM 어휘의 학술 부담: Structured Natural Language Markup 은 본 강의의 명명. 학술 표준 아닐 수 있음 — 본 강의 운영 표준 으로 표기.
- 9 섹션의 강제성: 모든 카드가 9 섹션 모두 채워야 하지는 않음. 최소 5 섹션 (Purpose / Context / Constraints / Agent Usage / Example) 권장.
- 본 강의 위키의 기존 카드와의 정합: 기존 ≈140 카드는 유사 패턴 (요약 / 상세 / 방법론 / 주의사항) 이 대부분 9 섹션의 압축형. 신규 카드는 9 섹션 명시 권장.
- 상위 표준 term/claude-md 의 Role / Constraints / Goal / Context 4 요소가 본 9 섹션의 압축형.