request-fields-writer

request-fields-writer is an agent for Claude Code from voro6yov/spec-driven-development. It costs 50 tokens per session (4,085 once invoked), scanned A, original, Apache-2.0.

A documentation agent that fills the request-fields table in each REST API surface section. The table describes the data clients must send to an endpoint.

In plain words
What is it for?
Use it to document request bodies and input fields for REST API endpoints in an existing resource specification.
Why use it?
It saves you from deriving request fields manually from service diagrams and domain models. It keeps the details tied to each API surface.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the rest-api-spec plugin — 2 skills, 15 agents shipped together

Good fit Use it to document request bodies and input fields for REST API endpoints in an existing resource specification.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/voro6yov/spec-driven-development/request-fields-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/voro6yov/spec-driven-development

Made for: Claude Code.

Or install rest-api-spec, the plugin that ships this one along with the rest of its 2 skills, 15 agents.

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 request-fields-writer

README.md
[![agentmods](https://agentmods.dev/badge/agents/voro6yov/spec-driven-development/request-fields-writer/github.svg)](https://agentmods.dev/agents/voro6yov/spec-driven-development/request-fields-writer)
Your own site
<a href="https://agentmods.dev/agents/voro6yov/spec-driven-development/request-fields-writer"><img src="https://agentmods.dev/badge/agents/voro6yov/spec-driven-development/request-fields-writer/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for request-fields-writer

Your own site · 80×15
<a href="https://agentmods.dev/agents/voro6yov/spec-driven-development/request-fields-writer"><img src="https://agentmods.dev/badge/agents/voro6yov/spec-driven-development/request-fields-writer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 50 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 4,085 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.00050 $0.04085
Opus 5.5 $0.00020 $0.01634
Sonnet 5.5 $0.00010 $0.00817
Haiku 4.5 $0.00005 $0.00409

Measured 12d ago against content hash 81b38254b57a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

request-fields-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 12d 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.

plugins/rest-api-spec/agents/request-fields-writer.md · 193 lines

How it starts

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

You are a REST API request-fields writer. Given the <Resource>Commands application-service Mermaid diagram (derived from the domain diagram per spec-core:naming-conventions), the domain class diagram, any sibling ops diagrams, and an already-populated <output> (Table 1 + at least one ## Surface: section with Tables 2, 3, and 3o present), produce Table 5 (Request Fields) strictly per the rest-api-spec:endpoint-io-template pattern doc, scoped to each Surface section per the rest-api-spec:surface-markers pattern doc.

Pattern docs (umbrella resolution). Resolve <patterns_dir> as the directory containing the rest-api-spec:patterns umbrella SKILL.md (auto-loaded via this agent's frontmatter; its loaded context reveals its location). A pattern named <name> (any rest-api-spec: prefix stripped) resolves to <patterns_dir>/<name>/index.md. Before proceeding, Read in full each pattern doc this agent uses: <patterns_dir>/endpoint-io-template/index.md, <patterns_dir>/endpoint-io-template/examples.md, <patterns_dir>/surface-markers/index.md. If a referenced pattern path does not exist, abort with Error: pattern '<name>' has no folder under the rest-api-spec:patterns umbrella at <patterns_dir>. — never skip a missing pattern silently.

Table 5 carries a request sub-block per command endpoint (Table 3) and per ops endpoint (Table 3o). Ops endpoints take a request body exactly like a command: the ops method's parameters minus the aggregate id (path), tenant_id (auth), and any path-bound *_id become body fields. Ops endpoints are never composite-key (they always carry an aggregate id path segment or are collection-rooted), so the composite-key partition never applies to them. An aggregate with zero ops diagrams produces no ops sub-blocks.

Arguments

  • <domain_diagram> — path to the Mermaid domain class diagram (<dir>/<stem>.md). Used to (a) locate the sibling resource spec, (b) derive the commands-diagram sibling, and (c) resolve every PascalCase request type referenced from a Type column into a **Nested:** sub-table.

Read the full file on GitHub · 193 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. 12d ago First seen · 193 lines · 50 tokens per session scan A 81b38254b57a

Subscribe to this mod's changes

request-fields-writer is an agent published in the GitHub repository voro6yov/spec-driven-development (5 stars, last pushed 12d ago), licensed Apache-2.0. It adds 50 tokens to every session and 4,085 once invoked, about $0.0002 per session on Opus 5.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-10-04.

Related

Other agents, from other repositories

backend-engineer

Backend implementation - APIs, databases, Python, business logic, data processing, server-side work.

jpoley/flowspec · 22 tokens

python-architect

Plain Python backend implementer (backend aspect). Replaces the vanilla developer on Python projects without a recognized web framework. Handles module design, CLI tools (argparse/click/typer), data pipelines, external API clients, configuration (pydantic-settings / python-decouple), and library packaging. Do NOT use…

AratKruglik/claude-sdlc · 104 tokens

hermes

Backend specialist — FastAPI, Python, async, TDD (RED→GREEN→REFACTOR), modern Python stdlib, obsolete lib detection. Calls apollo for discovery, sends to themis.

ils15/pantheon-legacy · 44 tokens

python-engineer

Hands-on Python 3.12+ engineer. Ships async-first, type-safe, tested code with uv, ruff, FastAPI and Pydantic. TRIGGER WHEN: planning a new Python project, designing architecture, making tech-stack decisions, or implementing features. DO NOT TRIGGER WHEN: the task is writing tests (use testing:test-writer) or isolated…

acaprino/daodan · 87 tokens

drf-api

Django REST Framework specialist. Use PROACTIVELY to build and shape JSON APIs in Django projects — serializers, viewsets, routers, permissions, authentication, pagination, throttling, and filtering. Serializers own field validation; views own permissions.

toffyui/ccteams · 54 tokens

fastapi-pro

Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async patterns. Use PROACTIVELY for FastAPI development, async optimization, or API architecture.

NOMARJ/sigil · 57 tokens