docs: 하네스 레퍼런스 분석 + 2차 라운드(2D 오피스 UI 등) 설계 정리 - #1
Merged
Conversation
ECC(MIT), FounderOS-DEMO, "나만의 AI 회사 만들기" 기본/심화편을 분석하고, Agent_Core에 이식한 검증 게이트 / 트래픽 제어 / 토큰 절약 계층의 설계와 레퍼런스 대응표, 검증 결과와 한계를 정리한다. 구현은 FinVANT/n8n 브랜치 claude/harness-programming-integration-0ph02p, 설계 결정은 같은 브랜치의 ADR-019에 있다. munderdiffl.in은 네트워크 정책상 접근하지 못해 분석에 반영되지 않았다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016FruYg46nTM3idcq3bj8BL
- 접근하지 못했던 munderdiffl.in의 정체가 chaitanyagiri/munder-difflin(MIT)으로 확인돼 "확인하지 못했다"를 실제 분석으로 교체한다. 다섯 레퍼런스 중 STD와 가장 가깝다 — 노션 심화편이 말하던 것을 제품으로 만든 것이고, 우리도 이미 Phaser 2D 대시보드를 갖고 있다. - ECC 에이전트 프롬프트 68개의 이식 가능성 판정을 1-6절로 추가한다(전부는 안 되고 그대로는 하나도 안 되는 이유 3가지: 도구 전제, 스택 적합성, 크기). - 3-5~3-7절로 자격증명 마스킹, ECC A/B층 이식, 하이브 그래프 화면을 정리하고 대응표와 검증 결과를 갱신한다. 테스트 310개 중 309개 통과. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016FruYg46nTM3idcq3bj8BL
1·2차 이식 문서는 "무엇을 붙일까"의 기록이었다. 6절을 추가해 붙인 것을 실제로 실행해 본 뒤 드러난 것을 적는다 — 화면을 열기 전에는 안 보이던 종류의 문제였고, 레퍼런스 분석만으로는 나오지 않는 항목이다. - 6-1 조용한 배선 버그 2건: @primary 가 DB 구현을 밀어내 모든 조회 API 가 빈 배열을 반환하고 있었고, loginPage() 만 부른 탓에 POST /login 이 401 이었다. 둘 다 어떤 단위 테스트로도 안 잡힌다. (ADR-023) - 6-2 에이전트를 코드가 아니라 데이터로: ECC 프롬프트 68개를 검토하다 우리 쪽 프롬프트도 자바 문자열 상수라는 게 걸렸다. ADR-020 재검토 조건 5번이 예상보다 빨리 성립한 경우다. ReviewPlaybook 도 agents/review.md 로 들어갔다. (ADR-024) - 6-3 총괄의 분해를 드러낸다: 경로는 이미 있었고 빠진 건 드러내기였다. 진짜로 없던 하나는 "누가 결정했는가" — 총괄 판단과 정규식 폴백이 같은 화면에서 똑같아 보였다. (ADR-025/026) - 6-4 시크릿을 규약이 아니라 빌드로: 설정은 이미 깨끗했지만 .gitignore 가 없어 .env 를 만들라고 요구하면서 보호하지 않고 있었다. (ADR-027) 4절 대응표에서 ADR-024 로 사라진 자바 클래스 참조(ReviewAgentAdapter, ReviewPlaybook.*)를 md 파일 경로로 갱신하고, munder-difflin 항목에 GOD 오케스트레이터 대응과 미이식인 격리 worktree를 추가했다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016FruYg46nTM3idcq3bj8BL
munderdiffl.in 스크린샷을 기준으로 오피스 화면을 평면도로 다시 만들면서 나온 것들을 7절로 정리했다. 화면 변경만이 아니라 띄워 봐야 보이는 결함 네 개(부호 시프트로 사라진 픽셀, 원문 자리를 차지한 총괄 출력, 켜면 죽는 메모리 큐, 편집 중 내용을 지우는 폴링)와 MCP 결정, 관측 도입 판단을 함께 적었다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016FruYg46nTM3idcq3bj8BL
HoSeong0731
changed the title
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
2 participants
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.
ECC(MIT), FounderOS-DEMO, "나만의 AI 회사 만들기" 기본/심화편을 분석하고,
FinVANT/n8n에 이식한 검증 게이트 / 트래픽 제어 / 토큰 절약 계층의 설계와 레퍼런스 대응표,
검증 결과와 한계를 정리한 문서(
harness-integration.md) 하나짜리 PR이다.구현은 FinVANT/n8n 브랜치
claude/harness-programming-integration-0ph02p,설계 결정은 같은 브랜치의 ADR-019 이하에 있다.
커밋 구성 (4개)
만들기" 대비표, ADR-019 설계 근거.
munderdiffl.in 참조 아키텍처(GOD 오케스트레이터 + 격리 worktree + MemPalace)를 반영.
ADR-020~022 대응.
(
@Primary누락, 폼 로그인 401) 두 건을 실제로 기동해서 찾아낸 과정. ADR-023~027 대응.보여주며 요청한 2D 오피스 UI/에이전트 메모리/MCP 연동/docker 관측성(ADR-028~031)을
실제로 띄워 검증하며 찾아낸 결함 4건(팔레트 시프트 버그, 총괄 상태 표시 오류, 부팅을
막던 조건부 빈 누락, 폴링이 편집 중인 메모리를 지우던 버그)을 정리.
알려진 제약
반영되지 않았다 — 이후 스크린샷이 제공되면서 2번 커밋부터 반영됐다.
harness-integration.md1개 파일만 변경) — 실제 코드 변경은FinVANT/n8n PR을 따라간다.
Co-Authored-By: Claude Sonnet 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_016FruYg46nTM3idcq3bj8BL