Soulforge

Soulforge는 일곱 개의 canonical root 와 project-local materialization 정책을 고정하는 설계 저장소다. 루트는 owner 경계, public/private tracking 원칙, 파생 UI 계약을 관리한다. 현재 보유한 mission plan 은 .mission/ 이 들고, cross-project 운영 ingress/state 는 guild_hall/ 이 들고, 실제 프로젝트 현장 데이터는 _workspaces/<project_code>/ 에, private runtime truth 와 project metadata 는 Soulforge root 아래 nested private repo _workmeta/<project_code>/ 에 둔다.

정본 7축

• .registry: outer canon/store
• .unit: active agent unit owner
• .workflow: orchestration canon
• .party: reusable orchestration template
• .mission: held mission plan owner
• guild_hall: cross-project operations root
• _workspaces: project-local materialization site

구조 개요도

flowchart TD
  S["Soulforge"] --> R[".registry<br/>outer canon/store"]
  R --> RS["species<br/>species.yaml + heroes inline"]
  R --> RC["classes<br/>canon entry + refs"]
  R --> RK["skills / tools / knowledge"]
  S --> U[".unit<br/>active agent unit owner"]
  S --> W[".workflow<br/>independent orchestration canon"]
  S --> PT[".party<br/>independent orchestration template"]
  S --> MI[".mission<br/>held mission plan"]
  S --> GH["guild_hall<br/>cross-project operations root"]
  S --> M["_workspaces<br/>project-local materialization site"]
  S -.-> WM["_workmeta<br/>nested private metadata root"]
  S --> D["docs/architecture<br/>root-owned canon docs"]
  S --> UI["ui-workspace<br/>derived UI consumer workspace"]
  MI --> MP["mission.yaml / readiness.yaml<br/>resolved plan owner"]
  GH --> GHS["state/**<br/>local-only gateway / town_crier / night_watch"]
  M --> PR["<project_code><br/>actual project files"]
  WM --> PA["<project_code><br/>project metadata, bindings, and run truth"]

Loading

상위 지도

• docs/architecture/foundation/VISION_AND_GOALS.md: Soulforge의 비전, 목표, 성공 조건
• .registry/README.md: .registry skeleton 과 owner 경계
• docs/architecture/foundation/TARGET_TREE.md: 새 canonical target tree
• docs/architecture/foundation/DOCUMENT_OWNERSHIP.md: 새 owner 기준 문서 소유 원칙
• docs/architecture/foundation/ONTOLOGY_MODEL_V0.md: Soulforge 개체/관계 모델과 ontology-style 저장 위치 규칙
• docs/architecture/foundation/ONTOLOGY_REVIEW_MANUAL_V0.md: ontology review 트리거, carry-forward, guild_master 상기 규칙
• guild_hall/README.md: cross-project 운영 루트와 state 경계
• docs/architecture/guild_hall/README.md: guild_hall owner 기준 문서 색인
• docs/architecture/guild_hall/SOULFORGE_ACTIVITY_LOG_V0.md: Soulforge 전체 활동 로그 surface 와 recent-context 읽기 규칙
• docs/architecture/guild_hall/NIGHT_WATCH_AUTOMATION_V0.md: 길마 새벽 점검 자동화 후보와 Codex app local automation 경계
• docs/architecture/bootstrap/README.md: clone 이후 설치, doctor, private state restore 가이드 묶음
• CHANGELOG.md: public repo revision note 와 patch note
• docs/architecture/foundation/CHANGELOG_POLICY_V0.md: public/private changelog 작성 규칙
• docs/architecture/bootstrap/BOOTSTRAP_PROFILES_V0.md: public-only, operator, owner-with-state bootstrap 프로필
• docs/architecture/bootstrap/UPDATE_MANUAL_V0.md: 설치 후 GitHub 최신 상태 확인, public/private pull, skill sync, doctor 재점검 절차
• docs/architecture/bootstrap/OWNER_HANDOFF_CHECKLIST_V0.md: 회사/집 사이 owner handoff 체크리스트와 시작 전 doctor --remote 절차
• CONTRIBUTING.md: public repo 변경 전 기본 validate/done:check 와 문서 동기화 규칙
• SECURITY.md: 공개 저장소 보안 경계와 비공개 제보 원칙
• _workspaces/README.md: _workspaces local-only mount point 정책
• docs/architecture/workspace/WORKSPACE_PROJECT_MODEL.md: _workspaces/<project_code>/ 구조와 보안 경계
• docs/architecture/workspace/INSTALLATION_MANUAL_V0.md: 다른 PC 첫 설치와 gateway bootstrap 순서
• docs/architecture/workspace/MULTI_PC_DEVELOPMENT_V0.md: 다른 PC clone, local state materialization, Git push/pull 운영 절차
• docs/architecture/workspace/PRIVATE_STATE_REPO_V0.md: 선택된 운영 기록만 별도 private Git 으로 mirror 하는 기준
• docs/architecture/workspace/GATEWAY_MAIL_FETCH_V0.md: gateway mailbox fetch capsule 과 local state 경계
• docs/architecture/workspace/GATEWAY_NOTIFY_V0.md: Telegram outbound notify 최소 캡슐 경계
• docs/architecture/workspace/NOTIFY_MODEL_V0.md: gateway local policy 와 mission notify toggle owner 경계
• docs/architecture/workspace/NOTEBOOKLM_MCP_SETUP_V0.md: 다른 PC NotebookLM MCP 재설치 기준
• docs/architecture/README.md: root-owned architecture 문서 색인
• ui-workspace/README.md: UI consumer workspace 개요

