ZMFHFramework
시작하기

ZMFH 소개

특정 환경에 묶이지 않는
개발의 기반

ZMFH는 개발 과정에서 반복적으로 발생하는 여러 문제를 해결하기 위해 시작된 구조입니다. 운영체제와 언어에 종속되지 않고 오래 살아남는 기반을 만드는 것이 목표입니다.

핵심 역할

ZMFH는 5가지 역할을 담당합니다

모든 것을 직접 실행하거나 소유하는 것이 아니라, 서로 다른 프로젝트와 언어가 안전하게 연결될 수 있도록 계약과 증거를 제공합니다.

↔

연결기

서로 다른 언어와 프로젝트를 안전하게 연결합니다.

▤

계약기

언어 초월 연결 계약을 생성하고 관리합니다.

▣

검증기

연결 상태와 실패를 검증하고 감지합니다.

▥

증거기

모든 연결 결과를 evidence로 남기고 추적합니다.

◌

생존 런타임

어떤 환경에서도 실행이 보장되는 구조를 지향합니다.

Internal / External / Real World

Internal

ZMFH 자체를 만드는 세계입니다. capabilities, contracts, providers, runtime, promotion, validation, evidence, lock 기능을 직접 구현합니다.

External Engine

외부 프로젝트와 연결하기 위한 ZMFH 내부 엔진입니다. zmfh/external 폴더에 위치하지만, 외부 그 자체가 아니라 외부와 연결하는 엔진입니다.

Real External

Zmfh-main 밖의 모든 프로젝트가 진짜 외부 세계입니다. ZMFH는 관찰하고 연결하지만 함부로 수정하거나 삭제하지 않습니다.

구조 예시

예시프로젝트/
├─ Zmfh-main/ ← ZMFH 본체
├─ 외부프로젝트_001/
├─ 외부프로젝트_002/
├─ 외부프로젝트_003/
└─ ...

ZMFH는 Zmfh-main 안에서 실행되지만, attach 대상은 Zmfh-main 밖의 형제 폴더 전체입니다.

Provider

Provider 철학

requirements.core의 도구들은 ZMFH 바깥에 직접 노출되지 않습니다. 도구는 provider로 흡수되며, capability 이름으로 직접 사용됩니다.

→

ruff

code_analysis

code_analysis provider

→

black

code_format

code_format provider

→

mypy

type_contract

type_contract provider

→

pytest

test_contract

test_contract provider

→

numpy

compute_runtime

compute_runtime provider

→

fastapi

service_contract

service_contract provider

Language Graph

언어 초월 연결

각 언어의 import, include, module, use 사슬을 하나의 ZMFH 계약 그래프로 연결합니다.

Python

연결 방식: import / from

capability: python_contract
connection_type: import / from
provider: python_provider
contract_ready: true

Chain Load Runtime

ZMFH는 레버를 당기고 Worker가 읽습니다

외부 프로젝트를 shard로 나누고 worker가 병렬로 읽은 뒤, ZMFH가 shard evidence를 병합하여 lock으로 닫습니다.

2

Shard 분할

각 프로젝트를 병렬 처리 가능한 단위로 분해합니다.

6

Shard Evidence

각 worker가 shard 결과를 evidence 형태로 기록합니다.

3

Worker 배정

언어별 또는 프로젝트별 worker를 배정합니다.

8

Lock 판정

전체 외부 프로젝트 연결 상태를 lock으로 봉인합니다.

Worker 병렬 구조

ZMFH Root Lever

Worker 001

Project_A / Python

Worker 002

Project_B / PowerShell

Worker 003

Project_C / Java

Worker 004

Project_D / C++

Worker N

Mixed

ZMFH 2.0.0 — 구조 완성형

2.0.0은 모든 기능이 완성된 상태가 아니라 구조 완성형입니다. 골조가 완성되었고, 이제 기능 승격과 외부 연결을 확장합니다.

완료된 항목

✓ internal / external boundary
✓ hard lock
✓ surface cleanup
✓ provider ownership
✓ capability contract schema
✓ runtime baseline
✓ evidence portability

Promoted Capability

✓ code_analysis
✓ code_format
✓ type_contract
✓ test_contract
✓ compute_runtime
✓ structured_state

ZMFH로 시작하세요

환경에 종속되지 않고, 언어와 OS의 경계를 넘어서는 개발 기반을 경험해보세요.

제품 둘러보기 →무료로 시작하기