speckit.specify

A workflow for creating or updating a feature specification from a plain-language description. A feature specification is a written definition of what the software should do.

In plain words
What is it for?
Use it to start a new feature specification or revise an existing one, including any configured actions that should run first.
Why use it?
It turns an informal feature idea into a shared document that can guide later clarification, planning, and implementation.

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/mbeacom/adrkit/speckit.specify
Clone the repo
git clone --depth 1 https://github.com/mbeacom/adrkit
Per session 13 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,968 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 89% copy Near-identical to another mod 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.00013 $0.03968
Opus 5 $0.00006 $0.01984
Sonnet 5 $0.00003 $0.00794
Haiku 4.5 $0.00001 $0.00397

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

Security

Grade A, and why

speckit.specify 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.

Origin

This is a copy

89% identical to speckit.specify — 118 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.github/agents/speckit.specify.agent.md · 346 lines

How it starts

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

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

Pre-Execution Checks

Check for extension hooks (before specification):

  • Check if .specify/extensions.yml exists in the project root.
  • If it exists, read it and look for entries under the hooks.before_specify key
  • If the YAML cannot be parsed or is invalid, skip hook checking silently and continue normally
  • Filter out hooks where enabled is explicitly false. Treat hooks without an enabled field as enabled by default.
  • For each remaining hook, do not attempt to interpret or evaluate hook condition expressions:
    • If the hook has no condition field, or it is null/empty, treat the hook as executable
    • If the hook defines a non-empty condition, skip the hook and leave condition evaluation to the HookExecutor implementation
  • For each executable hook, output the following based on its optional flag:
    • Optional hook (optional: true):
      ## Extension Hooks
      
      **Optional Pre-Hook**: {extension}
      Command: `/{command}`
      Description: {description}
      
      Prompt: {prompt}
      To execute: `/{command}`
      
    • Mandatory hook (optional: false):
      ## Extension Hooks
      
      **Automatic Pre-Hook**: {extension}
      Executing: `/{command}`
      EXECUTE_COMMAND: {command}
      
      Wait for the result of the hook command before proceeding to the Outline.
      
      After emitting the block above you MUST actually invoke the hook and wait for it to finish before continuing. Run it the same way you would run the command yourself in this agent/session (the invocation may differ from the literal {command} id shown above, e.g. a skills-mode agent runs it as /skill:speckit-... or $speckit-...). Emitting the block alone does not run the hook.
  • If no hooks are registered or .specify/extensions.yml does not exist, skip silently

Outline

The text the user typed after /speckit.specify in the triggering message is the feature description. Assume you always have it available in this conversation even if $ARGUMENTS appears literally below. Do not ask the user to repeat it unless they provided an empty command.

Read the full file on GitHub · 346 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 · 346 lines · 13 tokens per session scan A e24c01f27d26

Subscribe to this mod's changes

speckit.specify is an agent published in the GitHub repository mbeacom/adrkit (11 stars, last pushed 3d ago), licensed Apache-2.0. It adds 13 tokens to every session and 3,968 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 89% identical to speckit.specify, differing in 118 lines, and is treated as a copy.

Related

Other agents, from other repositories

agentic-workflows

GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing.

tosin2013/mcp-adr-analysis-server · 24 tokens

adr-generator

Use this agent to author a new Architecture Decision Record (ADR). Hand it the decision, the alternatives, and the constraints; it returns a fully populated docs/adr/ADR-XXX-title.md following the conventions in the project's ADR skill. Use when a code change is architecturally significant: new dependency, contract…

rvdbreemen/adr-kit · 86 tokens

solutions-architect

Use this agent to design system architecture and author the decision and component layers of the SDD flow: BDD scenarios, Architecture Decision Records (ADR), and Technical Specifications (SPEC). Owns C4 modeling and Mermaid diagrams. Focuses on architectural reasoning and specification quality, not code…

vladm3105/aidoc-flow-framework · 62 tokens

adr-author

Use this agent proactively when architectural decisions are being discussed in conversation. This agent detects keywords and patterns indicating architectural discussions and suggests capturing decisions as ADRs. Examples: Context: User is discussing which database to use for a new feature. user: "Should we use…

zircote-plugins/adr · 327 tokens

adr-compliance

Use this agent proactively to audit code changes against accepted Architectural Decision Records. This agent checks if implementation follows documented architectural decisions and flags violations. Examples: Context: User has written code that might conflict with an accepted ADR. user: "I just implemented the new…

zircote-plugins/adr · 266 tokens

adr-researcher

Use this agent when researching context, options, or best practices for an architectural decision. This agent analyzes the codebase and searches the web to gather information for ADR authoring. Examples: Context: User needs to research options for a new ADR. user: "I need to write an ADR about choosing a message…

zircote-plugins/adr · 282 tokens