title	FullOps Squad
status	draft
updated	2026-10-09
owner	maintainer
summary	Orca에서 AI worker의 배정, 문서, 검증, 리뷰를 관리하는 하네스 플러그인

FullOps Squad

Orca IDE에서 Claude Code·Codex·grok·agy를 역할별 worker로 운영하는 플러그인입니다. 작업 지시서와 결과를 Git 레포에 기록하고, 구현 결과를 lint와 독립 리뷰로 확인합니다.

Orca IDE가 필요합니다. 플러그인은 Orca 앱을 설치하지 않습니다. 설치는 CLI 사용자 범위에 적용됩니다. 서비스 레포의 .fullops-squad/를 만드는 setup은 별도로 요청합니다.

외부 의존성은 버전·commit을 고정하지 않고 최신판을 설치합니다. npm 도구는 @latest, 스킬은 공식 저장소의 최신 원문을 사용하며, 의존 플러그인은 마켓플레이스를 갱신한 뒤 설치·업데이트합니다. 명시적 설치·업데이트 요청마다 최신판을 확인하고, --check는 네트워크 업데이트 없이 실제 설치 상태를 검사합니다. 기존 스킬은 교체 전에 백업합니다.

작업 흐름

운영 모드는 coor와 dev입니다. 아래 흐름은 coor 기준이며, dev에서는 주 담당자가 사용자와 직접 기술 계획·구현·검증을 진행하고 필요한 전문가를 배정합니다. 직접 구현도 lint와 다른 세션의 고정 SHA 리뷰를 받습니다. 역할 ID·모델·effort와 운영 책임은 따로 관리합니다.

개발 테스트 비중과 하위 에이전트 활용 정도를 별도로 정합니다. 신규 setup 기본값은 두 설정 모두 lite입니다.

테스트 레벨	검증 범위
minimal	기동·변경 경로 스모크
lite	변경 핵심·필요한 실패 경계
standard	영향 범위 회귀
full	전체 회귀·필요한 통합·수락
exhaustive	full + 필요한 E2E·성능·장시간·환경 검수

선택형 하위 에이전트는 off(직접 작업), lite(읽기 전용 조사·리뷰, 동시 1개), standard(파일 소유권을 나눈 병렬 구현 포함, 2개), full(독립 작업을 넓게 병렬 처리, 4개)로 정합니다. 동시 개수는 부모가 관리하는 운영 예산입니다. 짧은 직렬 작업은 직접 처리하고, 하위 결과는 부모가 취합합니다. 하위 작업 기준을 따릅니다.

기존 설정 누락은 테스트 standard / 하위 에이전트 off를 유지합니다. 필수 검사·보안·데이터 손실 방지·독립 리뷰·최종 수락 조건은 모든 레벨에서 유지합니다. setup.py --repo <레포> --test-level lite --subagent-level lite로 선택하며 setup 안내를 따릅니다.

1. coordinator가 요청과 과제 키를 받습니다. 운영 작업은 직접 처리합니다.
2. 코드·산출물 작업은 Jev가 simple 또는 design으로 분류합니다. 담당 역할, 모델·effort, 갱신할 산출물도 추천합니다.
3. simple은 coordinator가 지시서를 씁니다. design은 설계 역할이 문서와 역할별 지시서를 씁니다.
4. worker는 자기 워크트리에서 구현·검증합니다. 질문은 coordinator에게 보내고 완료는 worker_done으로 보고합니다.
5. 병합 책임자는 고정 SHA의 lint·테스트·delegate 리뷰를 확인한 뒤 허가된 병합을 수행합니다.

역할은 레포마다 정합니다. 아래 ID는 예시입니다.

역할	책임
coordinator (coor)	배정, 질문 전달, 완료 보고 처리, 운영과 병합
설계 역할 (architecture)	요구사항·공유 계약과 지시서 작성. 현재 hook은 제품 코드 수정을 차단함
구현 역할 (dev)	지시서 범위의 기술 계획, 구현, 테스트와 문서 갱신
아트·운영 역할 (art, ops)	지정한 파일과 결과물 관리
검증 역할 (tester, 선택)	테스트와 증거 작성. 제품 코드는 수정하지 않음

