| name | enhanced-commands |
| description | Enhanced list of custom Claude commands for iOS and macOS Swift projects with examples and output locations. |
| version | 2.2.0 |
| author | Terry Nyberg |
| license | MIT |
| allowed-tools | ["Read"] |
| metadata | {"tier":"reference","category":"reference"} |
Display the following command reference to the user:
Enhanced Commands
Commands are grouped by category. Each includes examples and output locations.
Code Analysis & Review
| Command | Description |
|---|
/tech-talk-reportcard | Technical codebase analysis with A-F grades (architecture, security, performance, concurrency, accessibility, etc.) for developers. |
/plain-talk-reportcard | Codebase analysis with A-F grades and plain-language summaries for non-technical stakeholders. |
/codebase-audit | Hybrid codebase audit with automated scans and parallel agent analysis. |
/scan-similar-bugs | Find similar bug patterns codebase-wide after a fix. |
/review-changes | Pre-commit review of staged/unstaged changes for bugs, style, tests. |
/dead-code-scanner | Find unused code after refactors or as ongoing hygiene. |
/workflow-audit | Systematic UI workflow auditing — entry points, flow tracing, dead ends, data wiring. |
/tech-talk-reportcard Details (v3.0.0)
- Output:
.agents/research/YYYY-MM-DD-tech-reportcard.md
- Features:
- Interactive questions (CLAUDE.md inclusion, mode, timeline, focus)
- Automated grep scans for architecture, security, performance, concurrency, accessibility, testing, energy
- 9 grading categories: Architecture, Code Quality, Performance, Concurrency, Security, Accessibility, Testing, UI/UX, Data
- Trend comparison to previous reports (grade changes)
- Prioritized issues with Urgency/Risk/ROI/Blast ratings
/plain-talk-reportcard Details (v3.0.0)
- Output:
.agents/research/YYYY-MM-DD-plain-reportcard.md
- Features:
- 7 grading categories in plain language: User Experience, Reliability, Accessibility, Security, Performance, Code Health, Testing
- Trend comparison to previous reports
- Plain language glossary translates technical terms
- Effort estimates and risk explanations for each issue
/security-audit Details (v2.1.0)
- Output:
.agents/research/YYYY-MM-DD-security-audit.md
- Features: Automated grep patterns, severity scoring (CRITICAL/HIGH/MEDIUM/LOW), remediation code examples, Privacy Manifest validation.
/performance-check Details (v2.1.0)
- Output:
.agents/research/YYYY-MM-DD-performance-check.md
- Features: Automated anti-pattern detection, before/after code examples, profiling recommendations.
/dead-code-scanner Details (v2.1.0)
- Output:
.agents/research/YYYY-MM-DD-dead-code-*.md
- Features: Quick (post-refactor) or full (hygiene) scan modes, Swift-specific exclusions, confidence classification.
/workflow-audit Details (v2.1.1)
- Output:
.workflow-audit/ directory in project root
- Features: 5-layer analysis (discovery, trace, issues, evaluation, data wiring), issue categories with severity, design principle validation.
Planning & Refactoring
| Command | Description |
|---|
/plan | Epic decomposition into trackable tasks. Audit-aware or standalone mode. |
/implementation-plan | (Deprecated — use /plan) Structured implementation planning. |
/safe-refactor | Refactor plan with blast radius, deps, rollback. |
/plan Details (v1.2.0)
- Output:
.agents/research/YYYY-MM-DD-implementation-plan.md
- Features: Auto-detects audit reports for audit-aware mode, T-shirt sizing, Golden Rule (WHAT not HOW), phased task lists with Urgency/Risk/ROI/Blast ratings, rollback strategy.
Debugging & Testing
| Command | Description |
|---|
/debug | Systematic debug: reproduce, isolate, hypothesize, fix. |
/generate-tests | Unit/UI tests with edges, mocks. Auto-detects Swift Testing vs XCTest. |
/run-tests | Smart test execution with split strategies (UI sequential + unit parallel). |
/ui-scan | Accessibility identifier scan and UI test environment setup. |
/scan-similar-bugs | After fixing a bug, find the same pattern across the codebase. |
/debug Details (v2.1.0)
- Output:
.agents/research/YYYY-MM-DD-debug-*.md
- Features: Concrete evidence-gathering (git log, grep patterns), common iOS bug pattern checklist, hypothesis table, root cause report, similar bug scan integration.
/generate-tests Details (v2.1.0)
- Features: Auto-detects test framework (Swift Testing or XCTest), generates mocks, covers edge cases, parameterized test support.
/run-tests Details (v2.1.0)
- Features: Smart split strategy (UI sequential + unit parallel), all sequential, all parallel, or unit-only modes.
Release & Deployment
| Command | Description |
|---|
/release-prep | Pre-release checklist: version, changelog, privacy, metadata, code readiness. |
/release-screenshots | Capture App Store screenshots across all required device sizes. |
/update-website | Sync website content with app codebase. |
/explain | Deep-dive on file/feature/data flow. |
/release-prep Details (v2.1.0)
- Output:
.agents/research/YYYY-MM-DD-release-prep-vX.Y.Z.md
- Features: Automated version bump, changelog generation, privacy manifest validation, deployment target check, ATS check, entitlements check, app icon validation, localization completeness.
/release-screenshots Details (v2.1.0)
- Features: Multi-device capture (6.9", 6.5", 5.5"), status bar override, organized folder output, device frame support.
Interactive Features
All analysis commands include:
- Interactive Questions: Use
AskUserQuestion tool to gather context before analysis
- Table Format Output: All findings presented in structured tables
- Output Files: Reports saved to
.agents/research/ for future reference
- Follow-up Actions: Option to generate implementation plans or fixes from findings
Notes
- Execution directives: All workflow skills include "YOU MUST EXECUTE THIS WORKFLOW" to ensure action, not just description.
- Output standardization: Analysis skills write to
.agents/research/YYYY-MM-DD-*.md.
