yule-agent-commands

ForgeKit

여러 AI provider · 에이전트 · 도구를 하나의 operator-gated 대장간으로 묶어,
실제 작업을 "끝"까지 끌고 가는 개인 에이전트 운영 플랫폼.

또 하나의 챗봇이 아니다 — provider 를 연결하고, 작업에 맞는 스킬을 장착하고, operator 승인 정책 아래 실행하고, 모든 결과를 지속 메모리에 남긴다.

provider-neutral · operator-gated · no fake-live · Claude / Codex / Gemini / Ollama

forge(대장간 — 쇠를 달궈 두드려 형태를 잡는다) + kit(도구 모음).

---

ForgeKit 란?

ForgeKit 은 플랫폼(umbrella) 이다. 엔진은 packages/* 에 있고, apps/* 는 그 엔진을 공유하는 실행 앱 일 뿐이다 — 그중 무엇도 그 자체로 ForgeKit 은 아니다.

flowchart TB
    subgraph APPS["apps/ · 실행 앱 (operator/runtime/worker)"]
        direction LR
        Console["🖥️ forgekit-console<br/><i>operator TUI·CLI</i>"]
        Eng["⚙️ engineering-agent"]
        Plan["📅 planning-agent"]
        Disc["💬 discord-gateway"]
        Mem["🧠 memory-worker"]
        Load["📈 loadtest-runner"]
    end

    subgraph CORE["packages/ · ForgeKit 플랫폼 코어 + named cores"]
        direction LR
        FCore["forgekit-config<br/>forgekit-contracts<br/>forgekit-provider<br/>forgekit-runtime"]
        Named["🔥 hephaistos<br/>📚 nexus<br/>🗄️ armory"]
    end

    subgraph INFRA["packages/ · shared infra"]
        Infra["core · storage · integrations<br/>vcs · security · llm-gateway · memory"]
    end

    APPS -->|"의존"| CORE
    APPS -->|"의존"| INFRA

의존은 apps/* → packages/* 한 방향만 — packages/* → apps/* 는 hard rail 로 금지.

• forgekit-console — operator 앱: Claude-Code 스타일 TUI 로 브레인 구성, 런타임 모드 전환, 작업 resolve, 정직한 상태 읽기. "보여주고 조작"만 하지 플랫폼 코어를 소유하지 않는다.
• engineering-agent(yule) — 항상 켜진 역할 기반 엔지니어링 런타임(Discord 게이트웨이 + 멤버 봇, SQLite job queue, Obsidian vault 미러).
• 그 외 planning-agent · discord-gateway · memory-worker · loadtest-runner.

ForgeKit 코어(runtime / provider / config / contracts / Hephaistos / Nexus / Armory)는 packages/* 가 소유한다. 옆에는 engineering-agent 계열이 쓰는 shared infra 와 일부 transitional 패키지가 함께 있다. 전체 분류표·네이밍·"어디에 새 기능을 추가하는가" 는 docs/package-topology.md, owner 매트릭스는 docs/forgekit-architecture-ownership.md.

모든 것이 provider-neutral(Claude / Codex / Gemini / Ollama 와 openai-호환·엔터프라이즈 엔드포인트가 한 계약 뒤에 있음)이고 operator-gated(승인 / 예산 / safe-class 경계가 장식이 아니라 실제로 작동).

---

어떻게 작동하나 — 대장간 흐름

광산 → 도서관 → 대장장이: Nexus 가 광산/도서관, ForgeKit 이 대장간, Hephaistos 가 대장장이다.

flowchart LR
    In["📥 요청 / 커넥터"] --> Heph

    subgraph Forge["🔥 ForgeKit (forge)"]
        Heph["🔨 Hephaistos<br/>resolve → equip plan → Work Packet"]
    end

    Nexus["📚 Nexus<br/>지식 광산<br/>areas·patterns·snippets"] -.->|"reads (복사 안 함)"| Heph
    Armory["🗄️ Armory<br/>스킬·로드아웃·웨폰 카탈로그"] -.->|"catalog"| Heph

    Heph --> Agents["🤖 Agents<br/>PM · gateway · tech-lead · 전문가"]
    Agents -->|"bounded 실행 (safe-class)"| Mem["💾 Memory / Vault<br/>SQLite + Obsidian"]
    Agents -.->|"승인 게이트"| Op([👤 operator])

---

핵심 개념

개념	한 줄	코드
ForgeKit	전체 플랫폼 / 실행 환경	this repo
Hephaistos	스킬 forging 코어 — 요청을 equip plan(agent + skills + loadout + weapons + work packet)으로	packages/hephaistos
Nexus	Hephaistos 가 읽는(복사 안 함) 외부 지식 소스(areas/patterns/snippets/troubleshooting)	packages/nexus (read: hephaistos/nexus_read.py)
Armory	Hephaistos 가 forge 하는 Skills / Loadouts / Weapons 카탈로그	packages/armory (armory.catalog·armory.models)
Work Packet	구조화된 실행 단위(goal / scope / forbidden / commands / verify / approval / evidence)	hephaistos/models.py
Runtime Mode	routing / budget / approval 을 실제로 바꾸는 operator 자세(Shift+Tab)	forgekit_provider.policy.runtime_mode

Hephaistos / Nexus / Armory 는 코어이지 슬래시 명령 하나가 아니다 — 콘솔은 그 projection 만 렌더한다.

---

현재 상태 (정직)

상태는 working / partial / planned / blocked 중 하나 — docs/operator-surfaces.md · docs/evidence-map.md.