Software development & engineering — programming, infrastructure and company engineering blogs. CF-robust RSS / Atom / RDF reader over a curated, edge-verified registry; on a Cloudflare egress block it falls back to the rss2json proxy.
Three tools with clear verb-noun naming (list_feeds, read_feed, fetch_feed) and reasonable descriptions (100-150 chars). All tools have input schemas with type definitions and required fields properly declared. However, parameter descriptions lack actionable constraints (no enums, ranges, or format specs). Output schemas are completely undocumented, LLMs cannot infer what fields to expect from responses. Error handling is absent from visible code. No tool annotations (readOnlyHint, idempotentHint). Parameter 'limit' lacks min/max bounds despite accepting 1-50 range.
Fetch and normalize any RSS / Atom / RDF feed by URL. CF-robust: fetches directly and falls back to a proxy if the source blocks the gateway. Use list_feeds first for curated sources.
List the curated software-development feeds (id, title, category, source). Optionally filter by category (dev) or keyword. Pass an id to read_feed.
Read a curated software-development feed by its id (from list_feeds). Returns normalized items (title, link, published, summary). Optionally filter items by keyword.
Output schemas completely undocumented. LLMs cannot infer response structure (fields, types, pagination). Breaks downstream tool chaining and forces agents to guess field names.
Parameter 'limit' (1-50 range) lacks min/max constraints in schema. Unbounded numeric parameters let LLMs pass invalid values. Should declare minimum: 1, maximum: 50.
Parameter descriptions lack actionable format/constraint details. 'Keyword to match' is vague, does it match partial strings? Is it case-sensitive? Regex? Should specify matching behavior.
No error handling guidance visible. If a feed URL is invalid or unreachable, what does the tool return? How should the LLM recover? Missing recovery patterns.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
No tool annotations (readOnlyHint, idempotentHint). All three tools are read-only and idempotent, declaring this helps agents reason about retry safety and side effects.