역할·브랜치는 fullops.json, 책임·CLI·모델 후보는 orca-agents.md에 등록합니다. 모델 후보는 약한 것부터 강한 순서로 적습니다. Jev는 등록된 후보에서 선택합니다. 설계·coordinator·tester 역할은 라우팅 기준의 해당 줄로 지정합니다. 기본 coordinator는 기본 브랜치 체크아웃입니다. 역할 워크트리에서 coordinator를 운영하면 - coordinator 역할: <역할 ID>를 등록합니다.

제품 기획과 기술 계획 분리

제품 기획자가 목표·제품 규칙을 정하고, DEV가 기술 계획·구현·테스트를 함께 맡을 수 있습니다. orca-agents.md의 ## 라우팅 기준에 다음 줄을 추가합니다. 역할 ID는 fullops.json의 등록 역할을 사용합니다.

- 설계 역할: `designer`
- 제품 기획 역할: `designer`
- 기술 계획 역할: `dev`

제품 기획 역할과 기술 계획 역할은 서로 달라야 합니다. coordinator와도 분리합니다. 기술 난도가 높은 작업도 확정된 제품 요구 안에 있으면 implementation으로 담당 worker에 배정합니다. 제품 규칙 결정·범위 확대·불명확한 공유 제품 기준은 product로 기획자에게 배정합니다. 호출 실패·낮은 확신은 unresolved로 보류합니다. 담당 책임을 확인한 뒤 --override-role과 --reason으로 근거를 남깁니다. 기존 기록의 재선정은 --force로 원본을 보존합니다. 위 두 marker가 없으면 기존 simple/design 구조를 유지합니다.

