Ouroboros + Superpowers

명시적 요청 시에만 사용. 트리거: '우로보로스/ouroboros'(인터뷰→스펙), '슈퍼파워/superpowers'(계획→실행), '스펙부터/풀플로우'(전체).

Security Scan

The skill is an instruction-only developer workflow (interview → spec → plan → execute → verify) and its requirements and instructions are consistent with that purpose.

Purpose & Capability

Name/description match the content: a dev workflow combining an interview/spec phase (Ouroboros) with planning/execution (Superpowers). The operations it prescribes (writing specs/plans, breaking work into tasks, running tests, committing code, using sub-agents) are coherent with a development helper skill.

Instruction Scope

SKILL.md instructs the agent to generate files (docs/specs, docs/plans, code/tests), run TDD cycles, perform commits, and dispatch/coordinate sub-agents. Those actions align with the stated purpose, but they imply the agent will create/modify repository files and may execute build/test steps — the user should confirm the agent is allowed to modify code and run tests in the target environment.

Install Mechanism

No install spec and no code files are present (instruction-only). This is low-risk: nothing is downloaded or written by an installation step.

Credentials

The skill requests no environment variables, credentials, or config paths. There is no disproportionate credential access for the described functionality.

Persistence & Privilege

Flags are default (always: false, user-invocable, model invocation allowed). The skill does not request permanent presence or special privileges and does not modify other skills' configurations.

Assessment

This skill is internally consistent and appears to be a pure workflow/template for development work. Before installing/using it, confirm you are comfortable with an agent that will: create and modify repo files (docs/specs, plans, tests, code), run test/build steps, commit changes, and spawn/coordinate sub-agents. Ensure the agent’s repository and CI permissions are limited as you intend, review any generated commits or pull requests before merging, and avoid granting extraneous credentials (none are required by the skill). If you want tighter control, require manual confirmation before execution or disable sub-agent dispatching.

Dev Workflow - Ouroboros + Superpowers 통합

트리거별 시작점

트리거	시작	끝	용도
"우로보로스", "ouroboros"	Phase 1	Phase 2	스펙만 정리
"슈퍼파워", "superpowers"	Phase 3	Phase 5	계획+실행 (스펙 있을 때)
"스펙부터", "풀플로우", "전체"	Phase 1	Phase 5	처음부터 끝까지

---

전체 플로우

[Phase 1-2: Ouroboros]        [Phase 3-5: Superpowers]
질문 → 스펙                    계획 → 실행 → 검증

---

Phase 1: 소크라테스 인터뷰 (Ouroboros)

목표: 숨겨진 가정을 노출하고 모호성을 제거

규칙

• 한 번에 질문 하나만
• "~하면 되죠?"가 아닌 "~는 무엇인가요?" (존재론적 질문)
• 객관식 선호, 필요시 주관식
• 최소 3-5개 질문으로 핵심 파악

질문 프레임워크

1. 본질 (Essence): "이것의 본질은 무엇인가요?"
2. 근본 원인 (Root Cause): "이게 근본 원인인가요, 증상인가요?"
3. 전제 조건 (Prerequisites): "이를 위해 먼저 존재해야 하는 것은?"
4. 숨겨진 가정 (Hidden Assumptions): "우리가 당연시하는 가정은?"

모호성 점수 (Ambiguity Score)

인터뷰가 끝나면 내부적으로 평가:

• 목표 명확성 (Goal): 40%
• 제약 조건 명확성 (Constraints): 30%
• 성공 기준 명확성 (Success Criteria): 30%

Ambiguity ≤ 0.2 일 때만 다음 단계로 진행. (80% 이상 명확해야 스펙 작성 가능)

---

Phase 2: 스펙 결정화 (Seed)

인터뷰 결과를 불변 스펙으로 결정화:

# [기능명] 스펙

## 목표
[한 문장으로 정의]

## 범위
### 포함
- ...
### 제외 (YAGNI)
- ...

## 핵심 컴포넌트
1. [컴포넌트]: [책임]
2. ...

## 데이터 흐름
[입력] → [처리] → [출력]

## 성공 기준
- [ ] ...
- [ ] ...

## 제약 조건
- ...

## 열린 질문 (있다면)
- ...

저장 위치: docs/specs/YYYY-MM-DD-<topic>.md

---

Phase 3: 구현 계획 (Plan)

스펙을 바이트 사이즈 태스크로 분해:

태스크 원칙

• 각 태스크는 2-5분 분량
• TDD: 테스트 작성 → 실패 확인 → 구현 → 통과 확인 → 커밋
• 정확한 파일 경로와 코드 포함
• DRY, YAGNI 준수

계획 구조

# [기능명] 구현 계획

**목표:** [한 문장]
**아키텍처:** [2-3문장]

---

### Task 1: [컴포넌트명]

**파일:**
- 생성: `path/to/file.ts`
- 테스트: `tests/path/to/test.ts`

- [ ] Step 1: 실패하는 테스트 작성
- [ ] Step 2: 테스트 실행, 실패 확인
- [ ] Step 3: 최소 구현
- [ ] Step 4: 테스트 통과 확인
- [ ] Step 5: 커밋

저장 위치: docs/plans/YYYY-MM-DD-<topic>.md

---

Phase 4: 실행 (Execute)

두 가지 모드 제공:

A. 서브에이전트 모드 (권장)

태스크당 새 서브에이전트 파견:

1. 구현 서브에이전트 → 태스크 실행
2. 스펙 리뷰 서브에이전트 → 스펙 준수 확인
3. 코드 품질 리뷰 서브에이전트 → 품질 확인
4. 다음 태스크로

B. 인라인 모드

현재 세션에서 직접 실행:

• 3-5개 태스크마다 체크포인트
• 사용자 확인 후 진행

---

Phase 5: 검증 (Evaluate)

3단계 검증:

1. 기계적 검증: 테스트 통과, 린트 통과, 빌드 성공
2. 의미론적 검증: 스펙의 성공 기준 충족 여부
3. 합의 검증: 사용자 확인

---

빠른 시작

사용자가 개발 요청을 하면:

1. "몇 가지 질문으로 시작하겠습니다."
2. 소크라테스 인터뷰 (3-5개 질문)
3. "스펙을 정리하겠습니다." → 스펙 제시 → 승인 요청
4. "구현 계획을 세우겠습니다." → 계획 제시 → 승인 요청
5. "실행 모드를 선택해주세요: [서브에이전트/인라인]"
6. 실행 → 검증 → 완료

---

단축 모드

간단한 작업은 풀 프로세스가 과할 수 있음.

단축 조건:

• 단일 파일 수정
• 명확한 요구사항 (모호성 낮음)
• 사용자가 "빨리" 또는 "간단히" 요청

단축 시:

• 질문 1-2개로 축소
• 스펙 없이 바로 계획
• 계획도 간소화 가능

---

참고 자료

원본 저장소:

• ouroboros-ref/ - Ouroboros 원본
• superpowers-ref/ - Superpowers 원본

에이전트 역할 (Ouroboros)

• Socratic Interviewer: 질문만 함, 구현 약속 금지
• Ontologist: 본질/근본원인/전제조건/가정 분석
• Seed Architect: 대화를 스펙으로 결정화
• Evaluator: 3단계 검증

스킬 (Superpowers)

• brainstorming: 디자인 도출
• writing-plans: 바이트 사이즈 계획
• subagent-driven-development: 서브에이전트 실행
• test-driven-development: RED-GREEN-REFACTOR
• systematic-debugging: 체계적 디버깅