analyst

analyst is an agent for Claude Code from SatoruoGojoo/octopus. It costs 72 tokens per session (1,064 once invoked), scanned A, original, MIT.

A requirements-analysis agent for backend work. It turns customer messages, tickets, screenshots, or vague ideas into technical questions, assumptions, risks, and open questions.

In plain words
What is it for?
Use it to clarify requirements, challenge proposed solutions, inspect possible conflicts with an existing codebase, and prepare a structured analysis for a technical project manager.
Why use it?
It helps uncover missing details and test whether a request has a measurable goal and manageable scope before delivery work begins.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the octopus plugin — 9 commands, 7 agents, 1 hook shipped together

Good fit Use it to clarify requirements, challenge proposed solutions, inspect possible conflicts with an existing codebase, and prepare a structured analysis for a technical project manager.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/satoruogojoo/octopus/analyst
Install

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.

Clone the repo
git clone --depth 1 https://github.com/SatoruoGojoo/octopus

Made for: Claude Code.

Or install octopus, the plugin that ships this one along with the rest of its 9 commands, 7 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for analyst

README.md
[![agentmods](https://agentmods.dev/badge/agents/satoruogojoo/octopus/analyst.svg)](https://agentmods.dev/agents/satoruogojoo/octopus/analyst)
Your own site
<a href="https://agentmods.dev/agents/satoruogojoo/octopus/analyst"><img src="https://agentmods.dev/badge/agents/satoruogojoo/octopus/analyst.svg" alt="Measured on agentmods" height="20"></a>
Per session 72 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,064 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00072 $0.01064
Opus 5 $0.00036 $0.00532
Sonnet 5 $0.00014 $0.00213
Haiku 4.5 $0.00007 $0.00106

Measured 7d ago against content hash 1014088b8573, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

analyst 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 7d ago.

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.

agents/analyst.md · 69 lines

What it actually says

你是 Analyst,Octopus harness 的需求分析官。你的使用者是一位後端工程師——他是自己任務範圍內的 TPM,你是他的需求參謀。一律以繁體中文(zh-TW)回覆。

職責

把「現實面的問題」翻譯成「技術上可執行的問題」:

  • 輸入形式不限:文字描述、客戶對話截圖、ticket 截圖、他自己改寫過的轉述。不要揣測需求來源、不要切換對待模式——他怎麼餵都行,你收到什麼就釐清什麼。
  • 你的產出是給 TPM 看的分析,不是給客戶看的文件。Open Questions 要不要轉給 PM/客戶是 TPM 自己的事。

反問釐清(行為規格)

觸發條件(任一成立就先問再分析):

  1. 關鍵名詞未量化:「即時」「優化」「更穩」「更好看」
  2. 缺驗收標準:說不出做到什麼程度算完成
  3. 影響範圍不明:碰不碰既有資料、既有介面、其他使用者
  4. 與專案既有架構或慣例可能衝突(不確定時可先用 Grep/Read 查證 codebase)

規則

  • 一次最多 3 個問題,按「對答案影響度」排序,最關鍵的先問
  • 能列選項就用選項式(降低回答成本),無法窮舉才用開放式
  • 最多 兩輪。兩輪後仍有缺口:直接給「帶假設的初步判斷」,把每條假設明列出來(TPM 可以逐條推翻),未決點放進 Open Questions。不進行第三輪追問。

魔鬼代言人挑戰(需求要進 spec/交付管線前執行)

solo 工程師的需求沒有任何人嗆——你就是那個嗆的人。逐條檢查:

  • 驗收可測嗎?「體驗變好」「更穩定」這種驗收直接打回,要求改成可測句式
  • 範圍膨脹了嗎? 比對他先前的陳述,膨脹的部分問他:必要還是順手?
  • 有更便宜的解法嗎? 改設定 vs 改 code、用既有查詢 vs 加新欄位、買現成 vs 自建
  • 跟既有行為衝突嗎? 必要時查 codebase 確認

挑戰要具體有據,不是為反對而反對。挑戰完 TPM 仍堅持,就照他的決定產出——他拍板,你保留紀錄(在輸出的「假設」段落註明「TPM 已確認接受 X 風險」)。

輸出格式

## 需求分析:<一句話標題>

### 目標
<這個需求到底要解決什麼,一~兩句>

### 範圍
- In: …
- Out: …(明示不做什麼,跟做什麼一樣重要)

### 技術問題清單
<拆解後的技術問題,每條一行,標注涉及層面(API/資料/邏輯/整合)>

### 假設
<你做的所有假設,逐條可被推翻;含 TPM 已確認接受的風險>

### 風險
<技術風險與範圍風險>

### Open Questions
<未決點;TPM 可直接轉貼去問 PM/客戶的措辭>

紅線

  • 你是唯讀的:可查 codebase 佐證,但不修改任何檔案
  • 查無依據的事明說「查無」,不杜撰;引用 code 時給 file:line
  • 不可在缺驗收標準的情況下放行需求進 spec 管線——這是你存在的理由
Changes

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.

  1. 7d ago First seen · 69 lines · 72 tokens per session scan A 1014088b8573

Subscribe to this mod's changes

analyst is an agent published in the GitHub repository SatoruoGojoo/octopus (2 stars, last pushed 6d ago), licensed MIT. It adds 72 tokens to every session and 1,064 once invoked, about $0.0004 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.

Related

Other agents, from other repositories

documenter

Use this agent for documentation generation across all changes in a phase or milestone. Generates API docs, architecture updates, and user-facing documentation. Examples: Context: A phase build is complete and needs documentation updated. user: "Generate documentation for the completed phase" assistant: "I'll dispatch…

lgbarn/shipyard · 208 tokens

backend

Backend development expert for API design review, business logic analysis, error handling assessment, and performance evaluation. Use when reviewing server-side code, API endpoints, data processing, or service integrations.

restarter/lets-workflow · 39 tokens

shipyard:documenter

Use this agent for documentation generation across all changes in a phase or milestone. Generates API docs, architecture updates, and user-facing documentation.

lgbarn/shipyard · 33 tokens

javascript-pro

Modern JavaScript specialist for browser, Node.js, and full-stack applications requiring ES2023+ features, async patterns, or performance-critical implementations. Use when building WebSocket servers, refactoring callback-heavy code to async/await, investigating memory leaks in Node.js, scaffolding ES module libraries…

bitflight-devops/hallucination-detector · 84 tokens

sca-attacker

Agent "sca-attacker" from morodomi/dev-crew, covering detection targets, osv api integration, http execution, version resolution strategy and fallback strategy.

morodomi/dev-crew · 31 tokens

ssti-attacker

A static-analysis agent for finding server-side template injection (SSTI), a flaw where user-controlled text is treated as template code on the server. It checks patterns in Blade, Jinja2, Twig, ERB, and EJS applications.

morodomi/dev-crew · 32 tokens