convez.ai
SkillProdutividadeAvançado
kbelasheuski

iOS Architecture Skills

kbelasheuski/ios-architecture-skills

Audite e migre arquiteturas iOS com guias estruturados e padrões

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude que auxilia na escolha, auditoria, refatoração e migração de arquiteturas em apps iOS. Cobre 12+ padrões (MVC, MVVM, VIPER, Clean Architecture, TCA, Redux e outros) com playbooks estruturados, análise de código e recomendações de migração.

Instalação

$npx convez-ai kbelasheuski/ios-architecture-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Escolher arquitetura adequada para novo app iOS baseado em requisitos
  • Auditar codebase existente e recomendar refatoração ou migração
  • Executar migração any-to-any entre padrões arquiteturais
  • Consultar trade-offs e anti-patterns de padrões específicos (MVVM, Clean, TCA, RIBs, etc)

Veredito

Skill maduro e bem-estruturado para times iOS que precisam tomar decisões arquiteturais informadas. Abordagem pragmática com referências detalhadas, mas requer experiência sólida em arquitetura e Swift para máxima utilidade.

README

A tradução para o português deste README ainda está na fila.

iOS Architect is a plugin-ready architecture skill with reference playbooks for choosing, auditing, refactoring, and migrating iOS app architectures. It covers MVC, MVP, MVVM (Combine and @Observable), MVVM-C, MVI, Reactive Combine/Rx, Coordinator, VIPER, Clean Swift, Clean Architecture, TCA, Redux/ReSwift, RIBs, and modular SPM/Tuist setups.

The bundle is intentionally lean: the installable plugin package lives in plugin/, the router skill lives at plugin/skills/ios-architect/SKILL.md, and detailed playbooks live under plugin/skills/ios-architect/references/. The repo keeps only marketplace manifests plus the skill package; runtime-specific custom-agent examples are intentionally not included.

What You Get

PartWhat it does
references/researcher.mdChooses an architecture for a new app through structured discovery questions.
references/analyser.mdAudits an existing codebase, scores it on practical architecture axes, and recommends refactor or migration.
references/migrator.mdProvides an any-to-any migration playbook built on reusable migration primitives.
references/selection-guide.mdProvides quick routing when the pattern is unclear or the requested pattern looks mismatched.
references/<pattern>.mdOne per pattern: when to use it, folder layout, trade-offs, corner cases, anti-patterns, and a worked example.

The agent should route to the most specific reference for the task and only pull in heavier reference material when the implementation details matter. Shared routing notes live in plugin/skills/ios-architect/references/.

Architectures

#PatternIdentityUI fitSweet spot
1MVCView controller owns everythingUIKitPrototypes, small UIKit apps
2MVPPassive view + Presenter owns presentation logicUIKitUIKit apps that need testable presentation
3MVVM-UIKitViewModel + bindingsUIKitMainstream UIKit production
4MVVM-SwiftUI@Observable or Combine model + declarative viewSwiftUIMainstream SwiftUI production
5MVVM-CMVVM + Coordinator/Router owns navigationUIKit and SwiftUIMedium/large apps, deep-linking
6MVIState + Intent + dispatch, unidirectionalUIKit and SwiftUIDeterministic feature state without TCA
7ReactiveCombine/Rx input streams -> stateUIKit and SwiftUISearch, live feeds, replacement requests
8CoordinatorNavigation layer with typed routes/flowsUIKit and SwiftUIDeep links and reusable flows
9VIPERView-Interactor-Presenter-Entity-RouterUIKitLarge, long-lived UIKit codebases
10Clean SwiftVIP cycle: View -> Interactor -> Presenter -> ViewUIKitVIPER-like boundaries with less routing ceremony
11Clean ArchitectureLayered Domain/Data/Presentation + Use CasesUIKit and SwiftUIDomain-heavy apps with long lifespan
12TCAState/Action/Reducer/Store, unidirectionalSwiftUICorrectness-critical SwiftUI
13Redux/ReSwiftSingle global store, pure reducers, middlewareUIKit and SwiftUICross-platform shared logic
14RIBsRouter-Interactor-Builder treeUIKitUber-scale teams and deeply nested state
15Modular TMABuild-graph layer; each feature is a moduleUIKit and SwiftUILarger teams or codebases; composes with the above

Full per-pattern analysis is in iOS-Architecture-Comparison.md, with a score grid in iOS-Architecture-Comparison.xlsx.

Enable

This repo is packaged as a marketplace for Claude Code and Codex:

RuntimeManifestContents
Codex.agents/plugins/marketplace.jsonplugin/.codex-plugin/plugin.json plus the router skill and references
Claude.claude-plugin/marketplace.jsonplugin/.claude-plugin/plugin.json plus the router skill and references

For Claude Code:

claude plugin marketplace add kbelasheuski/ios-architecture-skills
claude plugin install ios-architect@ios-architecture-skills

For Codex:

codex plugin marketplace add kbelasheuski/ios-architecture-skills
codex plugin add ios-architect@ios-architecture-skills

After install, both runtimes expose the ios-architect router skill and its references through the plugin package.

Usage

Common prompts and the reference they should route to:

PromptReference
"Recommend an architecture for a new app"references/researcher.md
"Audit this codebase and tell me what architecture we have"references/analyser.md
"Make a plan to migrate from VIPER to TCA"references/migrator.md
"Show me the TCA folder structure for a new feature"references/tca.md
"What are the corner cases for MVVM-C in SwiftUI?"references/mvvm-c.md
"Model this feature as State + Intent without TCA"references/mvi.md
"This search screen needs debounce and latest request wins"references/reactive.md
"Extract navigation and deep links out of these screens"references/coordinator.md
"We are not sure which architecture fits"references/selection-guide.md

License

MIT

Ver o original no GitHub

Bom para

Relacionados