Skip to content

docs: README 갱신 — AI 활용 + API 활용 방점 (v1.0 → v2 현행화)#178

Merged
LsMin124 merged 1 commit into
mainfrom
docs/readme-ai-api-refresh
Jun 25, 2026
Merged

docs: README 갱신 — AI 활용 + API 활용 방점 (v1.0 → v2 현행화)#178
LsMin124 merged 1 commit into
mainfrom
docs/readme-ai-api-refresh

Conversation

@LsMin124

Copy link
Copy Markdown
Owner

요약

stale 해진 v1.0 README(4-node architect/designer/coder/executor · 418 tests · Claude 4.7 · Phase 2c 91.2% 표)를 v2 현행으로 교체. 요청대로 AI 활용에 방점 + API 활용 포함.

변경

🤖 AI 활용 (방점)

  • 멀티에이전트 LangGraph 파이프라인 — 13노드 역할/모델 표 (strategist·formalizer·narrative·faithfulness·designer·golden×K·brute·reconciler·executor·input_generator·suite_assembler·qa×N·difficulty)
  • 모델 티어링 — Opus 4.8(정밀: formalizer FREEZE·faithfulness) / Sonnet 4.6(발산: 전략·서술·QA·검산·난이도) / golden↔brute 모델 다양성(우연한 동일 버그 상쇄)
  • 구조화 출력(typed tool call), 단일-IR consistency-by-construction, 자기교정 루프(faithfulness round-trip·QA back-route)
  • 'AI 판단 vs 결정론 경계' — 정답성은 LLM이 아니라 symbolic verifier·golden↔brute differential이 결정

🔌 API 활용

  • (A) Anthropic APIlangchain_anthropic + with_structured_output, 모델 ID, 비용 $0.4~0.6/run
  • (B) FastAPI 서비스GET /healthz · POST /v1/problems/generate(202 async job·idempotency·429 Retry-After) · GET /v1/jobs/{job_id}, stateless, 계약 v3.2

기타 현행화

  • 파이프라인 위상(P1/P2 노브 표), 19 algorithm catalog(유지), Quick Start(main_v2/batch/api/difficulty), 문서 SSOT(계약 포함)

정확성

모든 수치 실측 검증: 903 passed · Python 3.11+ · 모델 상수(ipe/v2/config.py+노드) · API 3엔드포인트(ipe/v2/api.py) · 계약 v3.2. 코드/스키마/DB 무변경 (docs-only).

stale v1.0 내용(4-node architect/designer/coder/executor·418 tests·Claude 4.7·
Phase 2c 91.2% 표)을 v2 현행으로 교체. 사용자 요청대로 AI 활용에 방점 + API 활용 포함.

- 🤖 AI 활용: 멀티에이전트 LangGraph 파이프라인(13노드 역할/모델 표) + 모델
  티어링(Opus 정밀=formalizer/faithfulness·Sonnet 발산=전략/서술/QA/검산·golden↔
  brute 모델 다양성) + 구조화 출력(typed tool call) + 단일-IR consistency-by-
  construction + 자기교정 루프(faithfulness round-trip·QA back-route) + 'AI 판단 vs
  결정론 경계'(정답성은 symbolic verifier가 결정).
- 🔌 API 활용: (A) Anthropic API(langchain_anthropic·with_structured_output·모델
  ID·비용 $0.4~0.6/run) + (B) FastAPI 서비스(healthz/generate/jobs 3엔드포인트·202
  async job·idempotency·429·stateless·계약 v3.2).
- 파이프라인 위상(P1/P2 노브 표)·19 algorithm catalog·Quick Start(main_v2/batch/
  api/difficulty)·문서 SSOT(계약 포함) 현행화.

모든 수치 실측 검증: 903 passed·Python 3.11+·모델 상수(config/노드)·API 3엔드포인트·
계약 v3.2. 코드/스키마/DB 무변경(docs-only).
@LsMin124 LsMin124 merged commit 4e9a382 into main Jun 25, 2026
4 checks passed
@LsMin124 LsMin124 deleted the docs/readme-ai-api-refresh branch June 25, 2026 21:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant