fullstack-webapp-harness

name	fullstack-webapp-harness
description	웹앱, 대시보드, SaaS MVP, CRUD 서비스 요청을 처리하기 위한 Codex 메타 하네스 오케스트레이터. 요구사항 정리, 구조 설계, 프론트/백엔드 골격, QA 검토, 패키징, runtime handoff까지 연결한다.

Fullstack Webapp Harness

Execution Mode

문서 기반 Codex 메타 하네스 오케스트레이션.

Runtime Boundary

• meta harness owner: coreline-harness
• actual implementation runtime: https://github.com/coreline-ai/agent-team-module
• 이 스킬은 팀 구성을 정의하고 binding/handoff 를 정리하며, 실제 multi-agent 실행은 runtime에 넘긴다.

Agent Composition

• spec-analyst
• solution-architect
• frontend-builder
• backend-builder
• qa-reviewer
• operations-packager

Agent ↔ Extension Skill Binding

• spec-analyst → requirements-normalizer
• solution-architect → architecture-blueprint-starter
• frontend-builder → frontend-component-patterns
• backend-builder → backend-api-contracts
• qa-reviewer → release-readiness-checks
• operations-packager → deployment-packaging-guide

Workflow

1. 오케스트레이터가 _workspace/00_input.md 에 goal / 범위 / 가정을 먼저 고정한다.
2. spec-analyst 가 입력을 _workspace/01_requirements.md 로 정리한다.
3. solution-architect 가 구조를 _workspace/02_architecture.md 로 정리한다.
4. frontend-builder, backend-builder, operations-packager 가 병렬로 계획/패키지 문서를 작성한다.
5. 오케스트레이터가 BINDING_MAP.md, RUNTIME_BOOTSTRAP_MAP.md, .claude/ package 를 조립/정합성 확인한다.
6. 오케스트레이터가 VALIDATION.md 를 생성 또는 갱신한다.
7. qa-reviewer 가 누락/충돌/릴리스 준비 상태를 검토한다.
8. 문서화된 team/skill/binding 정보를 agent-team-module runtime 으로 handoff 한다.

Package Assembly Steps

• _workspace/00_input.md 생성
• root docs (README.md, BINDING_MAP.md, RUNTIME_BOOTSTRAP_MAP.md, VALIDATION.md) 정합성 확인
• .claude/agents/*.md 와 .claude/skills/*/skill.md를 binding 기준에 맞춰 조립
• package-level surfaced doc 과 _workspace/* artifact contract 경계 확인

Output Format Rules

_workspace/00_input.md

• goal 원문, 범위, 비범위, 기본 가정을 짧게 고정한다.

BINDING_MAP.md

• "Agent | Extension Skill | Primary Artifact | 실행 순서" 테이블을 포함한다.
• Artifact Handoff 순서를 번호 목록으로 정리한다.
• 의존 관계를 간결한 다이어그램 또는 텍스트로 보여준다.

RUNTIME_BOOTSTRAP_MAP.md

• Goal Contract: goal, domain pack, 범위/비범위, 기술 스택
• Team Contract: "Concrete Agent | Runtime Role | 역할 요약" 테이블
• Skill Contract: orchestrator + extension skill 목록 테이블
• Workspace Contract: 기대 산출물 파일 트리
• Handoff Readiness: 항목별 READY/NOT READY 상태 테이블

VALIDATION.md

• "산출물 | 필수 | 내용 기준" 테이블로 산출물별 검증 기준을 정리한다.
• Package/Agent/Skill/Runtime/Known Issue 카테고리별 체크리스트를 유지한다.

Completion Criteria

• 모든 Expected Meta Deliverables 가 생성되었다.
• BINDING_MAP 의 agent↔skill↔artifact 매핑에 누락이 없다.
• RUNTIME_BOOTSTRAP_MAP 의 Goal/Team/Skill/Workspace Contract 가 모두 채워졌다.
• VALIDATION.md 의 산출물별 내용 기준이 정의되었다.
• qa-reviewer 가 릴리스 준비 판정을 내렸다.

Data Transfer Protocol

• 입력 문서 → 요구사항 문서
• 요구사항 문서 → 아키텍처
• 아키텍처 문서 → frontend / backend / operations
• 구현 계획 문서 + 루트 패키지 문서 → qa-reviewer
• binding map + runtime bootstrap map → runtime handoff

Runtime Handoff Inputs

• goal summary
• concrete agent list
• extension skill list
• BINDING_MAP.md
• RUNTIME_BOOTSTRAP_MAP.md
• _workspace/* expected artifact paths

Validation / Review

• package assembly 이후 VALIDATION.md를 갱신한다.
• qa-reviewer는 must-fix / nice-to-have 를 분리한다.
• known runtime anomaly가 있으면 artifact-first inspection 규칙을 적용한다.

Error Handling

• 요구가 모호하면 MVP 기본안으로 축소
• 스택 미정이면 Next.js + TypeScript 기본안 적용
• QA 에서 치명적 누락 발견 시 리뷰 결과에 보류 표시

Test Scenarios

• "회원가입과 게시글 CRUD 가 있는 SaaS MVP"
• "관리자 대시보드 웹앱"
• "기존 웹앱에 새 모듈 추가"