포트폴리오 문서 1 · AI 워크플로우 구축 - #24
Open
dongglehada wants to merge 2 commits into
Open
dongglehada wants to merge 2 commits into
dongglehada wants to merge 2 commits into
Conversation
이력서·포트폴리오에 쓸 문서 중 첫 번째. 하네스를 왜 지표부터 만들었고 무엇이 실패했는지를 v1.0.0~v1.3.0 지표로 정리했다. 저장소가 원본이고 GitHub 위키에 사본을 올린다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
기존 초안은 관찰·지표·규칙·실패를 병렬로 나열해 무엇을 만들었는지가 드러나지 않았다. 큰 문제 하나를 세우고 버전마다 어떤 하네스를 왜 넣었고 무슨 숫자가 나왔는지를 사슬로 잇는 구조로 다시 썼다. - v1.3.1 구간을 추가했다. harness_report.py로 집계한 실측이고, 최종 지표가 6.8M에서 7.5M으로 오른 것도 원인과 함께 적었다 - 회귀 테스트를 v1.3.0 112 / v1.3.1 126으로 분리했다. 126은 태그 이후 값이라 다른 칸과 기준이 달랐다 - v1.3.0 프롬프트당 토큰은 metrics.tsv 값 6.83M을 쓴다 - 헤딩 부제를 없애고 절 제목에 버전을 붙여 시간축을 드러냈다 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
변경 사항
이력서·포트폴리오에 쓸 문서 두 개 중 첫 번째를
docs/portfolio/ai-workflow.md로 추가한다.넉 달 동안 만든 하네스를 밖에서 읽을 사람 기준으로 다시 쓴 글이다. 규칙 목록을 나열하는
대신 왜 규칙보다 지표를 먼저 만들었는지, 무엇이 실패했는지를 v1.0.0~v1.3.0 지표로
설명한다. 실패 절이 문서에서 가장 긴 이유는 성공만 적힌 회고가 안 믿기기 때문이다 —
규칙을 요약하다 뜻을 바꿔놓은 사건, 지표가 규칙과 다른 것을 세고 있던 사건, 규칙이
스스로를 잠가 세 버전 동안 시험대에 못 오른 사건을 그대로 적었다.
저장소가 원본이고 GitHub 위키에 사본을 올린다(
RELEASING.md의 위키 절과 같은 방식).확인한 것
docs/harness/metrics.tsv·버전 보고서와 대조했다. 맨 앞 요약의 기준점은규칙 없이 시작한 17.1M으로 잡고, 31.1M까지 올라갔다 내려온 폭(78%)을 따로 적었다.
표에 17.1M이 보이는데 요약만 31.1M을 기준으로 쓰면 부풀린 것처럼 읽히기 때문이다
체크리스트
확인 등급
🔴
docs/portfolio/ai-workflow.md— 대외 공개용 원고다. CI가 문장과 숫자 주장을판정하지 못하고, 위키에 올라가면 되돌리는 비용이 저장소 문서보다 크다. 본문을 읽고
승인해야 한다.
위임했으면 쌌을 곳
없음. 초안이 이미 있었고 편집이 따르는 작업이라 위임 대상이 아니다 (R9).