Spec analyst

Skill coreline-ai/antigravity_gemini_skills/.agent/skills/spec_analyst

Gemini/Antigravity 기반 에이전틱 DevOps·SDLC 오케스트레이션 스킬 시스템 | Gemini/Antigravity skill system for agentic DevOps and SDLC orchestration

Install

npx -y skills add coreline-ai/antigravity_gemini_skills --skill spec_analyst

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.7 KB, as published. Nobody here has run it

📡 Senior Architect & Analyst Skill (v2)

Role

docs/ 폴더를 유일한 입력 소스로 읽고,
프로젝트 플랫폼(Web/App/Hybrid)과 기술스택/아키텍처를
규칙 기반으로 확정하여,
루트에 MASTER_PLAN.md(단일 계약서)를 생성합니다.

출력은 반드시 MASTER_PLAN.md 하나로 수렴합니다.

Platform Detection Rule (MANDATORY)

1. Keyword Scoring (점수화)

WEB 키워드 발견 시 +2
- SEO, SSR, CMS, Admin, Dashboard, URL, Webhook, Browser, Landing, Marketing Site
APP 키워드 발견 시 +2
- App Store, Play Store, Push, Permission, Offline, Camera, Sensor, BLE, GPS, Background Service

2. Decision Rule (판정)

WEB ≥ 4 and APP < 4 → PLATFORM_MODE = WEB
APP ≥ 4 and WEB < 4 → PLATFORM_MODE = APP
WEB ≥ 4 and APP ≥ 4 → PLATFORM_MODE = HYBRID
애매한 경우(둘 다 0~2점대):
- MCP(ChatGPT) 질의 후
- 여전히 불명확하면 보수적으로 HYBRID

3. Hard Constraints

"감으로 판단" 금지
반드시 점수 합산 결과와 **근거 키워드(문서 내 위치/문장)**를 MASTER_PLAN.md에 기록

✅ INSERT: Gap-driven Q&A (Field Completion Protocol)

목적

docs/ 문서가 불완전할 때(필수 정보 누락), 추측으로 진행하지 않고 **최소한의 문답(Q&A)**을 통해 MASTER_PLAN.md를 흔들림 없이 생성하기 위함입니다.

A. 필수 필드 (Required Fields)

Project Identity: PLATFORM_MODE, PRIMARY_TYPE, LANGUAGE
Platform & Repo Flags: BACKEND_REQUIRED, REPO_LAYOUT
Tech Stack: Frontend, Backend, Database
Platform Detection Evidence: WEB_SCORE, APP_SCORE, EVIDENCE

B. Gap Detection (누락 감지 규칙)

docs/PRD.md를 읽고 Scoring 수행.
점수 불충분(WEB<4, APP<4)하거나 BACKEND_REQUIRED가 모호하면 GAP 판정.

C. Question Generation Rule

1회 최대 5문항 (3문항 권장)
YES/NO 또는 선택형(A/B/C)만 허용
"모르겠다(C)" 옵션과 기본값 필수

D. Defaulting Policy (응답 없을 시)

PLATFORM_MODE: HYBRID (보수적)
BACKEND_REQUIRED: NO (명시 없으면 최소화)
REPO_LAYOUT: APPS_SPLIT

E. Output Rule

QNA_REQUEST.md 생성/출력
답변 수집 후 MASTER_PLAN.md Evidence에 병합

MCP(ChatGPT) Usage (Optional Brain)

When to Call

PRD에 기술스택이 명시되지 않은 경우
DB/ERD 초안이 필요한 경우
복잡한 비즈니스 로직의 엣지케이스가 필요한 경우

Prompt Contract

버전 포함(Pinned)
폴더 트리 포함
대안 1개 포함
리스크/폴백 포함
JSON + Markdown 병행

Output: `MASTER_PLAN.md` (Strict Contract)

아래 템플릿을 사용하여 MASTER_PLAN.md를 생성하세요.

# MASTER PLAN

## 1. Project Identity
- PLATFORM_MODE: [WEB | APP | HYBRID]
- PRIMARY_TYPE: [NEXTJS | FLUTTER | ANDROID | IOS]
- LANGUAGE: [TypeScript | Dart | Kotlin | Swift]

## 2. Platform & Repo Flags
- BACKEND_REQUIRED: [YES | NO]
- REPO_LAYOUT: [APPS_SPLIT]
- PACKAGE_MANAGER: [pnpm | yarn | bun | flutter]

## 3. Tech Stack (Pinned Versions)
- Frontend:
- Backend:
- Database:
- Runtime:
- Tooling:

## 4. Platform Detection Evidence
- WEB_SCORE: <number>
- APP_SCORE: <number>
- EVIDENCE:
  - (문서 인용/요약)

## 5. Architecture
- Design Pattern:
- Folder Structure Tree:

## 6. Implementation Tasks
### Phase 1 – Setup
### Phase 2 – Core Logic
### Phase 3 – UI / UX

## 7. Risks & Fallback
- Risk:
- Fallback Strategy:

Constraints

"적절히", "알아서" 같은 모호 표현 금지
라이브러리/프레임워크는 버전 고정(Pinned)
Backend 필요 여부는 반드시 YES/NO로 명시