Skip to content

Add budget patterns guide, ecosystem docs, and community badges#97

Merged
amavashev merged 2 commits intomainfrom
claude/generate-seo-backlinks-Ur1HW
Mar 19, 2026
Merged

Add budget patterns guide, ecosystem docs, and community badges#97
amavashev merged 2 commits intomainfrom
claude/generate-seo-backlinks-Ur1HW

Conversation

@amavashev
Copy link
Contributor

Summary

This PR adds comprehensive educational content and community resources for the Cycles platform, including a practical guide to budget patterns, an integration ecosystem reference, incident documentation, and community badges for projects using Cycles.

Key Changes

New Documentation:

  • blog/agent-budget-patterns-visual-guide.md — A practical guide covering six common budget patterns (tenant isolation, workflow caps, per-run with degradation, shared pools with priority, shadow mode rollout, and hybrid token+dollar budgets) with code examples, trade-offs, and guidance on combining patterns for production systems
  • blog/true-cost-of-uncontrolled-agents.md — Analysis of real-world costs of uncontrolled AI agents, including cost amplification math, four categories of cost (direct API, compute, operational, opportunity), and five recurring failure modes (runaway loops, retry storms, concurrent overspend, scope misconfiguration, dev/prod mismatch)
  • how-to/ecosystem.md — Comprehensive integration ecosystem reference covering AI providers (OpenAI, Anthropic, Google Gemini, AWS Bedrock), frameworks (LangChain, Vercel AI SDK, Spring AI), web frameworks (Express.js, FastAPI, Spring Boot), agent platforms (MCP, OpenClaw), official SDKs, and community tools

Community Resources:

  • community/badges.md — Guidelines and code snippets for "Built with Cycles" badges in multiple formats (Markdown, HTML, reStructuredText) with light and dark variants
  • public/badges/built-with-cycles.svg and public/badges/built-with-cycles-dark.svg — SVG badge assets for light and dark backgrounds

Glossary & Concept Updates:

  • Expanded glossary.md with new sections for Patterns & Architecture (budget envelope, graceful degradation, fan-out, tool loop, retry storm, tenant isolation, cost estimation) and AI & Agent Terminology (autonomous agent, MCP)
  • Enhanced concepts/how-cycles-compares-to-rate-limiters-observability-provider-caps-in-app-counters-and-job-schedulers.md with a quick comparison table and "When to adopt Cycles" decision framework

Navigation Updates:

  • Added "Ecosystem" link to integrations section in .vitepress/config.ts with "New" badge

Notable Details

  • Budget patterns guide includes practical Python code examples and hierarchical budget structure diagrams
  • Cost analysis includes concrete pricing tables showing how agent loops amplify API costs
  • Ecosystem page provides direct links to integration guides, provider documentation, and SDK repositories
  • Badges support multiple documentation formats to accommodate diverse project types
  • Glossary additions cross-reference related incident and how-to documentation

https://claude.ai/code/session_01N2N4fKqatxBiXgFNSwxFqF

claude added 2 commits March 19, 2026 22:20
…s, and enhanced glossary/comparison

- New integration ecosystem showcase page (how-to/ecosystem.md) with links to all providers and frameworks
- New "Built with Cycles" badge kit (community/badges.md) with SVG badges and usage snippets
- New blog post: "The True Cost of Uncontrolled AI Agents" — data-driven link-bait content
- New blog post: "AI Agent Budget Patterns: A Practical Guide" — definitive reference guide
- Enhanced glossary with 14 new terms covering patterns, architecture, and AI terminology
- Enhanced comparison page with quick-comparison summary table and "when to adopt" section
- Updated sidebar navigation with Ecosystem and Community sections

https://claude.ai/code/session_01N2N4fKqatxBiXgFNSwxFqF
@amavashev amavashev merged commit 464d3fc into main Mar 19, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants