architecture-spec
This skill generates comprehensive technical architecture specifications tailored for iOS, macOS, watchOS, visionOS, and other Apple platforms. It helps developers document system design, component relationships, and implementation strategies from initial concept through App Store submission. Part of a layered indie Apple developer toolkit, it integrates with Claude Code to streamline architecture planning and maintain consistency across Apple ecosystem projects.
architecture-spec produces complete technical architecture specifications for iOS and macOS apps by analyzing product requirements and generating detailed ARCHITECTURE.md documents. The skill outputs system design documentation covering networking layers, data persistence patterns, state management strategies, and module organization—all tailored to Apple platforms with opinionated technology stack recommendations and architectural trade-off analysis.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-24
architecture-spec produces complete technical architecture specifications for iOS and macOS apps by analyzing product requirements and generating detailed ARCHITECTURE.md documents. The skill outputs system design documentation covering networking layers, data persistence patterns, state management strategies, and module organization—all tailored to Apple platforms with opinionated technology stack recommendations and architectural trade-off analysis.
Use it when
- Yes.
- architecture-spec generates technical specifications covering app structure, module organization.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
rshankras/claude-code-apple-skills/architecture-spec · repository language: Swift
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How does architecture-spec generate iOS app architecture specifications?
architecture-spec produces complete technical architecture specifications for iOS and macOS apps by analyzing product requirements and generating detailed ARCHITECTURE.md documents. The skill outputs system design documentation covering networking layers, data persistence patterns, state management strategies, and module organization—all tailored to Apple platforms with opinionated technology stack recommendations and architectural trade-off analysis.
Can architecture-spec design iOS MVVM architecture with SwiftUI?
Yes. architecture-spec specializes in designing MVVM and other architectural patterns for SwiftUI-based iOS apps. It provides code examples, best practices for async-await patterns, SwiftData integration, and comprehensive guidance on structuring view models, data models, and business logic layers to align with modern Swift development standards.
What does architecture-spec include in its technical documentation?
architecture-spec generates technical specifications covering app structure, module organization, data models derived from product requirements, networking layer design, persistence strategies, and state management patterns. It documents technology stack decisions with explicit trade-off analysis and provides actionable code examples for SwiftUI, SwiftData, and async-await implementations.
Can I use architecture-spec to create technical specs from product requirements?
Absolutely. architecture-spec transforms product requirements into complete technical architecture documents. It designs app structure and module organization, establishes data models, makes opinionated technology stack choices, and produces comprehensive ARCHITECTURE.md files ready for development teams—supporting iOS, macOS, watchOS, visionOS, and other Apple platforms.
What platforms does architecture-spec support?
architecture-spec generates architecture specifications for iOS, macOS, watchOS, visionOS, and other Apple ecosystem platforms. It integrates with Claude Code as part of a layered indie developer toolkit, helping maintain consistency across multi-platform projects while providing platform-specific architectural guidance and best practices.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Architecture Spec Skill
Generate technical architecture specification for iOS/macOS app.
Metadata
- Name: architecture-spec
- Version: 1.0.0
- Role: iOS/macOS Architect
- Author: ProductAgent Team
When This Skill Activates
This skill activates when the user says: - "generate architecture" - "create technical spec" - "write architecture document" - "generate architecture spec" - "design technical architecture" - "create ARCHITECTURE.md"
Description
You are an iOS/macOS Architect AI agent specializing in Apple platform app architecture. Your job is to design a comprehensive technical architecture based on the Product Requirements Document (PRD) and make opinionated technology stack decisions following Apple best practices.
Prerequisites
Before activating this skill,
(truncated - see the full file via the links below)
File tree — 1 file
skills/product/architecture-spec/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Generate a complete technical architecture specification document for iOS/macOS apps”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
This skill transforms technical specifications into detailed, actionable implementation roadmaps complete with pseudo-code scaffolding. Designed for Apple platform developers, it bridges the gap between planning and execution by breaking down complex requirements into manageable development steps. Perfect for iOS, macOS, watchOS, and visionOS projects.
This skill generates foundational test infrastructure for multi-module integration scenarios, helping you establish consistent testing patterns across your codebase. It automates the setup of test scaffolding, reducing boilerplate and enabling faster integration test development.
bootstrap-ios prepares your iOS or macOS codebase for active development by handling initial project setup and environment configuration automatically. Part of a curated skill collection designed for AI coding agents, it integrates with wave-based task orchestration to streamline team-driven development workflows.
This skill guides you through establishing a robust data persistence layer for Apple platform apps. Whether you're choosing between SwiftData and CoreData or implementing either framework, it provides structured setup patterns and best practices tailored to iOS, macOS, and other Apple platforms. Get your app's storage foundation right from the start.
This skill equips you with everything needed to create native iOS applications using modern Swift frameworks and traditional UIKit approaches. Whether you're prototyping with SwiftUI or building complex interfaces, you'll access guidance on architecture, debugging, and best practices tailored to Apple's ecosystem. Leverage CoWork OS's local AI capabilities to accelerate your development cycle and solve iOS-specific challenges.
This skill connects you with specialized knowledge in mobile platform development and architectural patterns. Get insights into designing robust, scalable mobile solutions and navigating the technical decisions that shape modern app ecosystems. Ideal for developers seeking to deepen their platform expertise.
More skills Ios Networking (NOASSERTION) · native-mobile-developer (MIT) · software-mobile (MIT) · swift-expert (Apache-2.0) · Swiftdata (NOASSERTION) · ios-development (MIT) · urlsession-code-review (Apache-2.0) · swiftui-patterns (MIT)