저번에 prd-maker 공유했었는데요, 스킬 하나 추가돼서 이어서 올립니다.

저번에 prd-maker 공유했었는데요, 스킬 하나 추가돼서 이어서 올립니다.
이전 글: https://nomadcoders.co/community/thread/11839

/prd-to-html 이라고, PRD.md를 사람이 읽을 수 있는 HTML 한 장으로 바꿔주는 기능이에요.

■ 왜 만들었나

저번 글에서 "에이전트가 알아먹는 PRD"를 만드는 도구라고 했는데,

쓰다 보니 반대쪽 문제가 생기더라고요.

PRD.md는 애초에 에이전트가 읽으라고 쓴 문서잖아요.

근데 그걸 만든 사람도, 같이 일하는 사람도 같은 문서를 읽어야 해요.

- 지금 뭘 만들기로 한 거지

- 뭘 일부러 안 만들기로 했더라

- 내가 아직 확인 안 해준 (가정) 항목이 뭐가 남았지

이 세 가지가 제일 중요한데, 평평한 마크다운에선 이게 안 보입니다.

스크롤 내리면서 눈으로 찾아야 해요. 팀장님한테 던지기도 애매하고요.

■ 뭐 하는 기능이냐

같은 내용을 '사람이 결정하는 순서'로 재배치해서 HTML로 뽑습니다.

- 맨 위에 요약 대시보드

- 확인 안 된 (가정) 항목을 원문 줄 번호랑 같이 모아놓은 패널

- Non-Goals(안 만들 것)를 강조 블록으로 승격

- 페이즈별 카드

- 요구사항마다 고정 앵커(#p2-r4) — 슬랙이나 이슈에 그 줄만 딱 링크 가능

외부 리소스를 하나도 안 물어서 파일 하나로 끝나요.

카톡으로 보내도 열리고, 사내망에서도 열리고, 브라우저에서 PDF로 인쇄해도 안 깨집니다.

■ 여기서 좀 고집부린 부분

변환기가 LLM이 아니라 그냥 파이썬 스크립트예요. 일부러 그렇게 했습니다.

LLM한테 시키면 예쁘게는 만들겠지만, 마크다운에 없는 일정이나 KPI를

슬쩍 지어내거든요. 기획서에서 그건 버그가 아니라 사고라서요.

그래서 원문에 없는 건 절대 안 나옵니다. 대신 스타일 옵션도 없어요.

마크다운이 계속 원본이고, HTML은 언제든 지우고 다시 만드는 파생물입니다.

고칠 게 있으면 PRD.md를 고치고 다시 뽑으면 돼요.

■ 써보기

/prd-to-html

이러면 현재 폴더의 PRD.md를 변환합니다. 다른 파일 지정도 되고요.

PRD가 아닌 그냥 마크다운도 변환돼요 — 없는 섹션은 빠지고 읽기 좋은 일반 문서로 나옵니다.

파이썬 스크립트로 직접 돌려도 됩니다. python3만 있으면 되고 설치할 의존성 없어요.

python3 skills/prd-maker/scripts/prd_to_html.py PRD.md

처음 쓰시는 분은 저번이랑 동일합니다.

/plugin marketplace add jcmaker/prd-maker

/plugin install prd-maker@prd-maker

여전히 무료·오픈소스(MIT)고, Claude Code / Codex / Cursor 다 됩니다.

지난 글에 별이랑 피드백 주신 분들 진짜 감사했어요.

👉 https://github.com/jcmaker/prd-maker