# Agnt

> Signal-Driven Navigator for indie hackers. Guides users through problem discovery, customer interviews, spec writing, and tool comparison to reach their first paid signal in 30 days. Use when the user asks to start, discover problems, interview customers, write specs, compare tools, or check progress.

- Skill: `october-academy/agnt` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add october-academy/agnt`
- Raw SKILL.md: https://api.skillmd.com/api/skills/october-academy/agnt/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- License: MIT
- Author: october-academy (https://skillmd.com/u/october-academy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/october-academy/agnt

---


# agnt

30일 안에 첫 유료 시그널을 만드는 Signal-Driven Navigator.

## When To Use

다음 요청에서 이 스킬을 사용합니다.

- "agnt 시작", "프로젝트 시작", "시작하기"
- "진단", "audit", "프로젝트 진단", "매출 준비도", "Revenue Readiness"
- "다음에 뭐 해야 해?", "다음 행동", "추천"
- "문제 찾기", "ICP 정의", "아이디어 검증"
- "ICP 문서", "ICP 구체화", "타겟 고객 문서", "deep-interview로 ICP"
- "디자인 시스템", "브랜드 가이드", "design-system", "docs/design-system.md"
- "고객 인터뷰", "Mom Test", "인터뷰 가이드"
- "SPEC 작성", "제품 스펙"
- "도구 비교", "결제 솔루션", "분석 도구"
- "진행 상태", "대시보드"
- "MVP 범위", "빌드 가이드", "뭘 먼저 만들어야 해?"
- "랜딩 전략", "랜딩에 뭘 써야 해?", "랜딩페이지 가이드"
- "채널 추천", "어디에 올려야 해?", "첫 포스트"
- "경쟁 분석", "비슷한 제품이 있어?", "차별화"
- "콘텐츠 전략", "뭘 올려야 해?", "첫 포스트"
- "오퍼 설계", "얼마에 팔아야 해?", "가격 설정"
- "론칭 계획", "론칭 어떻게 해?", "7일 계획"
- "성과 분석", "잘 되고 있는 거야?", "전환율 판정"
- "회고", "뭘 배웠지?", "다음 루프"
- "연결", "MCP 연결", "동기화", "agentic30 연결"
- "SEO 점검", "SEO 체크", "사이트 점검"
- "사업자 등록", "사업자 판단", "사업자 필요"
- "분석 세팅", "PostHog 설치", "이벤트 추적"
- "런칭 카피", "채널 카피", "카피 생성"
- "광고 소재", "광고 카피", "Meta 광고", "Google 광고"
- "Meta 광고 세팅", "Threads 광고 세팅", "Ads Manager 세팅", "광고 세트 타게팅"
- "수익 모델", "어떻게 돈 벌어", "첫 매출"
- "구독 전략", "앱 구독", "hard paywall", "freemium", "trial", "연간 플랜", "intro offer"
- Codex 명시형 호출: `$agnt-start`, `$agnt-audit`, `$agnt-next`, `$agnt-discover`, `$agnt-icp`, `$agnt-design-system`, `$agnt-interview`, `$agnt-compete`, `$agnt-spec`, `$agnt-build`, `$agnt-landing`, `$agnt-channel`, `$agnt-content`, `$agnt-offer`, `$agnt-launch`, `$agnt-analyze`, `$agnt-retro`, `$agnt-tools`, `$agnt-status`, `$agnt-connect`, `$agnt-seo-audit`, `$agnt-biz-setup`, `$agnt-analytics-setup`, `$agnt-launch-copy`, `$agnt-ad-creative`, `$agnt-meta-ads-setup`, `$agnt-revenue`, `$agnt-subscription`

## Runtime Setup

### 0) 에이전트 환경 분기

실행 환경을 먼저 확인합니다.

- Claude Code 환경: `/mcp` 명령이 사용 가능하거나 사용자가 Claude Code를 사용 중임
- Codex 환경: `codex` CLI 사용 중임

이후 MCP 연결 절차를 환경별로 따릅니다.

### 1) MCP 연결 확인 (환경별)

#### A. Claude Code

`agentic30` MCP 서버가 없으면 아래 순서로 안내합니다.

1. Claude Code 실행
2. 채팅 입력창에 `/mcp` 입력
3. 목록에서 `agentic30` 또는 `plugin:agnt:agentic30` 선택
4. `Authenticate` 선택 후 브라우저에서 Google 로그인
5. `/mcp`에서 connected 상태 확인

서버가 목록에 없으면 프로젝트 `.mcp.json`에 아래 항목을 추가합니다.

```json
{
  "mcpServers": {
    "agentic30": {
      "type": "http",
      "url": "https://mcp.agentic30.app/mcp"
    }
  }
}
```

그 뒤 Claude Code를 재시작하고 `/mcp` 인증을 다시 진행합니다.

#### B. Codex

`agentic30` MCP 서버가 없으면 아래 순서로 안내합니다.

```bash
codex mcp add agentic30 --url https://mcp.agentic30.app/mcp
codex mcp login agentic30
codex mcp list
```

이미 등록되어 있으면 `codex mcp login agentic30`만 다시 수행하면 됩니다.

### 2) 상태 파일 경로(AGNT_DIR)

아래 순서로 state 경로를 탐색합니다.

1. `.claude/agnt/state.json`
2. `~/.claude/agnt/state.json`
3. `.codex/agnt/state.json`
4. `~/.codex/agnt/state.json`
5. 둘 다 없으면 `.claude/agnt/state.json` 생성

### 3) references 경로(REFS_DIR)

`navigator-engine.md` 존재 여부로 탐색합니다.

1. `references/` (현재 스킬 디렉토리 기준)
2. `{AGNT_DIR}/references`
3. `~/.claude/plugins/marketplaces/agentic30/references`
4. `.agents/skills/agnt/references`
5. `~/.codex/skills/agnt/references`

## Skill Mapping

사용자 의도를 아래 스킬로 매핑해 실행합니다.

- 시작/온보딩: `skills/start/SKILL.md`
- Revenue Readiness Audit: `skills/audit/SKILL.md`
- 다음 행동: `skills/next/SKILL.md`
- 문제 발견: `skills/discover/SKILL.md`
- ICP 정의/구체화: `skills/icp/SKILL.md`
- 디자인 시스템: `skills/design-system/SKILL.md`
- 고객 인터뷰: `skills/interview/SKILL.md`
- 경쟁 분석: `skills/compete/SKILL.md`
- SPEC 작성: `skills/spec/SKILL.md`
- MVP 빌드: `skills/build/SKILL.md`
- 랜딩 전략: `skills/landing/SKILL.md`
- 채널 활성화: `skills/channel/SKILL.md`
- 콘텐츠 전략: `skills/content/SKILL.md`
- 오퍼 설계: `skills/offer/SKILL.md`
- 론칭 계획: `skills/launch/SKILL.md`
- 성과 분석: `skills/analyze/SKILL.md`
- 회고: `skills/retro/SKILL.md`
- 도구 비교: `skills/tools/SKILL.md`
- 상태 확인: `skills/status/SKILL.md`
- Agentic30 연결: `skills/connect/SKILL.md` *(disable-model-invocation)*
- SEO 점검: `skills/seo-audit/SKILL.md`
- 사업자 등록 판단: `skills/biz-setup/SKILL.md`
- 분석 환경 세팅: `skills/analytics-setup/SKILL.md`
- 런칭 카피: `skills/launch-copy/SKILL.md`
- 광고 소재: `skills/ad-creative/SKILL.md`
- Meta 광고 세팅: `skills/meta-ads-setup/SKILL.md`
- 수익 모델: `skills/revenue/SKILL.md`
- 구독 전략: `skills/subscription/SKILL.md`

각 스킬의 SKILL.md를 source of truth로 사용합니다.

### Codex Command Style (`$agnt-*`)

Codex에서는 아래 명령을 canonical로 사용합니다.

- `$agnt-start` → `skills/start/SKILL.md`
- `$agnt-audit` → `skills/audit/SKILL.md`
- `$agnt-next` → `skills/next/SKILL.md`
- `$agnt-discover` → `skills/discover/SKILL.md`
- `$agnt-icp` → `skills/icp/SKILL.md`
- `$agnt-design-system` → `skills/design-system/SKILL.md`
- `$agnt-interview` → `skills/interview/SKILL.md`
- `$agnt-compete` → `skills/compete/SKILL.md`
- `$agnt-spec` → `skills/spec/SKILL.md`
- `$agnt-build` → `skills/build/SKILL.md`
- `$agnt-landing` → `skills/landing/SKILL.md`
- `$agnt-channel` → `skills/channel/SKILL.md`
- `$agnt-content` → `skills/content/SKILL.md`
- `$agnt-offer` → `skills/offer/SKILL.md`
- `$agnt-launch` → `skills/launch/SKILL.md`
- `$agnt-analyze` → `skills/analyze/SKILL.md`
- `$agnt-retro` → `skills/retro/SKILL.md`
- `$agnt-tools` → `skills/tools/SKILL.md`
- `$agnt-status` → `skills/status/SKILL.md`
- `$agnt-connect` → `skills/connect/SKILL.md`
- `$agnt-seo-audit` → `skills/seo-audit/SKILL.md`
- `$agnt-biz-setup` → `skills/biz-setup/SKILL.md`
- `$agnt-analytics-setup` → `skills/analytics-setup/SKILL.md`
- `$agnt-launch-copy` → `skills/launch-copy/SKILL.md`
- `$agnt-ad-creative` → `skills/ad-creative/SKILL.md`
- `$agnt-meta-ads-setup` → `skills/meta-ads-setup/SKILL.md`
- `$agnt-revenue` → `skills/revenue/SKILL.md`
- `$agnt-subscription` → `skills/subscription/SKILL.md`

호환 입력(`$agnt start`, `$agnt next` 등)도 동일하게 매핑합니다.

## Agent Compatibility Rules

`skills/*/SKILL.md`는 Claude Plugin 기준 문구(`ToolSearch`, `AskUserQuestion`, `/mcp`)를 포함합니다.
Codex 등 다른 에이전트에서는 아래로 호환 처리합니다.

- `ToolSearch`:
  - 가능하면 MCP 도구 목록/호출로 `agentic30` 연결 여부를 확인합니다.
  - 확인 불가 시, `submit_practice` 또는 `get_leaderboard` 호출을 시도하고 실패를 연결 실패로 처리합니다.
- `AskUserQuestion`:
  - 일반 질문으로 대체하되, 선택지를 번호 목록으로 명시합니다.
- `/mcp` 안내:
  - Claude Code에서는 `/mcp` 안내를 그대로 사용합니다.
  - Codex에서는 `codex mcp add/login/list` 명령으로 치환합니다.
- 경로 안내:
  - Codex에서 `skills/*/SKILL.md`를 읽을 때 `.claude/agnt` 경로 표기가 나오면 `.codex/agnt`를 우선 사용합니다.
- 명령 파싱 우선순위:
  1. `$agnt-<subcommand>` canonical 입력
  2. `$agnt <subcommand>` 호환 입력
  3. 자연어 의도 입력 (예: "다음에 뭐 해야 해?")

## Core Behavior Rules

- 한국어로 진행하고 기술 용어는 원문(MCP, OAuth, CLI) 유지
- `references/shared/navigator-engine.md`의 Navigator 규칙 준수
- MCP 연결 실패 시 fail-closed (완료 제출/동기화 금지, 로컬 워크플로우는 동작)
- 카운트다운: `meta.started_at` 기준 Day D/30 표시
- 추천은 비강제 — 유저가 순서를 어겨도 차단하지 않음
- AskUserQuestion는 기본적으로 선택지 우선으로 설계
- 자유 입력은 URL, 숫자, 붙여넣기 메모, 산출물 문장처럼 꼭 필요한 경우에만 받음
- 선택지는 하드코딩하지 않고 `project.*`, `audit_result`, 직전 답변, journey-brief를 바탕으로 동적으로 만든다
- 선택지로 충분히 좁힐 수 있으면 먼저 2-6개 옵션을 제시하고, 마지막에만 "기타/직접 입력"을 연다