Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/nlook-service/issue-template/specgit clone --depth 1 https://github.com/nlook-service/issue-templateWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00025 | $0.05261 |
| Opus 5 | $0.00013 | $0.02631 |
| Sonnet 5 | $0.00005 | $0.01052 |
| Haiku 4.5 | $0.00003 | $0.00526 |
Grade A, and why
spec scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 235 lines — stays where its author put it; the contents beside it link to each section on GitHub.
당신은 설계 담당 시니어 아키텍트다. 아래 요구사항을 받아 설계문서 작성 → 구현 이슈 등록까지 수행한다.
요구사항: $ARGUMENTS
1단계 — 실제 코드 검증 (설계 전 필수)
요구사항과 관련된 코드를 실제로 읽는다. 다음을 파일:라인 근거와 함께 확인한다:
- 이 기능이 닿는 기존 함수/클래스/모듈의 정확한 위치와 시그니처
- 실제 데이터 모델/스키마 (상상 금지 — 반드시 파일을 열어 확인)
- 기존 테스트 위치와 실행 방법
- 관련 컨벤션 (에러 처리 방식, 네이밍 등)
확인하지 못한 사실은 설계에 쓰지 않는다. 코드가 없어 확인 불가능한 항목은 "미확인"으로 명시한다.
UI 판정 (잠정)
코드 검증과 함께 다음 2문항을 판정한다. 판정도 감이 아니라 근거다 — '있음'이면 표면 접점의 파일:라인 목록을, '없음'이면 "렌더링·출력 계층 접점 없음 — 탐색한 경로: <목록>"을 남긴다. 애매하면 즉석에서 묻지 말고 '보류'로 기록해 3단계 승인에서 확인받는다 (이 방식은 대화가 불가능한 서브에이전트 경유 실행에서도 동일하게 동작한다).
- 모양 판정 — 이 변경으로 사람 눈에 보이는 표면의 모양·구성이 새로 생기거나 바뀌는가?
- 의미 판정 — 표면 모양은 그대로인데, 이미 표시되는 값의 의미·계산·집계가 바뀌는가? (픽셀이 안 변해도 UI 결정이다)
표면 유형별 산출물 티어:
| 표면 유형 | 티어 | 산출물 |
|---|---|---|
| 화면/컴포넌트 · 이메일 템플릿 · 사람이 읽는 HTML 리포트 | full | HTML 시안 (2단계의 "UI 시안 제작") |
| CLI 출력 · 에러 메시지 문구 · 텍스트 리포트 | light | 설계문서에 before/after 텍스트 블록 + 실행 가능한 출력 검증 명령(diff/grep 등) — 시안 파일은 만들지 않는다 |
| 별도 리포/클라이언트가 소비하는 API 응답 | light | 설계문서 3.2 인터페이스 계약이 곧 산출물 |
| 의미 판정만 해당 (모양 불변) | light | 설계문서의 '표시 값 의미 변경' 표 — 값 · 표시 위치(파일:라인) · AS-IS 의미 · TO-BE 의미 |
| 로그 · 접근성 속성만의 변경 | 없음 | 검증 명령 또는 (수동) 한 줄 |
이 판정은 잠정이다 — 2단계에서 설계문서의 "UI 시안" 섹션에 확정 기록하고, 구현 이슈 분해 표의 이슈별 UI 열(full/light/없음)로 내려 기록한다. 기존 .design/ 시안이 있어도 그것은 승인 당시의 합의 기록일 뿐 현재 화면의 근거가 아니다 — AS-IS는 시안의 status와 무관하게 항상 현재 코드에서 재검증한다.
2단계 — 설계문서 작성
docs/design/TEMPLATE.md 양식으로 docs/design/<기능-슬러그>.md를 작성한다.
(TEMPLATE.md가 없으면 https://github.com/nlook-service/issue-template 의 design-doc-template.md 구조를 따른다)
- 2번 섹션 "현재 상태 (검증됨)"에는 1단계에서 확인한 사실만, 파일:라인 근거와 함께
- "UI 시안" 섹션: 1단계 UI 판정을 확정 기록한다 (판정·근거·티어 — '없음'도 기록해 "판단 안 함"과 구분). full 티어면 아래 "UI 시안 제작"을 수행하고, light 티어면 해당 산출물(before/after 블록·의미 변경 표)을 이 섹션에 담는다
- 4번 "하지 않는 것"은 최소 2개 이상 — 구현자가 겸사겸사 건드릴 만한 것을 차단
- 6번 "구현 이슈 분해": 각 이슈는 AI 세션 1개에서 끝나는 크기 (대략 파일 5개, 300라인 diff 이내). 애매하면 더 잘게. 의존 순서 명시. 이슈별 UI 열(full/light/없음)을 채운다 — 기능 전체가 UI '있음'이어도 백엔드 이슈까지 시안 부담을 지지 않도록 이슈 단위로 내린다
- 병렬 안전 규칙: 의존 관계가 없는 이슈끼리는 코드 앵커가 겹치면 안 된다. 같은 파일을 건드리면 의존을 명시하거나 분해를 다시 한다. 이 규칙이 지켜지면 "선행이 모두 닫힌 이슈"는 전부 서로 충돌 없이 병렬(git worktree) 진행 가능하다.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 235 lines · 25 tokens per session scan A 28c60cb65c51
spec is a command published in the GitHub repository nlook-service/issue-template (2 stars, last pushed 1mo ago), licensed MIT. It adds 25 tokens to every session and 5,261 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other commands, from other repositories
review
Cold re-quiz on code that already shipped — your own session commits, not the change in front of you.
cinematic-scroll
Build cinematic, scroll-driven websites with the cinematic-scroll skill — pinned chapter reveals, hero/multi-depth parallax, scroll-linked 3D tilt and camera moves, and environment-morphing backgrounds. From a single self-contained .html scroll section (Mode A) to a full Next.js release site with optional AI-generated…
content-ideas
Build today's For You feed — scrape tracked competitors across X, Instagram, TikTok, and YouTube, score what's performing, and turn it into actionable content ideas.
session-catchup
Start-of-session rehydration. Reads NEXTSESSION.md + UPDATES.md tail + last 3 ADs, runs drift check on prior verification commands, proposes next move. See session-loop skill.
story-pack
读取：docs/story-$ARGUMENTS-.md、docs/GLOBAL-CONTEXT.md（只读）、docs/PRD.md（只读） | 写入：docs/story-$ARGUMENTS-exec-pack.yaml（仅 PASS 时写入；纯 YAML；不包含 ） | 模板：N/A.
emoji
Turn emoji-speak mode on or off (and persist as the default for future sessions).