charleswiltgen__axiom/MARKETPLACE-SUBMISSION.md

# Axiom Marketplace Submission Guide

## Plugin Details

**Plugin Name** axiom
**Repository** https://github.com/CharlesWiltgen/Axiom
**License** MIT

## Description

Battle-tested Claude Code skills for modern xOS (iOS, iPadOS, watchOS, tvOS) development

## Installation

```bash
/plugin marketplace add CharlesWiltgen/Axiom
```

Users can then install Axiom from the marketplace within Claude Code using `/plugin`.

## What's Included

13 production-ready, battle-tested skills organized in 4 categories:

### Debugging & Troubleshooting (5 skills)
- **Xcode Debugging** – Environment-first diagnostics, prevents 30+ minute rabbit holes
- **Memory Debugging** – Systematic leak diagnosis covering 90% of real-world issues
- **Build Troubleshooting** – CocoaPods/SPM dependency resolution
- **Performance Profiling** – Instruments decision trees for CPU, memory, battery profiling
- **UI Testing** – Condition-based waiting patterns and Recording UI Automation (Xcode 26)

### Concurrency & Async (1 skill)
- **Swift Concurrency** – Swift 6 strict concurrency patterns, actor isolation, Sendable, data race prevention

### UI & Design (4 skills)
- **Liquid Glass** – Apple's new material design system (iOS 26+)
- **SwiftUI Performance** – New SwiftUI Instrument in Instruments 26, Cause & Effect Graph
- **SwiftUI Debugging** – View updates, preview crashes, layout issues with decision trees
- **UI Testing** – Covered above under Debugging & Troubleshooting

### Persistence (4 skills)
- **Database Migration** – Safe schema evolution, prevents data loss for 100k+ user apps
- **SwiftData** – @Model, @Query patterns, CloudKit integration, iOS 26+ features
- **SQLiteData** – Point-Free's type-safe SQLite patterns, batch performance
- **GRDB** – Raw SQL queries, ValueObservation, DatabaseMigrator patterns

## Quality Assurance

### Testing Methodology
- **TDD-Tested** 3 core skills (xcode-debugging, swift-concurrency, database-migration) validated with RED-GREEN-REFACTOR cycles
- **Pressure Testing** Validated under App Store deadline pressure, authority pressure, misinterpretation scenarios
- **Research-Validated** WWDC 2025 skills (Liquid Glass, SwiftUI Performance, UI Testing) reviewed against official guidance
- **Peer-Reviewed** Reference skills (persistence) reviewed for accuracy and completeness

### Key Metrics
- **Reduces debugging time** 30+ min → 2-5 min (Xcode issues)
- **Memory leak diagnosis** 2-3 hours → 15-30 min
- **Test reliability** From flaky (50% CI failures) → reliable
- **Performance** Systematic optimization vs. guessing

## Documentation

- **README.md** – Installation, skill overview, philosophy
- **SKILLS-SUMMARY.md** – Comprehensive overview of all 13 skills
- **Documentation Website** – Full VitePress site at https://charleswiltgen.github.io/Axiom/
- **Individual Skill Pages** – Each skill has detailed documentation with examples

## Community Marketplaces (Recommended)

Consider submitting to established Claude Code marketplaces for broader discovery:

1. **Popular Marketplaces**
   - [ananddtyagi/claude-code-marketplace](https://github.com/ananddtyagi/claude-code-marketplace)
   - [EveryInc/every-marketplace](https://github.com/EveryInc/every-marketplace)
   - [jeremylongshore/claude-code-plugins-plus](https://github.com/jeremylongshore/claude-code-plugins-plus)

2. **Submission Process**
   - Open an issue on the marketplace repository
   - Provide:
     - Plugin name and description
     - Repository URL
     - Brief overview (1-2 sentences)
   - Maintainers will review and add to their marketplace

## Support & Contributing

- **GitHub Issues** Report bugs and request features
- **Contributing** See CONTRIBUTING.md for guidelines
- **Documentation** Website at https://charleswiltgen.github.io/Axiom/

## License

MIT License – Free for personal and commercial use

## Keywords

iOS, debugging, swift, claude-code, plugin, persistence, testing, performance, xcode, concurrency, database, swiftdata, grdb, liquid-glass, swiftui

---

**Status** ✅ Ready for marketplace submission
**Last Updated** 2025-11-30