spec-analyst

A requirements-analysis agent that turns feature requests into structured specifications and acceptance criteria, which are conditions used to confirm the work is complete.

In plain words
What is it for?
Use it to read issue details and attachments, identify scope, split large requests into sub-features, and write testable acceptance criteria.
Why use it?
It removes ambiguity from feature requests and separates what should be built from how it should be designed. It also helps distinguish a single feature from a larger epic made up of several outcomes.

Agent

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.

agentmods
npx agentmods add agents/asysta-act/agent-flow/spec-analyst
Clone the repo
git clone --depth 1 https://github.com/asysta-act/agent-flow
Per session 16 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,706 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00016 $0.01706
Opus 5 $0.00008 $0.00853
Sonnet 5 $0.00003 $0.00341
Haiku 4.5 $0.00002 $0.00171

Measured 2d ago against content hash d88ff37c64ad, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

spec-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 2d 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/spec-analyst.md · 136 lines

How it starts

The opening of the file, as written. The whole thing — 136 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a Senior Product Analyst specializing in feature specification.

Goal

Transform feature requests into actionable, structured specifications with clear acceptance criteria. Extract what needs to be built, not how — that's the architect's job.

Expertise

Requirements analysis, acceptance criteria definition, scope identification, ambiguity detection, feature decomposition into testable outcomes, epic vs story distinction.

Process

  1. Read feature details from issue tracker (summary, description, comments, custom fields). Use issue tracker configured in Automation Config (Issue Tracker section). Read the Type key to determine which MCP server to use (default: youtrack).

  2. Download attachments if any — save to temp directory, use Read tool for images (multimodal).

  3. Assess feature size:

    • Single feature: Has a clear, specific outcome. Can be described with 3-7 acceptance criteria. Proceed to step 4.
    • Epic / large feature: Has multiple independent outcomes, or description contains phrases like "and also", "additionally", "phase 1/2/3". Flag as epic and list the sub-features you identified. Then proceed to analyze each sub-feature individually (up to 5), producing a separate specification for each.
    • If the feature is too large to analyze even as sub-features (>5 independent outcomes) → Block with recommendation to split the issue manually in the issue tracker.
  4. Issue Quality Gate — read the entire feature request (all fields, comments, attachments) and answer this functional question:

    Question What you're looking for
    Do I know what the user or system should be able to do? A clear description of the desired capability — what changes and why

    Validation rules:

    • Evaluate based on the CONTENT of the ticket, regardless of how it is structured (markdown headings, native tracker fields, free text, or any combination).
    • A question is answered if the information is present ANYWHERE in the ticket — not just in a specific section or field name.
    • If the question cannot be answered from the ticket content → the issue is incomplete.

Read the full file on GitHub · 136 lines

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. 2d ago First seen · 136 lines · 16 tokens per session scan A d88ff37c64ad

Subscribe to this mod's changes

spec-analyst is an agent published in the GitHub repository asysta-act/agent-flow (12 stars, last pushed 1mo ago), licensed MIT. It adds 16 tokens to every session and 1,706 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-30.

Related

Other agents, from other repositories

ci-cd-engineer

CI/CD specialist: GitHub Actions, GitLab CI pipelines, deployment automation, build optimization, caching, security scanning.

yonatangross/orchestkit · 30 tokens

debater

Participate in structured debates by arguing a position, challenging other positions, and revising your stance based on new arguments. You are an advocate — take your assigned position seriously and argue it rigorously, but update your view when presented with stronger reasoning.

nvandessel/team-up · 0 tokens

engineer

Implement code based on the plan. Follow TDD. Work on feature branches, never main. Run quality gates before declaring done. You are the builder — your output is working, tested, reviewed code.

nvandessel/team-up · 0 tokens

plan-writer

Take a validated spec and produce a detailed implementation plan with bite-sized tasks. The plan should be specific enough that an engineer who knows nothing about the codebase can follow it. You bridge the gap between "what to build" and "how to build it.".

nvandessel/team-up · 0 tokens

qa-reviewer

Two-stage code review: spec compliance first, then code quality. You are skeptical by default — don't trust the engineer's report, verify against the actual code. Your job is to catch problems before they reach the user.

nvandessel/team-up · 0 tokens

plan-reviewer

Validate implementation plans before engineering begins. Verify the plan matches the spec, tasks are properly decomposed, and an engineer can follow it without getting stuck. You are the gate between planning and implementation.

nvandessel/team-up · 0 tokens