루트 정본 규칙

• 루트 README.md 는 상위 지도만 유지한다.
• .registry 는 outer canon/store owner 다.
• Soulforge 핵심 개념은 ontology-style 로 읽되, 규칙은 public foundation 문서에 두고 project-local instance 는 _workmeta/<project_code>/ontology/ 에서만 둔다.
• .unit 는 active agent unit owner 다.
• .workflow 와 .party 는 .registry 아래로 넣지 않는 독립 orchestration root 다.
• .mission 은 held mission plan 과 readiness owner 다.
• guild_hall 은 gateway, doctor, town_crier, night_watch, dungeon_assignment 같은 cross-project 운영 owner 다.
• clone 된 PC bootstrap readiness 점검은 npm run guild-hall:doctor 를 canonical entrypoint 로 사용한다.
• root canon 과 public-safe harness 검증은 npm run validate, npm run done:check 를 canonical entrypoint 로 사용한다.
• cross-project 운영 명령 표면은 guild-hall:* 만 canonical 로 사용한다.
• guild_hall/state/** 는 local-only cross-project state 이며 public repo 에 올리지 않는다.
• 기능 코드, 구조 문서, public-safe sample 변경은 public repo 에 commit/push 한다.
• 보호 대상 업무 데이터는 project-local metadata 면 Soulforge root 아래 nested _workmeta/ repo 에, cross-project continuity data 면 nested private-state/ repo 에만 commit/push 한다.
• species canon 은 species/<species_id>/species.yaml 와 heroes: inline 모델을 사용한다.
• _workspaces/<project_code>/ 실제 과제 내용은 public GitHub 에 올리지 않으며, 로컬 환경에서만 materialize 한다.
• _workmeta/<project_code>/ 는 Soulforge root 아래 nested private repo 이다.
• assigned execution plan 과 mission-level 배정 owner 는 _workspaces/ 나 _workmeta/ 가 아니라 .mission/ 이 소유한다.
• tracked workspace sample 은 _workspaces/ 아래가 아니라 docs/architecture/workspace/examples/ 아래로만 둘 수 있다.
• .run/ 루트는 새 정본에 포함하지 않는다.
• 상세 owner 규칙은 각 루트 README.md 와 docs/architecture/** 문서를 따른다.