역할을 바꿀 때 기존 fullops/* 브랜치를 재사용할 수 있습니다. 역할별 브랜치는 고유해야 합니다. 독립 리뷰는 별도 세션과 고정 SHA의 깨끗한 detached snapshot에서 진행합니다. 새 리뷰 기록은 구현자·검토자 세션 ID와 snapshot 경로를 검증합니다. 기존 리뷰 원본은 보존합니다. ART 직접 검수, 독립 동작 QA와 미해결 critical/high 차단도 유지합니다.

대기와 검증

착수를 확인한 뒤 coordinator는 orca_wait.py로 완료·질문·오류 메시지를 기다립니다. heartbeat·status는 스크립트가 흡수합니다. 정상 작업의 진행 확인은 기본 60분 간격입니다. worker_done과 오류·질문은 주기와 관계없이 처리합니다. 완료 보고의 과제 키·SHA·검증 요약·남은 일을 우선 확인합니다. 보고가 누락되거나 충돌·실패가 있으면 추가 근거를 읽습니다. 수락과 병합에서는 검증 게이트를 확인합니다.

도구	확인하는 것
fullops-test	코드·웹·Unity 검증. 웹 기본 Orca/현재 탭, 선택 Playwright, 모델 없는 회귀와 독립 checks. 실행기 계약
fullops-motion	선택형 모션그래픽 제작. HyperFrames/Remotion 공식 스킬, 로컬 렌더·클립 합성·검수·재렌더 인계
fullops-frontend	UI/UX 작업별 주 스킬·호스트/고정 모델 선택, 기존 디자인 정본·비평·브라우저 QA 연결
fullops-review	OCR CLI가 준비한 파일·규칙을 호스트 AI가 리뷰. 별도 OCR LLM API 키는 불필요
lint.py	프로젝트 검사·테스트 명령, 코드·디자인 경고, 변경 규모·의존성 선언, 억제·비밀값·문서 메타데이터
flow-gate	route 기록, worker-start --run, 역할별 행동과 완료 보고. 터미널 주입으로 배정하는 행동 차단
done-gate	이 세션의 코드 변경에 현재 HEAD의 lint 통과 기록이 없으면 종료를 한 번 차단

미해결 critical/high와 lint ERROR는 수락을 막습니다. 생성 현황판 파일은 done-gate의 코드 검사에서 제외합니다. hook은 셸 우회까지 차단하지 않으며 hook 자체의 오류는 작업을 막지 않습니다. done/flow hook의 실제 호출·오류는 작업 트리별 Git 디렉터리에 남습니다. 같은 오류 종류는 세션당 한 번 알리며, 기록이 없으면 실행 확인 불가입니다. 조회법은 lint 안내의 hook 실행 확인 절을 따릅니다. 리뷰 준비의 --lint <결과 JSON>은 같은 SHA·설정의 기존 실행 증거를 가져옵니다. 관련 환경·의존성이 같다는 근거를 확인하고, 역할이 바뀌었다는 이유로 테스트를 반복하지 않습니다. 자동 검사는 구현의 정확성을 보증하지 않습니다. 프로젝트 기준이 공통 규칙보다 우선합니다.

setup은 레포의 스택·기존 설정·패키지 스크립트에 맞춰 lint를 구성하고 실행 결과를 확인합니다. 새 설정은 기존 package.json의 대표 검사 명령을 자동 연결하며 기존 사용자 설정은 보존합니다. Tailwind v4 UI는 shadcn 디자인 lint를 서비스의 개발 의존성으로 연결할 수 있습니다. 상세 기준은 lint 안내에 있습니다.

문서와 검색

FullOps가 작성하는 기획·설계·실행 계획·핸드오버·컨텍스트·QA·리뷰 문서에 front matter를 등록합니다. 일반 문서는 title, status, updated, owner, summary를 사용합니다. 과제 문서는 tasks를 연결합니다. D01–D13 원천 문서에는 id를 추가합니다. 필요하면 upstream·downstream을 연결합니다.

문서는 한국어로 작성합니다. ASD-STE100의 짧은 문장, 명확한 주체, 일관된 용어, 실행 순서와 확인 가능한 결과 원칙을 적용합니다. 영어 통제 언어 표준의 공식 준수를 뜻하지 않습니다. 상세 기준은 문서 작성 규칙에 있습니다.

front matter는 설치된 플러그인의 도구로 씁니다. --path는 .fullops-squad/ 기준입니다.

# 일반 문서: 기존 본문을 보존한다.
python3 <플러그인>/scripts/deliverables.py --repo . --stamp --path docs/exec-plans/phases/TASK-1.md --owner dev --summary "로그인 실패 처리와 검증 결과" --task TASK-1
# D01–D13 원천: 인덱스 상태도 맞춘다.
python3 <플러그인>/scripts/deliverables.py --repo . --stamp --id D03 --owner architecture --summary "인증 모듈의 책임과 연결" --task TASK-1

work.py new는 핸드오버의 메타데이터를 생성합니다. 본문 첫 줄은 # <과제 키> — <목표>입니다. 기존 문서는 다음 수정 때 적용합니다. 빈 인박스·외부 원본 규칙·도구 로그는 보존합니다. 변경된 원천 문서는 lint DOC-002, 일반 FullOps 문서는 DOC-003으로 검사합니다. 코드 lint의 제외 설정과 별도로 검사합니다.

필요한 파일 찾기

jev_find.py는 커밋된 HEAD의 파일 지도에서 후보를 고릅니다. 문서는 front matter의 title·summary를 사용합니다. 메타데이터가 없는 기존 Markdown은 본문 제목을 사용합니다. 비밀 경로·심볼릭 링크·바이너리는 후보에서 제외합니다.

# 코드 검색: 하네스 파일은 제외한다.
python3 <플러그인>/scripts/jev_find.py find --repo . --role dev --key TASK-1
# 문서 검색: .fullops-squad 문서도 포함한다.
python3 <플러그인>/scripts/jev_find.py find --repo . --role dev --key TASK-1 --scope documents

결과는 각각 <과제 키>-find.json과 <과제 키>-documents-find.json에 남습니다. 별도 지시서에는 --handover .fullops-squad/handovers/<파일>.md를 지정합니다. 필요한 후보를 합친 뒤 jev_context.py가 관련성·근거·충돌·AI 지시문을 분류합니다. 추천이므로 필수 문서는 유지합니다. 코드와 문서 검색을 분리해 문서 후보가 코드 후보를 밀어내는 것을 방지합니다.

설치

필요 환경: Python 3.10+, Git 2.41+, Node.js 20.18.1+/npm/npx, 사용할 AI CLI, Orca IDE. 일반 설치는 GitHub 마켓플레이스를 사용합니다. 개발 체크아웃·agy 설치는 개발 문서를 따릅니다.

통합 설치기

통합 설치기는 Codex·Claude Code·grok의 설치 명령을 실행합니다. PATH에 있는 CLI를 자동으로 선택합니다. 플러그인은 각 CLI의 GitHub 마켓플레이스에서 설치합니다. 외부 의존성도 설치하고 검사합니다.

터미널에서 다음 명령을 실행합니다. @latest는 최신 설치기를 선택합니다.

npx --yes fullops-squad@latest install
npx --yes fullops-squad@latest update
npx --yes fullops-squad@latest check

기본 대상은 사용 가능한 세 CLI 전체입니다. --hosts codex,grok처럼 일부 CLI만 지정할 수 있습니다. --dry-run으로 변경 전에 실행 계획을 확인합니다.

npx --yes fullops-squad@latest update --dry-run
npx --yes fullops-squad@latest install --hosts codex,grok

Codex는 현재 CODEX_HOME, 기본 사용자 홈, 기존 Windows Orca 홈을 처리합니다. 다른 홈은 --codex-home PATH로 추가합니다. 설치나 업데이트가 끝나면 각 CLI에서 새 에이전트 세션을 엽니다.

업데이트 중 hook 경로: hook은 버전별 캐시 대신 ~/.fullops-squad/runtime/fullops-squad/scripts/hook_runtime.py를 호출합니다. deps.py --host <현재 CLI>가 패키지 전체를 캐시 밖에 보존하고 준비가 끝난 사본으로 전환합니다. 실행 중 hook은 기존 사본을 유지합니다. 호스트 자동 업데이트만 한 경우 마지막으로 준비한 실행 사본을 계속 사용하므로 새 패키지의 deps 설치·검사를 완료하세요. 최초 전환 전에 열린 세션은 삭제된 버전 경로를 기억할 수 있습니다. 작업을 저장한 뒤 별도 터미널에서 새 패키지의 scripts/deps.py --runtime-only를 실행하고 새 세션을 여세요. 이 명령은 외부 의존성을 재설치하지 않고 hook 실행 사본만 갱신합니다. 사용자 hook 설정에 직접 넣은 예전 절대 경로는 자동 수정하지 않습니다. 오류가 난 이벤트의 검증은 수행되지 않았으므로 기존 과제 검증 근거는 별도로 확인합니다.

update --repo PATH는 업데이트 전 설치 버전 이후의 레포 적용 안내를 출력합니다. 에이전트에게 해당 레포의 FullOps update를 요청하면 적용 작업을 진행합니다.

npx --yes fullops-squad@latest update --repo "D:/workspace/my-service"

설치기는 서비스 레포를 직접 변경하지 않습니다. 레포 적용은 에이전트가 릴리스 내용을 읽고 수행합니다. 설치기를 전역에 설치하려면 npm install --global fullops-squad@latest를 실행합니다. 이후 fullops-squad install|update|check 명령을 사용할 수 있습니다. 설치기 자체 갱신은 같은 npm 설치 명령으로 수행합니다. 아래 CLI별 명령으로 직접 설치할 수도 있습니다.

Claude Code

Claude Code 세션에서 실행합니다. 이미 등록된 마켓플레이스는 건너뜁니다.

/plugin marketplace add DietrichGebert/ponytail
/plugin marketplace add anthropics/claude-plugins-official
/plugin marketplace add tourbut/Fullops-Squad-plugin
/plugin install fullops-squad@fullops-squad

Codex

codex plugin marketplace add tourbut/Fullops-Squad-plugin
codex plugin add fullops-squad@fullops-squad

grok

grok plugin marketplace add tourbut/Fullops-Squad-plugin
grok plugin install fullops-squad@fullops-squad

외부 의존성

설치 뒤 OCR CLI·Context7 MCP와 외부 스킬을 설치합니다. dependencies.json이 설치 목록의 정본입니다. FullOps의 Context7은 라이브러리 문서 조회용 MCP입니다. OCR은 delegate 준비용 CLI입니다.

python3 <설치된 플러그인>/scripts/deps.py --host codex  # claude-code, grok, agy
python3 <설치된 플러그인>/scripts/deps.py --check --host codex  # 위와 같은 CLI

공통 스킬은 Claude Code·Codex·Grok Build 셋 모두에 설치하고, 호스트 전용 플러그인은 선택한 CLI에만 설치합니다. UI/UX 공통 스킬 네 개는 설치 후 fullops-frontend가 작업별로 주 스킬 하나와 필요한 검토만 호출합니다. 선택형 Playwright·Impeccable 엔진·shadcn 도구는 기본 설치에 포함되지 않습니다. 프런트엔드 도구 안내를 따릅니다.

에이전트에게 설치를 맡길 때는 다음 지시를 사용합니다.

FullOps Squad를 GitHub 마켓플레이스 tourbut/Fullops-Squad-plugin에서 설치해줘.
README의 설치 절에서 현재 CLI 명령을 따르고 설치된 scripts/deps.py로 의존성을 설치·확인해줘.
설치 버전과 실패한 명령을 보고해줘. 서비스 레포 setup은 내가 별도로 요청할 때 실행해줘.

설치 후 새 에이전트 세션을 엽니다. 설치만으로 서비스 레포를 활성화하지 않습니다.

업데이트

에이전트에게 FullOps update 수행해줘라고 요청하면 됩니다. update-fullops가 현재 설치 버전을 먼저 기록하고, 업데이트 뒤 그 이후의 릴리스 내용을 읽어 이 레포에 필요한 변경까지 수행합니다. 레포 적용이 설치보다 뒤처졌으면 미적용 릴리스도 함께 확인합니다.

현재 CLI에 해당하는 명령을 실행합니다.

claude plugin marketplace update fullops-squad
claude plugin update fullops-squad@fullops-squad

codex plugin marketplace upgrade fullops-squad
codex plugin add fullops-squad@fullops-squad

grok plugin marketplace update
grok plugin update fullops-squad

CLI별 직접 업데이트 후에는 설치된 새 패키지의 scripts/deps.py --host <현재 CLI>로 외부 의존성을 갱신하고, 설치 버전과 deps.py --check --host <현재 CLI>를 확인합니다. 단독 --check는 CLI 존재만 검사합니다. 실행 중인 세션은 이전 hook 경로를 사용할 수 있습니다. 작업을 정리한 뒤 새 세션으로 전환합니다. 다른 PC와 Orca가 별도로 사용하는 CLI 홈도 갱신해야 합니다.

레포에 적용

기본 브랜치 체크아웃에서 시작합니다. 역할·모델·원격이 정해졌으면 그 설정을 사용합니다. setup은 기존 문서를 덮어쓰지 않습니다. 필요한 기존 문서 변경은 템플릿과 비교해 반영합니다.

새 레포

이 레포에 FullOps Squad를 setup하고 Orca 워크트리를 구성해줘.
1. 기본 브랜치와 작업 트리를 확인하고 기존 변경을 보존해.
2. 역할·책임·파일 소유권을 제안해. 미정 역할과 모델 후보만 나에게 확인해.
3. setup-fullops의 dry-run을 확인한 뒤 확정한 역할로 실행해.
4. project.md에 기술 기준과 검증 명령을 적고 기존 lint 도구와 review 규칙을 연결해.
5. orca-agents.md에 CLI·모델 후보·라우팅 기준을 등록하고 board.json에 실제 단계를 적어.
6. 문서 작성 규칙을 적용하고 준비 파일을 커밋·push해.
7. fullops-orca bootstrap으로 역할 워크트리를 만들고 준비 커밋과 .env 연결을 확인해.
8. orchestration Run을 만들고 PLANS.md에 run id를 남겨.
9. 역할·워크트리·브랜치·run id·미정 사항을 보고하고 첫 요청을 기다려.

기존 레포·플러그인 업데이트

업데이트 전용 세션에서 실행합니다. 이 세션은 coordinator로 이어 쓰지 않습니다.

FullOps update 수행해줘.

설치 패키지에는 INSTALL.md와 releases/가 포함됩니다. 새 패키지의 scripts/update.py --repo <레포 루트> --from <업데이트 전 실제 설치 버전>은 해당 릴리스 본문과 수행할 내용을 출력합니다. 에이전트는 이를 읽고 적용 가능한 항목을 진행하며, 결과와 보류 사항을 .fullops-squad/docs/exec-plans/phases/FULLOPS-UPDATE-<대상 버전>.md에 남깁니다. 출력 스크립트 자체는 레포를 수정하지 않습니다.

fullops.json의 plugin_version은 레포 적용 버전입니다. 필수 적용과 관련 검증이 끝난 뒤 갱신합니다. 설치만 성공하거나 setup을 재실행한 상태는 적용 완료가 아닙니다. 기존 기록·제품 정지·진행 중 워크트리는 보존하고, 동기화는 안전한 시점에 수행합니다.

개발 요청

요청: <기능 또는 수정 내용>
과제 키: <예: PLAYER-JUMP-1>
fullops-orca route로 분류하고 dispatch해줘.

선택형 GitHub 이슈 작업

FullOps 활성 저장소에서 이슈 자동 작업 모드를 설정하고 현재 coor에서 켜줘라고 요청하면 fullops-issues가 저장소·허용 작성자·주기(기본 300초, 최소 60초)·작업 범위를 확인합니다. 기본 OFF이며 설치/setup으로 켜지지 않습니다. 로컬 폴러는 모델 호출 없이 수집하고, 동일 coor의 foreground wait로 하나씩 처리합니다. 완료 지점은 테스트/독립 리뷰를 통과한 draft PR이며 main 병합은 사용자 판단입니다. 질문은 원래 이슈에 보내고 원 작성자의 답변을 검토해 새 attempt로 재개합니다. 운영과 실환경 수용 검증을 참고합니다.

설정

원본 체크아웃의 .fullops-squad/.env.example을 .fullops-squad/.env로 복사합니다. .env와 API 키는 커밋하지 않습니다. 기존 레포에서도 ignore와 추적 여부를 확인합니다.

설정	기본값	의미
OPENROUTER_API_KEY	빈 값	Jev 호출용 OpenRouter 키
FULLOPS_WORKER_CHECK_MINUTES	60	정상 작업 확인 주기, 분
FULLOPS_WORKER_READY_TIMEOUT_SECONDS	90	worker 시작 준비 대기, 초
FULLOPS_WORKER_LOG_LIMIT	30	한 번 조회할 최근 메시지·줄 상한

운영 설정은 명령행(확인 주기만) → 프로세스 환경 변수 → 레포 .env → 기본값 순서입니다. orca_wait.py --repo . --settings는 운영 설정만 출력합니다. API 키를 보려고 .env 전문을 읽지 않습니다.

Jev

기본 모델은 ~typesafe/jev-latest입니다. OpenRouter의 System One API를 사용합니다. 키는 --env-file → OPENROUTER_API_KEY 환경 변수 → .fullops-squad/.env 순서로 찾습니다. 동일 요청은 ~/.cache/fullops-squad/jev에 캐시합니다. 비밀값으로 보이는 입력은 보내지 않습니다.

용도	실패·키 없음 처리
요청·역할·모델·산출물 라우팅	기존 구조는 설계 역할로 폴백. 제품/기술 분리 구조는 unresolved로 보류. 모델 폴백은 stderr 경고 확인
코드·문서 위치 탐색	검색으로 후보 보완
문서 관련성 분류	후보 유지
웹·Unity 조작 테스트	실패 근거 확인. 성공으로 처리하지 않음

jev_route.py --strict는 폴백 시 결과를 쓰지 않고 종료합니다. 재선정은 --force로 이전 결과를 보존합니다. simple 역할 수정은 --override-role <역할> --reason <근거>를 사용합니다. Solar Decide로의 기본 모델 교체는 포함하지 않습니다.

워크트리와 grok

env_link.py --all <원본 레포>와 SessionStart hook이 미추적 .fullops-squad/.env*를 워크트리에 연결합니다. 기존 파일은 덮어쓰지 않습니다. Windows의 심볼릭 링크에는 개발자 모드 또는 필요한 권한이 있어야 합니다. grok worker는 원본 레포의 폴더 신뢰가 필요합니다. grok_trust.py --repo <레포> --check로 확인합니다. 사용자가 허가하면 /hooks-trust 또는 --add로 등록합니다.

기록과 현황판

경로 (.fullops-squad/ 기준)	내용
FULLOPS.md, project.md, orca-agents.md	규약 지도, 프로젝트 기준, 역할·모델 배정
PLANS.md, board/board.json	과제와 프로젝트 단계
handovers/, contexts/	지시서·완료 기록, 역할별 결정과 교훈
docs/agents/document-writing.md	front matter와 한국어 문장 규칙
docs/planning/, docs/design-docs/, docs/exec-plans/	기획·설계·실행 계획
docs/evaluations/	Jev 결과, 테스트 시나리오, QA·리뷰 증거
docs/deliverables/README.md	D01–D13 원천 매핑과 상태
lint/, review/	검사 명령·규칙과 리뷰 템플릿

board/index.html에 단계·과제·완료 이력·리뷰·테스트·산출물이 표시됩니다. 저장소 이슈에는 열림·닫힘을 포함해 최근 업데이트 순 최대 30건의 번호·제목·상태가 표시됩니다. 항목을 누르면 GitHub 원문을 새 탭에서 엽니다. fullops.json.git.remote(없으면 origin)의 github.com 저장소를 사용합니다. 보드 생성 시 인증된 GitHub CLI(gh)로 최대 8초 동안 조회하며, 이슈 자동 작업 모드를 켜지 않습니다. 조회 시각을 함께 표시합니다. 페이지의 60초 새로고침은 생성된 데이터를 다시 읽으며 GitHub를 직접 조회하지 않습니다. 최신 이슈는 board.py --repo <레포> 실행 또는 coordinator 종료 때 가져옵니다. gh 없음·권한/네트워크 오류·오프라인 모드는 빈 목록과 구분해 표시하며 기존 보드의 다른 영역은 유지합니다. FULLOPS_OFFLINE=1에서는 조회하지 않습니다. 이슈 본문·인증 정보는 보드 데이터에 포함하지 않습니다. 산출물 카드와 단계 상세창에서 원천 문서를 열람합니다. 여러 파일은 제목·경로별로 선택하고, 미작성·누락 파일은 열람할 수 없는 상태로 표시합니다. 문서 본문은 board-data.js에 포함되므로 로컬 파일과 HTTP에서 모두 동작합니다. 문서를 연 동안에는 60초 새로고침을 보류합니다. 열람은 문서·단계 상태를 바꾸지 않습니다. Markdown의 제목·목록·표·코드·강조·외부 링크를 표시합니다. 원시 HTML은 텍스트로 표시하고, 수식·Mermaid는 원문을 보존합니다. 폴더 원천에서는 Markdown 문서를 모읍니다. coordinator는 board.json을 관리하고 board.py는 기록에서 board-data.js를 생성합니다. coordinator 종료 때 자동 갱신됩니다. 즉시 갱신하려면 board.py --repo .를 실행합니다. board-data.js는 커밋하지 않습니다. HTML 양식은 플러그인이 관리합니다.

참고

• 구조 다이어그램
• 변경 이력과 기존 레포 적용
• 개발·빌드·검증
• 문서 작성 규칙
• lint 규약