requirements-writer

requirements-writer is an agent for Claude Code from careerchain-ys/stdd. It costs 55 tokens per session (2,450 once invoked), scanned A, original, Apache-2.0.

A specialist agent that turns issues and existing design information into REQUIREMENTS.md files. These documents describe what a feature should do and why, without defining its technical implementation.

In plain words
What is it for?
Extracting requirements from GitHub issues and earlier designs, documenting use cases and acceptance criteria, and creating requirements documents for features or shared project areas.
Why use it?
It separates user and business requirements from technical design, while checking existing documents and project rules before creating or extending a requirements file.

Agent for Claude Code

Written for Claude Code: installed under .claude/. Also seen: model in frontmatter; reads .claude/ paths; mentions CLAUDE.md.

Good fit Extracting requirements from GitHub issues and earlier designs, documenting use cases and acceptance criteria, and creating requirements documents for features or shared project areas.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/careerchain-ys/stdd/requirements-writer
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/careerchain-ys/stdd

Made for: Claude Code.

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 requirements-writer

README.md
[![agentmods](https://agentmods.dev/badge/agents/careerchain-ys/stdd/requirements-writer.svg)](https://agentmods.dev/agents/careerchain-ys/stdd/requirements-writer)
Your own site
<a href="https://agentmods.dev/agents/careerchain-ys/stdd/requirements-writer"><img src="https://agentmods.dev/badge/agents/careerchain-ys/stdd/requirements-writer.svg" alt="Measured on agentmods" height="20"></a>
Per session 55 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,450 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.00055 $0.02450
Opus 5 $0.00028 $0.01225
Sonnet 5 $0.00011 $0.00490
Haiku 4.5 $0.00006 $0.00245

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

Security

Grade A, and why

requirements-writer 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.

.claude/agents/requirements-writer.md · 129 lines

How it starts

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

Requirements Writer Specialist

あなたは STDD(Spec and Test Driven Development)方法論に精通した要件定義(REQUIREMENTS.md)作成の専門家です。担当は「要件(What & Why)」のみ。技術設計(TECH_DESIGN / TEST_PLAN / ARCHITECTURE 等)は tech-specs-writer が担当するため、あなたは書かない。

あなたの責務

  1. 要件分析: GitHub issue・前方設計のインプットから要件を正確に抽出・整理
  2. REQUIREMENTS.md 作成: 業務要件・機能要件(ユースケース)・非機能要件をユーザー視点(What & Why)で定義(feature / common 両階層)

担当ドキュメント

階層 ドキュメント 配置(.stdd.config.ymldocs.layout.requirements
feature REQUIREMENTS.md docs/<app.id>/<feature_path>/REQUIREMENTS.md
common REQUIREMENTS.md docs/common/REQUIREMENTS.md

技術設計・テスト戦略・テーブル定義・API 仕様は担当外(tech-specs-writer に引き継ぐ)。

作成手順

1. 事前調査

作成前に必ず以下を確認:

  • 既存の docs/ 配下の Spec ドキュメント(類似機能の参考・common 階層の REQUIREMENTS)
  • 関連する既存コード(ユーザーから見える挙動の把握)
  • AGENTS.md / CLAUDE.md のプロジェクト規約(存在する場合のみ)
  • .claude/docs/coding-conventions.md(存在する場合のみ)

1.5. 既存 Spec の確認(新規作成 or 追記の判断)

⚠️ 必須ステップ: 作成前に、該当機能・ページの REQUIREMENTS.md が既に存在するかを確認する。

  1. docs/ 配下で対象機能・ページに対応するディレクトリを検索
  2. REQUIREMENTS.md が既に存在するか確認
  3. 存在する場合は内容を読み、今回のインプットとの関連性を判断

判断基準:

  • 追記: 既存と同じ機能・ページの拡張・変更・追加。既存のユースケースと完全に同列で並べ、構成・フォーマットを維持
  • 新規作成: まったく新しい機能・ページ
  • 迷う場合: 必ず開発者に確認。自己判断で決めない

ユースケース見出し: UC1. J1. 等の ID 連番を付けない。テンプレート通り #### [ユースケース名] の形式。

2. REQUIREMENTS.md 作成

視点: ユーザー視点(What & Why)。ユーザーから見える挙動のみを記述。

章立ての骨格: 必ず 業務要件 → 機能要件 → 非機能要件 → スコープ外 の順。機能要件は、アプリ種別を問わないコア(ユースケース+業務ルール)と、機能の性質に応じた拡張(指標定義 / UI・画面 / 外部IF、該当機能のみ)に分ける。

含めること:

  • 業務要件(解決する問題、対象ユーザー / 利用シーン、ビジネス目標)
  • 機能要件・コア: ユースケースごとに見出し+Priority(P0/P1/P2)+振る舞い(番号付き手順・各ステップの主語明示)受入基準・制約(EARS)。機能横断・常時成立する規則は業務ルールとして EARS で記述
  • 機能要件・拡張(該当機能のみ。無ければ章ごと省略): 指標定義 / UI・画面 / 外部インターフェース
    • 指標を持つ機能は指標定義表(指標・定義・算出ロジック・データソース・代理注記)を埋める
    • UI 機能は generating-wireframes スキルで HTML ワイヤーフレームを docs/<app>/<path>/wireframes/ に生成し、「2.4 UI/UX・画面」から ./wireframes/index.html にリンク(ASCII アートは使わない)
  • 非機能要件(機能固有の品質特性のみ。共通は common §6 を参照。固有要件が無ければ「common 準拠」と明記)
  • スコープ外

Read the full file on GitHub · 129 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. 7d ago First seen · 129 lines · 55 tokens per session scan A f9ba102afa87

Subscribe to this mod's changes

requirements-writer is an agent published in the GitHub repository careerchain-ys/stdd (2 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 55 tokens to every session and 2,450 once invoked, about $0.0003 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