coreline-harness

coreline-harness

범용 문서형 메타 하네스 워크스페이스
작업 해석, domain pack 선택, agent/skill binding, artifact/validation contract를 정의하는 프로젝트입니다.

한눈에 보기

coreline-harness는 실행 엔진이 아니라 메타 하네스입니다.

이 저장소가 하는 일:

요청을 어떤 문제 유형으로 해석할지 정의
어떤 domain pack / generic role / concrete agent가 필요한지 정의
어떤 skill이 어떤 agent에 바인딩되는지 정의
어떤 artifact / validation / completion state가 필요한지 정의
runtime handoff 가능한 문서 패키지 구조를 유지

이 저장소가 하지 않는 일:

runtime preset / parser / prompt injection 구현
coreline-agent-team 내부 runtime 코드 운영

런타임 범위

계층	범용 여부	설명
메타 하네스 스킬	범용	Claude Code, Codex, Antigravity 등 어떤 LLM 런타임에서도 실행 가능
agent-team 실행	Codex CLI 전용	`coreline-agent-team`은 `codex exec` subprocess 기반이므로, multi-agent 팀 실행에는 Codex CLI 필수

현재 상태

프로젝트 상태 요약

항목	상태	설명
메타 하네스 본 기능	완성	범용 핵심 모델, 문서 계약, completion state, fixture policy, temporal dependency 규칙
확장 규칙 보강	완성	skill_builder 매핑, generic role split, operations-agent 기준이 canonical contract로 승격됨
품질 마감 정리	완성	canonical hierarchy, entry 문서 정합성, checklist 마감, runtime freshness 문구 정리 완료
도메인 팩	2개 완성	`fullstack-webapp` + `seo-optimization`
테스트 검증	3회 PASS	쇼핑몰 MVP, 관리자 대시보드, 중소 이커머스 SEO
`sample-fullstack-webapp`	validated reference fixture	대표 reference package (6 agents, 7 skills)
`sample-seo-optimization`	validated reference fixture	SEO 전략/진단용 reference package (6 agents, 7 skills)
`test-run/`	handoff-ready fixture	쇼핑몰 MVP 메타 계약 검증 fixture
`test-run-dashboard/`	handoff-ready fixture	관리자 대시보드 범용성 검증 fixture
`test-run-seo/`	handoff-ready fixture	중소 이커머스 SEO 도메인 팩 검증 fixture
runtime 실행단	backlog	별도 workstream으로 분리됨
배포 판정	release-ready with notes	문서형 메타 하네스 저장소 기준 배포 가능, runtime 실운영은 별도

참고:

