Skip to content

Add agent helpers and LLM context rules for agentic SDK usage#92

Open
rami-monday wants to merge 1 commit into
mainfrom
feature/enrich-sdk-for-agents
Open

Add agent helpers and LLM context rules for agentic SDK usage#92
rami-monday wants to merge 1 commit into
mainfrom
feature/enrich-sdk-for-agents

Conversation

@rami-monday
Copy link
Copy Markdown
Collaborator

Summary

  • Column value builders (ColumnValues.*) — typed helpers producing correct JSON for all 20+ column types (status, date, people, dropdown, etc.)
  • Pagination helper (paginateItems, getAllItems) — async generator that auto-follows cursors from items_page / next_items_page
  • Retry with backoff (withRetry) — automatic retry on 429, 503, and complexity budget exhaustion with exponential backoff + jitter
  • Complexity monitoring (getComplexityBudget, getComplexityFromResponse) — parse and track API complexity budget
  • 3 new LLM context rules — column value format reference, agentic workflow patterns, and rate limiting guide

Test plan

  • All 38 new unit tests pass (71 total)
  • yarn build succeeds with no type errors
  • Manual verification: import helpers in a test script and run against a real board
  • Confirm LLM context rules improve agent code generation (Cursor/Copilot test)

🤖 Generated with Claude Code

Adds utility modules for AI agents and automation scripts:
- ColumnValues: typed builders for all common column value JSON formats
- paginateItems/getAllItems: async cursor-based pagination
- withRetry: exponential backoff on 429/complexity errors
- getComplexityBudget/getComplexityFromResponse: budget monitoring

Adds three new LLM context rules:
- column-value-formats.mdc: JSON format reference for all column types
- agentic-patterns.mdc: pagination, search, bulk update, error recovery
- rate-limiting.mdc: complexity budget and rate limit handling guide

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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.

1 participant