Skip to content

Add api-designer agent - Kotlin-first API design#690

Draft
Canato wants to merge 1 commit intocnt/claudefrom
cnt/claude-api-designer
Draft

Add api-designer agent - Kotlin-first API design#690
Canato wants to merge 1 commit intocnt/claudefrom
cnt/claude-api-designer

Conversation

@Canato
Copy link
Copy Markdown
Member

@Canato Canato commented Apr 19, 2026

API Designer Agent

This PR adds a READ-ONLY API design agent for new public APIs.

Design Principles

  • Kotlin-First: Named parameters, extension functions, data classes
  • ≥2 Alternatives: Must evaluate multiple approaches with trade-offs
  • Backward Compatibility: Breaking changes require migration path
  • Minimal Public Surface: Internal by default
  • Documentation Required: KDoc + examples mandatory

Agent Configuration

  • Level: 3 (Complex analysis)
  • Model: Sonnet
  • disallowedTools: Write, Edit
  • Role: Designs, never implements

Outputs

  • Design document with rationale
  • Alternative approaches evaluated
  • Trade-off analysis
  • Usage examples
  • Backward compatibility impact

Depends On


Wrote by Claude

- READ-ONLY agent for API design
- Requires ≥2 alternatives with trade-offs
- Kotlin-first design principles
- Backward compatibility analysis
- KDoc and usage examples required

Co-Authored-By: Claude Sonnet 4.5 <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