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.