fixture / sample은 검증용 evidence package이며, canonical source of truth는 PRD.qmd, SKILL.md, refs/* 문서 계층이다.

도메인 팩

도메인 팩	에이전트	스킬	트리거 예시
`fullstack-webapp`	6 (spec-analyst, solution-architect, frontend-builder, backend-builder, qa-reviewer, operations-packager)	7 (1 orchestrator + 6 extension)	"웹앱 만들어줘", "SaaS MVP", "관리자 대시보드"
`seo-optimization`	6 (seo-auditor, keyword-strategist, on-page-optimizer, technical-seo-eng, link-strategist, seo-reviewer)	7 (1 orchestrator + 6 extension)	"SEO 진단해줘", "검색 최적화", "키워드 전략"

상위 카테고리 vs concrete domain pack

coreline-harness는 상위 카테고리와 concrete domain pack을 구분합니다.

구분	역할	예시
상위 카테고리	문제 영역을 넓게 묶는 분류	`web`, `content`, `growth`
concrete domain pack	실제 trigger / role / skill / artifact contract를 가진 실행 가능한 규칙 묶음	`fullstack-webapp`, `seo-optimization`

즉 fullstack-webapp와 seo-optimization는 둘 다 넓게 보면 web 계열이지만, 동일한 pack으로 합치지 않습니다. 이유는 아래가 다르기 때문입니다.

trigger 유형
required generic role
concrete agent topology
artifact contract
validation focus

따라서 현재 구조는 하나의 상위 카테고리 아래 여러 concrete domain pack이 공존하는 방식으로 이해하는 것이 맞습니다.

테스트 검증 이력

테스트	도메인 팩	산출물	결과
`test-run/` (쇼핑몰 MVP)	fullstack-webapp	9개 문서, 989줄	PASS
`test-run-dashboard/` (관리자 대시보드)	fullstack-webapp	9개 문서, 912줄	PASS
`test-run-seo/` (중소 이커머스 SEO)	seo-optimization	9개 문서, 521줄	PASS

기준 문서 우선순위

순서	문서	역할
1	`dev-plan/PRD.qmd`	목적/범위의 최상위 기준
2	`dev-plan/implement_20260406_220119.md`	메타 하네스 본 기능 canonical workstream
3	`dev-plan/implement_20260411_111211.md`	확장 규칙 보강 canonical supplement
4	`SKILL.md`	메타 하네스 개념 진입점
5	`docs/meta-harness-document-contracts.md`	문서 계약 정의
6	`docs/meta-harness-completion-state-model.md`	완료 상태 모델
7	`refs/*`	계약 계층 (domain packs, agents, skills)
8	`README.md`, `AGENTS.md`	진입/운영 가이드
9	`generated/`, `test-run`	fixture / sample

참고:

README.md와 AGENTS.md는 중요 entry 문서지만, canonical contract 자체보다 안내/운영 가이드 성격이 우선한다.
확장 규칙 관련 판단은 implement_20260411_111211.md와 refs/* 계층이 더 상위 기준이다.

제공 범위

핵심 문서

dev-plan/PRD.qmd — 목적/범위 기준
dev-plan/implement_20260406_220119.md — 메타 하네스 본 기능 canonical workstream
dev-plan/implement_20260411_111211.md — 확장 규칙 보강 canonical supplement
dev-plan/implement_20260411_114357.md — 품질 마감 정리 closeout workstream
SKILL.md — 메타 하네스 진입점
AGENTS.md — 작업 원칙
CHANGELOG.md — tracked workstream 기준 변경 이력

계약 계층

refs/domain_packs/ — fullstack-webapp, seo-optimization + 인터페이스 정의
refs/domain_packs/domain_pack_interface.md — generic role split / operations-agent decision의 상위 규칙
refs/agents/ — generic role 정의 (spec, architecture, implementation, review, operations)
refs/skill_builders/ — composite skill 내부 분해 규칙
refs/skill_builders/skill_builder_mapping_rules.md — builder category ↔ composite extension skill 매핑 규칙
refs/skills/ — skill contract (base, orchestrator, extension)

검증 문서

docs/generation-validation-checklist.md — 생성물 검증 체크리스트
docs/meta-harness-document-contracts.md — 문서 계약
docs/meta-harness-completion-state-model.md — 완료 상태 모델
docs/runtime-integration.md — runtime handoff 계약
docs/handoff-bundle-contract.md — runtime handoff bundle schema
docs/runtime-execution-playbook.md — planner-first 실행 절차

fixture / sample

generated/sample-fullstack-webapp/ — fullstack 대표 validated reference fixture
generated/sample-seo-optimization/ — SEO 대표 validated reference fixture
test-run/ — 쇼핑몰 MVP handoff-ready fixture
test-run-dashboard/ — 관리자 대시보드 handoff-ready fixture
test-run-seo/ — 이커머스 SEO handoff-ready fixture

저장소 구조

coreline-harness/
├── AGENTS.md
├── CHANGELOG.md
├── README.md
├── SKILL.md
├── pyproject.toml
├── .gitignore
├── .claude/                          # Claude Code 편의 기능 (hooks 등)
├── dev-plan/
│   ├── PRD.qmd                       # 최상위 목적/범위 문서
│   ├── implement_20260405_195418.md  # v1 기본 구조
│   ├── implement_20260406_212756.md  # v2 runtime 연동 계획
│   ├── implement_20260406_220119.md  # 메타 하네스 본 기능 workstream
│   ├── implement_20260407_215432.md  # 로컬 topic batch 01~10 심화(archive)
│   ├── implement_20260408_200001.md  # 로컬 topic batch 11~15(archive)
│   ├── implement_20260408_203530.md  # 로컬 topic batch 추가 리뷰(archive)
│   ├── implement_20260408_211500.md  # 로컬 topic batch 16~20(archive)
│   ├── implement_20260408_214201.md  # runtime backlog 재개 계획(archive)
│   ├── implement_20260411_091432.md  # contract drift 보정(archive)
│   ├── implement_20260411_104200.md  # generator fidelity 보강(archive)
│   ├── implement_20260411_110347.md  # 31~35 리뷰 반영(archive)
│   ├── implement_20260411_111211.md  # 확장 규칙 보강 canonical supplement
│   └── implement_20260411_114357.md  # 품질 마감 정리 closeout workstream
├── docs/                             # 아키텍처, 검증, runtime, 계약 문서
├── refs/
│   ├── domain_packs/                 # fullstack-webapp, seo-optimization, 인터페이스
│   ├── agents/                       # 5개 generic role 정의
│   ├── skill_builders/               # 내부 분해 규칙
│   └── skills/                       # skill contract 3종
├── templates/                        # 패키지 생성 템플릿
├── generated/
│   ├── sample-fullstack-webapp/      # fullstack 대표 패키지
│   ├── sample-seo-optimization/      # SEO 대표 패키지
│   ├── agent-team-smoke/             # runtime smoke 증적 1차
│   └── agent-team-smoke-2/           # runtime smoke 증적 2차
├── test-run/                         # 쇼핑몰 MVP fixture
├── test-run-dashboard/               # 관리자 대시보드 fixture
├── test-run-seo/                     # 이커머스 SEO fixture

계약 보강 이력

보강 항목	반영 위치	내용
temporal dependency 규칙	`refs/skills/agent_extension_skill_contract.md`	Inputs는 선행 산출물만, 후행 support artifact는 Downstream Handoff로
Output Format Rules	6개 extension skill + orchestrator	마크다운 테이블, Handoff Note, 용어 참조
기술 선택 근거 규칙	architecture, frontend, backend skill	"선택 \| 대안 \| 이유" 기록
QA 항목 대조 규칙	release-readiness-checks skill	02↔03, 02↔04 항목 단위 대조
용어 일관성 규칙	architecture skill	핵심 용어/enum 정의, 이후 문서 참조
generation validation	`docs/generation-validation-checklist.md`	binding order 기준 temporal dependency 검증

릴리즈 노트 / 변경 이력 운영 방식

tracked 문서/계약 변경은 workstream 종료 단위로 CHANGELOG.md에 기록한다.
각 엔트리는 기본적으로 날짜 + 범위 + Changed / Notes 구조를 따른다.
canonical contract에 영향을 주는 변경은 관련 implement_*.md와 함께 추적한다.
비추적 evidence나 외부 runtime 저장소 변경은 기본적으로 이 저장소 changelog의 직접 범위에 넣지 않는다.

runtime freshness / 재검증 정책

docs/runtime-integration.md는 latest truth가 아니라 pinned truth다.
현재 공개 runtime surface는 2026-04-05 / coreline-agent-team HEAD 4e2aa961164c113105938575e27baecffbef6959 기준으로 검증됐다.
아래 중 하나가 발생하면 runtime integration 재검증이 필요하다.
- 공개 HEAD 변경
- 상위 CLI surface(doctor, app, run, attach, watch, tui) 변경
- bootstrap role / preset / workspace 규칙 변경
- runtime backlog workstream 재개 시
상세 기준과 최소 smoke 절차는 docs/runtime-integration.md를 따른다.

다음 우선순위

docs/runtime-integration.md 기준 runtime surface 재검증 트리거가 발생했는지 주기적으로 확인
tracked 문서/계약 변경을 CHANGELOG.md 기준으로 workstream 단위 기록 유지
그 이후 runtime 실행단 backlog를 새 workstream으로 열지 판단

외부 runtime 경계

실제 multi-agent runtime: https://github.com/coreline-ai/coreline-agent-team
coreline-harness는 실행기가 아니라, runtime에 넘길 판단/계약/패키지 구조를 관리합니다.
메타 하네스 스킬은 범용 (어떤 LLM에서든 실행 가능)
agent-team 실행은 Codex CLI 전용 (Codex CLI 없이 multi-agent 실행 불가)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

coreline-harness

한눈에 보기

런타임 범위

현재 상태

프로젝트 상태 요약

도메인 팩

상위 카테고리 vs concrete domain pack

테스트 검증 이력

기준 문서 우선순위

제공 범위

핵심 문서

계약 계층

검증 문서

fixture / sample

저장소 구조

계약 보강 이력

릴리즈 노트 / 변경 이력 운영 방식

runtime freshness / 재검증 정책

다음 우선순위

외부 runtime 경계

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 18 Commits
.claude		.claude
.codex-state		.codex-state
dev-plan		dev-plan
docs		docs
generated		generated
refs		refs
scripts		scripts
templates/harness-package/.claude		templates/harness-package/.claude
test-run-dashboard		test-run-dashboard
test-run-seo		test-run-seo
test-run		test-run
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
SKILL.md		SKILL.md
pyproject.toml		pyproject.toml

Folders and files

Latest commit

History

Repository files navigation

coreline-harness

한눈에 보기

런타임 범위

현재 상태

프로젝트 상태 요약

도메인 팩

상위 카테고리 vs concrete domain pack

테스트 검증 이력

기준 문서 우선순위

제공 범위

핵심 문서

계약 계층

검증 문서

fixture / sample

저장소 구조

계약 보강 이력

릴리즈 노트 / 변경 이력 운영 방식

runtime freshness / 재검증 정책

다음 우선순위

외부 runtime 경계

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages