Keystone Operating Model
02 시스템 아키텍처 Markdown

Operating Model

사용자 요청을 계획, 실행, 검증, 기억, 회고로 연결하는 Keystone 운영 흐름

Source
src/content/docs/operating-model.md
Order
8

한눈에 보기

Operating Model은 사용자 요청이 KeystoneHub 안에서 어떤 경로로 흘러가는지 설명하는 중심 문서입니다. 요청을 바로 구현하지 않고, 목표와 경계, 계획, 실행, 검증, 기억, 회고로 나누어 다음 작업 품질까지 연결합니다.

이 문서에서 확인할 것

  • Intake부터 Evolution까지 이어지는 6단계 흐름
  • 각 단계에서 묻는 핵심 질문과 산출물
  • ai-rules, keystone-hub, keystone-portfolio의 역할 분담

요청에서 자가 발전까지

Operating Model은 Keystone 전체 메뉴의 중심입니다. 사용자 요청을 바로 구현으로 보내지 않고, 목표와 경계, 계획, 실행, 검증, 기억, 회고로 나눕니다.

flowchart LR
  A["01 Intake<br/>요청과 공개 경계"]
  B["02 AX Plan<br/>범위와 산출물"]
  C["03 Orchestration<br/>역할과 도구 선택"]
  D["04 Build & QA<br/>구현과 검증"]
  E["05 Memory<br/>결정과 증거 저장"]
  F["06 Evolution<br/>rule / skill / hook 후보"]

  A --> B --> C --> D --> E --> F --> B

단계별 판단

단계핵심 질문산출물
Intake무엇을 만들고, 무엇을 공개하지 않을 것인가?목표, 범위, 공개 경계
AX Plan어떤 단위로 실행할 것인가?plan pack, task graph, acceptance criteria
Orchestration어떤 에이전트와 도구가 필요한가?role assignment, skill/MCP/plugin 선택
Build & QA결과가 실제로 동작하는가?code, docs, tests, browser evidence
Memory다음 작업에서 다시 쓸 판단인가?decision note, fact, handoff
Evolution반복을 줄이기 위해 무엇을 승격할 것인가?rule, hook, skill, guide 후보

ai-rules와 keystone-hub의 역할

계층담당
ai-rules작업 원칙, 위험 등급, 에이전트 역할, sync 정책
keystone-hubhooks, commands, Codex skills, settings, doctor, eval runner
keystone-portfolio공개 가능한 설명, 결과, 다이어그램, 가이드

운영 원칙

  • 작업은 목표와 종료 조건을 먼저 정한다.
  • 자동화는 낮은 위험과 명확한 범위에서만 확장한다.
  • 사람 승인은 매번 묻는 것이 아니라 위험과 범위 기준으로 요청한다.
  • 검증 결과는 말이 아니라 증거로 남긴다.
  • 회고는 사과문이 아니라 다음 자동화 후보를 만드는 작업이다.

관련 메뉴

다음 메뉴연결 이유
AX Solution Orchestration계획을 실제 에이전트 작업 단위로 바꾼다
Evidence Dashboard검증 결과를 공개 가능한 증거로 요약한다
Retrospective Loop실패와 지연을 다음 규칙 후보로 보낸다
Capabilities실제 호출 가능한 작업 표면을 확인한다