FPF 라이브러리
어려운 문제를 해결하고, 할 수 있는 것을 확장하며, 지속적인 개발을 위한 방법론.
FPF Library는 **First Principles Framework (FPF Core)**와 사람, AI agents, 팀 및 조직을 위한 도메인 프레임워크를 통합합니다. 이 라이브러리는 추론(reason), 조사(investigate), 설계(design), 작업 조정(coordinate work), 학습 및 그 과정에 사용된 방법들을 개선하는 방식을 제공합니다. 각 방법은 패턴으로 설명됩니다: 인식 가능한 어려움, 해당 어려움이 발생하는 조건, 유용한 결과를 얻는 방법, 실제 사례, 그리고 한계점입니다.
이 라이브러리는 **개방형 개발의 방법론(methodology of open-ended development)**으로서 발전하고 있습니다. 하나의 결과물은 이전에 달성 불가능했던 문제를 접근 가능한 것으로 만들 수 있으며, 그 문제에 대한 작업은 사용자의 역량과 그 역량을 개발하는 방식을 모두 확장할 수 있습니다. 목표는 미리 정해진 최종 수준 없이 이러한 지속성을 유지하는 것입니다. 여기에는 아직 명시적인 문제가 되지 않은 한계를 인식하고, 기존 지식을 활용하며, 부족한 방법을 구성하고, 유용한 능력과 지식을 타인에게 전달하는 것이 포함됩니다.
또한 하나의 계산, 설계, 의사 결정 또는 학습 필요에 대해 하나의 방법만을 사용하고 거기서 멈출 수도 있습니다. 완료된 작업, 새로운 절차를 만들거나 알려진 방법을 학습하는 것만으로는 그 자체로 지속적인 개발을 확립하지는 못합니다.
라이브러리 사용 시작하기 · 도메인 프레임워크 · FPF Core
라이브러리의 구성 및 이유
라이브러리 아키텍처 참고 자료 읽기. 이 문서는 일반적인 방법론이 왜 Core에 속하는지, 특정 학문 분야가 왜 Suite를 형성하고 다른 분야는 독립형 프레임워크를 갖는지, 그리고 그 기여들이 어떻게 함께 작동하는지를 설명합니다. 개요를 파악하거나, 명백한 중복을 이해하거나, 제안된 변경 사항을 판단할 때 이 자료를 사용하십시오.
익숙한 작업을 위해서는 아래의 적절한 방법으로 바로 이동할 수 있습니다.
작업 시작하기
라이브러리 전체를 처음부터 끝까지 읽을 필요는 없습니다. 현재 상황, 필요한 결과, 그리고 그 결과를 얻는 것을 방해하는 요소를 가져오세요. 아래 항목 중 하나를 선택하거나, 일반적/기술적 언어로 출판물에서 어려움을 검색하세요.
방법을 적용하기 전에 FPF 라이브러리 사용법 (Using FPF Library)을 읽으세요. 이 문서는 유용한 기여를 찾는 방법, 그 조건을 읽는 방법, 이를 나머지 작업에 연결하는 방법, 그리고 출처 인용과 다른 방법을 적용할 방향을 구별하는 방법을 설명합니다. 적절히 알려진 답변은 직접 사용할 수 있지만, 더 큰 질문에는 여러 개의 연결된 방법이 필요할 수 있습니다. 파일 내에서의 순서는 이 모든 것을 수행하라는 지침이 아닙니다.
연결된 추론 유지하기 (Keep connected reasoning in view)
**장기 만트라(Long mantras)**는 관련 질문에 대한 답변들이 서로 어떻게 의존하는지 상기시키는 데 도움을 줍니다. 프로젝트의 경우, **[시스템 사고 장기 만트라 (system-thinking long mantra (FPF A.1.STM))]**는 의도된 사용, 공통 목표, 기능(functioning), 구성 요소(construction), 이를 얻는 방법, 역량 있는 창작자 및 그들의 협력을 연결합니다. 이 만트라의 전체 설명은 왜 그러한 답변들이 적합해야 하는지, 그리고 하나가 변경될 때 무엇을 재검토해야 하는지를 보여줍니다.
**[제어 만트라 (control mantra (FPF C.43))]**는 상황 평가, 가능한 연속성(possible continuations), 비교 및 선택, 실현, 발생한 일의 검토, 그리고 수정(revision)을 연결합니다. 이 만트라의 전체 방법론은 관찰이 나중의 선택을 어떻게 바꿀 수 있는지, 수단과 시기가 그것들을 어떻게 제약하는지, 그리고 개입이 추가적인 문제를 다룰 수 있는 능력을 어떻게 개발할 수 있는지 설명합니다. 기술적 통제(Technical control), 경제적 선택(economic choices), 및 발전 권고(developmental recommendation)는 고유의 메커니즘을 유지합니다.
만트라(mantra)는 고정된 사고나 작업 순서가 아니라 전개되는 논리적 가르침입니다. 라이브러리의 연결 추론에 대한 설명 (Library.Reference:1.1)은 여러 분야에서 발전된 연결을 이끌어냅니다. 전체 설명을 읽고 방법을 이해하고 적응시키세요. 짧은 공식을 사용하여 이를 기억할 수 있습니다.
유용한 결과로부터의 추가 개발
팀이 현재 제품을 제공할 수 있다고 가정해 봅시다. 하지만 더 까다로운 주문은 그 역량을 벗어납니다. 전문가의 결과물을 구매하는 것이 즉각적인 필요를 충족시킬 수 있습니다. 그것을 생산하는 방법을 배우는 것은 팀이 할 수 있는 것을 바꿀 것입니다. 다음 한계를 인식하고, 필요한 방법을 얻거나 발명하며, 이를 획득할 것을 조직하는 방법을 배우는 것은 팀이 계속 발전하는 방식을 바꿀 것입니다. 이들은 서로 다른 증거를 가진 서로 다른 결과입니다.
라이브러리는 모든 곳에 동일한 배치를 요구하지 않으면서 이들을 연결하는 데 도움을 줍니다. AI와 함께 일하는 사람, 여러 협력 팀, 그리고 개발 사무실을 가진 회사는 서로 다른 도메인 방법론과 작업, 자원 및 권한 할당이 필요합니다. 사무실은 하나의 가능한 배치일 뿐이며, 개발의 전제 조건은 아닙니다.
일반적인 방법론은 Core에 있습니다: 개발 작업 연결 (C.40.OD), 방법, 수행 능력 및 사용 조건 연결 (C.40.JD), 그리고 결과로부터 새로운 달성 가능한 문제로의 지속 (C.40.NP). DPF는 학습, 연구, 공학(engineering), 관리 및 기타 관행의 구체적인 메커니즘을 제공합니다. 방법을 개발하는 것, 에이전트의 능력을 변경하는 것, 그리고 실제로 작업을 수행하는 것은 여전히 개별적인 기여로 남아 있습니다.
이용 가능한 것
FPF Core는 1769만 개 문자열에 걸쳐 400개의 패턴을 포함하고 있습니다. 이 코어는 방법론적 작업과 개방형 개발을 포함하여 초학제적인 개념 및 방법을 제공합니다. **34개의 도메인 원칙 프레임워크(DPFs)**는 주제별 특화된 방법을 제공하며, 그중 24개는 네 개의 스위트(Suites)에 속하고 나머지 10개는 DPF 카탈로그 내에 자체 파일로 존재합니다.
DPF는 연결된 패턴 언어를 통해 하나의 분야를 설명합니다. **스위트(Suite)**는 구성 요소 필드와 그 관계를 통해 복합 학문 분야를 설명합니다. **아키텍처 레퍼런스(Architectural Reference)**는 관련 언어가 어떻게 배열되었는지, 그리고 왜 그렇게 되었는지를 설명합니다: 프레임워크 내에서, 스위트 전반에 걸쳐, 또는 라이브러리 전체에 걸쳐서입니다.
| DPF 스위트 | 작업 주제 | DPFs | 패턴 | 텍스트 (문자) | :--- |
| Engineering | 시스템 설계, 구현, 변경 및 유지보수; 지식 접근, 의미론적 통합 및 제어 아키텍처 설계. | 5 | 99 | 2.791 | :--- |
| ... |
DPF 카탈로그는 나머지 열 개의 프레임워크를 나열하며 각 스위트의 파일을 개방합니다. 스위트 총합은 구성 요소 프레임워크 텍스트들을 합산한 것이며, 별도의 스위트 레퍼런스 및 README 페이지는 제외됩니다. 문자 수는 공백과 원래 줄 바꿈을 포함합니다. 이 수치는 사용하기 위해 읽어야 하는 양이 아니라 이용 가능한 자료의 양을 설명하는 것입니다.
라이브러리는 자신이 다루는 모든 학문 분야를 포괄한다고 주장하지 않습니다. 예를 들어, 현재의 Human Capability Engineering Suite는 인간에 관한 모든 방법을 개발하는 것이 아니라 학습 및 체성적 기여(somatic contributions)를 개발합니다.
온라인으로 읽거나 자체 사본을 사용하기
Core on fpf.tools에서 코어를 읽거나, 도메인 출판물 중 하나를 선택하여 필요한 패턴을 열 수 있습니다. 위에 연결된 첫 번째 방법은 해당 독서 서비스를 엽니다. GitHub는 전체 Core를 표시할 수 없으며 대규모 DPF를 잘라낼(truncate) 수 있습니다. 유효한 제목으로의 링크가 이러한 제한을 제거하지는 않습니다.
출처를 위해서는 핵심 마크다운 파일 및 그 이력을 열거나 Raw Markdown으로 Core 다운로드합니다. 이 페이지의 프레임워크 테이블은 마크다운 소스 링크와, 사용 가능한 경우 온라인 읽기 링크를 제공합니다. fpf.tools에서는 Copy and source가 표시된 구절 뒤에 있는 리포지토리 에디션을 식별합니다. 버전이 중요할 때는 출처 에디션 및 업데이트 상태를 확인하세요. 이 서비스는 GitHub보다 지연될 수 있습니다. 검색과 MCP 연결 지침은 자료에 접근하는 다른 방법을 제공합니다.
로컬 사용을 위해서는 이 리포지토리를 다운로드하거나 클론하세요. FPF-Spec.md, FPF-LIBRARY-REFERENCE.md, USING-FPF.md, 라이선스 파일, 그리고 DPFs/를 기존 배치 그대로 유지하세요. 선택된 하위 집합도 사용 가능합니다: 단순히 이용할 수 없는 파일에 대한 링크가 아니라 질문에 필요한 실제 공급 프레임워크들을 포함하세요. Using FPF Library에서 접근 및 선택 방법을 설명합니다.
AI 어시스턴트와 작업하기
어시스턴트에게 관련 전체 텍스트, 실제 상황, 제약 조건 및 관찰 결과를 접근하도록 허용하세요. 이 지침을 프로젝트 설정이나 에이전트가 실제로 읽는 지침 파일에 넣고, fpf/를 사용자의 위치로 대체하세요:
Use FPF Library from fpf/. Before applying its methods, read fpf/USING-FPF.md and follow its guidance. Help obtain the result our work needs. Explain the reasoning in our working language, identify the patterns used, and distinguish source claims, assumptions and missing evidence.
그런 다음 구체적인 질문을 하세요. 예를 들어: “우리 팀은 현재 제품은 제공할 수 있지만 제안된 변형은 할 수 없습니다. 외부 결과를 획득하는 것, 우리 역량을 개발하는 것, 또는 오퍼링을 변경하는 것을 비교하는 데 도움을 주십시오. 어떤 정보가 그 선택을 바꿀 수 있을까요?”
어시스턴트는 방법론을 검색하고, 계산하며, 대안을 비교하고, 추론 초안을 작성 및 검토할 수 있습니다. 어시스턴트의 유창한 답변은 관찰된 사실, 새로운 기능, 권한, 약속 또는 구현된 시스템을 확립하지 않습니다. 출력 결과는 실제 작업, 증거 및 적용 가능한 의사 결정 권한과 비교하여 확인해야 합니다. FPF Library는 에이전트 런타임(agent runtime)이나 자율적 권한 부여가 아닌 방법론 라이브러리입니다. 이는 물리적, 조직적, 지적 및 체화된 관행 전반에 걸쳐 인간의 사용뿐만 아니라 AI 지원 작업에도 활용되도록 의도되었습니다.
기여 이해, 확인 또는 확장하기
README 페이지는 선택하는 데 도움을 주며, 전체 패턴은 방법론을 가르치고 그 조건을 명시합니다. 권장 사항이 중요한 경우 정확한 설명을 읽으십시오. 유용한 접근 방식에 대한 유지된 기록에는 경쟁적인 학파, 실패 사례 및 한계가 포함될 수 있습니다. 가장 최신 표준이나 성공적인 예시 하나만으로는 보편적 적용 가능성을 확립할 수 없습니다.
정확한 참고를 위해서는 완전한 PatternID 또는 섹션 주소를 그리고 출판물을 식별할 충분한 맥락을 유지해야 합니다. FPF Library 사용: 이식 가능한 참조 해결하기는 파일, 검색 및 MCP 전반에 걸쳐 이것이 어떻게 작동하는지 설명합니다. 무엇을 읽을지 선택하기 전에 문서 코드를 배울 필요는 없습니다.
문제 또는 제안된 개선 사항의 경우, 해당 출판물과 구절, 작업 상황, 실패했거나 이용할 수 없는 부분이 무엇인지, 그리고 제안하는 변경 사항을 식별하십시오. 현재 설계를 이해하기 위해 관련 아키텍처 참조(Architectural Reference)를 사용하십시오. 더 광범위한 FPF 생태계에는 독립적으로 작성된 DPFs, 로컬 프레임워크(LPFs), 가이드, 도구 및 서비스가 포함될 수 있으며, 이 저장소는 FPF Library를 게시합니다.
저자, 상태 및 재사용
Anatoly Levenchuk, AI 에이전트 지원. 해당 출판물은 사용 가능하며 지속적으로 개정됩니다. 이는 '영원한 알파(eternal alpha)'입니다. 이는 모든 사용에 적합하다는 보장이 아니라 지속적인 개발을 의미합니다. 출판물의 정체성이 중요한 경우 출판물, 판본 및 패턴을 인용하십시오.
원래 프레임워크 콘텐츠는 CC BY 4.0에 따라 라이선스가 부여됩니다. 출처 표기(attribution), 제3자 자료 및 소프트웨어 경계에 대해서는 라이선스 조건을 참조하십시오. 라이선스가 적용된 텍스트를 공유하거나 각색하려면 해당되는 출처 표기와 변경 고지 사항이 필요합니다. 독립적으로 작성된 DPF와 LPF는 저자가 선택한 라이선스를 사용할 수 있습니다. 방법론이나 출판 형식을 사용하는 것 자체가 CC BY를 강제하는 것은 아닙니다.
인용(Citation)
Levenchuk, Anatoly. FPF Library.
GitHub repository: https://github.com/ailev/FPF
특정 주장이나 방법론을 언급할 때는 출판 정보, 판본(edition), 그리고 완전한 PatternID를 추가해야 합니다.