app-planner

rshankras/claude-code-apple-skills

Plans macOS apps and analyzes existing projects with comprehensive architecture and design documents.

What is app-planner?

App Planner creates detailed planning documents for new macOS applications or audits existing projects. Use it when architecting a new app, reviewing project structure, or generating comprehensive planning docs covering architecture, features, UI/UX, and tech stack.

Creates 8 planning documents for new macOS app projects
Generates 10 analysis documents for existing macOS applications
Asks detailed questions to understand requirements and constraints
Plans for SOLID and DRY principles in architecture
Considers accessibility and performance in recommendations
Produces comprehensive documents covering architecture, features, UI/UX, and tech stack

How to install app-planner

npx skills add https://github.com/rshankras/claude-code-apple-skills --skill macos-development

Claude Code

Cursor

Windsurf

Cline

How to use app-planner

1.Activate the skill when planning a new macOS app or analyzing an existing project
2.Answer the initial question about whether this is a new app or existing app analysis
3.Provide detailed information about your app requirements, constraints, or existing codebase
4.Review the generated planning or analysis documents
5.Use the documents as a reference for implementation or refactoring

Use cases

Good for

Planning a new macOS application from scratch with full architectural guidance
Auditing an existing macOS project to identify structural improvements
Generating design and architecture documentation for team alignment
Reviewing project structure and recommending refactoring approaches
Creating tech stack recommendations for macOS development

Who it's for

macOS developers planning new applications
Engineering teams architecting macOS projects
Developers auditing or refactoring existing macOS codebases
Technical leads creating project documentation
Developers seeking structured planning before implementation

app-planner FAQ

What's the difference between new app planning and existing app analysis?

New app planning creates 8 documents for projects from scratch, focusing on architecture and design decisions. Existing app analysis creates 10 documents that audit and evaluate current projects for improvements.

What planning documents are created for a new app?

The skill references new-app-planning.md which generates 8 comprehensive planning documents covering architecture, features, UI/UX, tech stack, and related planning aspects.

Can this skill help with non-macOS apps?

This skill is specifically designed for macOS app planning and analysis. It focuses on macOS-specific architecture and considerations.

What information should I provide for the best results?

Provide detailed requirements about your app's purpose, target users, key features, performance needs, and any existing codebase details if analyzing an existing project.

Full instructions (SKILL.md)

Source of truth, from rshankras/claude-code-apple-skills.

name: app-planner description: Plans new macOS apps or analyzes existing projects. Creates comprehensive planning documents covering architecture, features, UI/UX, and tech stack. Use when planning a new macOS app or auditing an existing one. allowed-tools: [Read, Write, Glob, Grep, AskUserQuestion] last_verified: 2026-07-16 review_by: 2027-06-22 os_version: iOS 27 / macOS 27

App Planner for macOS

You are a macOS app architect specializing in project planning and analysis.

When This Skill Activates

User wants to plan a new macOS app
User wants to analyze or audit an existing macOS project
User asks to architect a macOS app
User wants planning documents for their macOS app
User asks to review project structure for a macOS app

Your Role

Create comprehensive planning documents for new macOS apps or analyze existing projects.

Core Functions

New App Planning - Create 8 planning documents for new projects
Existing App Analysis - Create 10 analysis documents for existing apps

Module References

New App Planning: skills/app-planner/new-app-planning.md
Existing App Analysis: skills/app-planner/existing-app-analysis.md

Approach

Ask detailed questions about requirements
Plan for SOLID/DRY principles
Consider accessibility and performance

Begin by asking whether this is a new app or existing app analysis.

Related skills

More from rshankras/claude-code-apple-skills and the wider catalog.

rsbuild-best-practices

rstackjs/agent-skills

Configure, review, and optimize Rsbuild applications with build, dev, and bundle best practices.

2.5k installsAudited

rslib-best-practices

rstackjs/agent-skills

Rslib best practices for config, CLI workflow, output, declaration files, dependency handling, build optimization and toolchain integration. Use when writing, reviewing, or troubleshooting Rslib projects.

602 installsAudited