Documentation

마르다운은 GitHub, Hugo, Obsidian, Pandoc 등에서 동일한 파일이 다르게 렌더링될 때까지 하나의 언어처럼 보입니다. 그리고 문제는 마르다운이 신뢰할 수 없다는 데에 있지 않습니다.

AI 코딩 에이전트는 기능을 빠르게 출시하지만, 명세서(specs), 테스트, 그리고 코드는 조용히 서로 다른 방향으로 이동(drift)합니다. 이 가이드는 추적 가능성(traceability) 모델, 명세서-테스트 및 명세서-코드 매핑, 그리고 병합 전에 이러한 드리프트를 포착하는 CI(CI) 검사를 다룹니다.

LLM 위키(Wiki)는 오래된 사실이 여전히 그럴듯해 보일 때, 모순이 정교하게 다듬어질 때, 그리고 생성된 요약이 원천 자료에서 벗어나면 실패합니다.

스팩 주도 개발(Spec-Driven Development, SDD)은 스펙이 문서가 아닌 워크플로우일 때 작동합니다. 핵심은 방대한 제품 요구사항 문서(PRD)를 산출하는 데 있지 않습니다.

스펙 주도 개발(Spec-Driven Development, SDD)은 소프트웨어 엔지니어들이 과거에 시도했다가 노력 대비 효과가 떨어지자 포기했던 아이디어들 중 하나입니다.

의결 기록은 AI 지원 소프트웨어 개발에서 누락된 기억 레이어입니다. 이는 구축된 내용뿐만 아니라 그 이유까지 포착하며, AI 도구가 코드를 작성할 때 이러한 구별이 결정적인 중요성을 갖게 됩니다.

A practical hub for document creation, formatting, conversion, and printing workflows using Markdown, LaTeX, PDF tools, and automation.