Skip to content

Conversation

@sumeruchat
Copy link
Contributor

@sumeruchat sumeruchat commented Jan 13, 2026

What

Replaces the brief reference to AGENT_README.md with a complete, self-contained documentation file that AI agents can use directly without needing to read separate files.

Changes

  • Expanded project overview: Added SDK capabilities and key architecture sections
  • Development workflow: Documented build and test scripts with examples
  • Project structure: Visual hierarchy of directories and their purposes
  • AI agent memory system: Added code location map, task recipes, and common failure solutions
  • Quick start guide: Step-by-step workflow for AI agents working on the codebase

Impact

  • Breaking changes: None
  • Dependencies: No changes
  • Performance: Documentation only, no runtime impact

Testing

How to test:

  1. AI agents should be able to understand the project structure from CLAUDE.md alone
  2. Build and test commands should be clear and executable
  3. Code location map should help agents find relevant files quickly

Replace brief reference to AGENT_README.md with complete inline documentation including build/test workflows, project structure, common task recipes, and AI agent memory system.

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
@codecov
Copy link

codecov bot commented Jan 13, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 69.77%. Comparing base (0cd2c62) to head (96b45dc).

Additional details and impacted files
@@            Coverage Diff             @@
##           master     #995      +/-   ##
==========================================
- Coverage   69.78%   69.77%   -0.02%     
==========================================
  Files         111      111              
  Lines        8983     8983              
==========================================
- Hits         6269     6268       -1     
- Misses       2714     2715       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link
Member

@Ayyanchira Ayyanchira left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved with some small optional suggestions. Would love to see how it makes difference 👍🏼

Comment on lines +150 to +152
- Create in `swift-sdk/Core/Models/YourModel.swift`
- Make it `@objcMembers public class` for Objective-C compatibility
- Implement `Codable` if it needs JSON serialization
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is nice! More specific the expectation, better will be the output!

### 📍 Code Location Map
- **Auth Logic**: `swift-sdk/Internal/AuthManager.swift` (main auth manager), `swift-sdk/Internal/Auth.swift` (auth models)
- **API Calls**: `swift-sdk/Internal/api-client/ApiClient.swift` (main client), `swift-sdk/Internal/Network/NetworkHelper.swift` (networking)
- **Models**: `swift-sdk/Core/Models/` (all data structures - CommerceItem, IterableInAppMessage, etc.)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably good to add Public facing methods go in IterableApi.swift class. Its implementation is in ApiClient.swift class.

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.

4 participants