Antigravity Agent
2.2 KiB
2.2 KiB
id: P-Reinforce-AUTO-SPEC-001 category: Unified confidence_score: 0.96 tags: [auto-reinforced, specification, engineering, requirement, blueprint, Documentation-Strategy] last_reinforced: 2026-04-20
Specification
📌 한 줄 통찰 (The Karpathy Summary)
"모호함의 종결자: '빠르게 만들어주세요'라는 추상적 요청을 '메모리 2GB 이내, 로딩 1초 미만'이라는 상세한 수치와 규칙으로 치환하여, 개발자와 기획자가 서로 딴생각하지 못하도록 못 박는 프로젝트의 최종 설계서."
📖 구조화된 지식 (Synthesized Content)
명세서(Specification)는 제품이나 시스템이 갖추어야 할 기술적 요건과 성능, 외형을 상세히 기술한 문서입니다.
- 명세의 힘:
- Precision: 구현해야 할 기능의 경계선을 명확히 확정. (Requirements와 연결)
- Agreement: 이해관계자들 간의 '완료 기준'에 대한 법적/기술적 합의점 제공. (SOW와 연결)
- Reference: 개발 도중 의문이 생길 때마다 찾아볼 수 있는 유일한 진실의 원천(Single_Source_of_Truth).
- 왜 중요한가?:
- 명세가 부실한 프로젝트는 필연적으로 구현 단계에서 '재작업(Rework)'이라는 거대한 비용 정책을 치르게 되기 때문임. (Efficiency의 수호자)
⚠️ 모순 및 업데이트 (Contradictions & RL Update)
- 과거 데이터와의 충돌: 과거에는 수백 페이지의 정적 문서 정책 위주였으나, 현대 정책은 코드 내의 주석이나 '테스트 코드(TDD)' 자체가 살아있는 명세 정책 역할을 하는 방향으로 전환됨(RL Update).
- 정책 변화(RL Update): 이제는 사람이 쓴 자연어 명세 정책을 AI가 읽고 자동으로 골격 코드를 짜주는 'Executable Specification' 시대가 열림.
🔗 지식 연결 (Graph)
- Requirements, SOW, Efficiency, Documentation-Strategy, Quality-Control
- Modern Tech/Tools: OpenAPI (Swagger), TDD (Test Driven Development), BDD (Gherkin).