Menu
Tech health check: documentation, security, architecture, data analysis. Use when user requests project audit, tech debt review, or health check.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Consolidated view of the add-pro ecosystem - commands, skills, relationships and dependencies. Loaded by /add as source of truth.
Source of truth for ADD doc rules, depth floors, IDs, refs, validation gate. Load before any doc write.
Use when running agent-judged QA validation (read-PNG by default; the playwright plugin adds live driving) โ the Level C judge rubric, severity taxonomy, dual-judge (@ux-agent review โฅ @qa-agent) method, report schema/template, and the config.json/screens.json formats. Consumed by /add.qa and both judges.
Use when a state-materializing command starts or is asked to upgrade โ reads the setup receipt, compares the recorded contract against the shipped one, executes the declared upgrade deltas sequentially, and rewrites the receipt even on a verified-current no-op. Consumed by /add.qa-setup STEP 1.5 and STEP 11.
Internal skill for developing ADD framework artefacts (commands, skills, agents, scripts). Use when add-framework--plan analyzes viability of new framework features, when add-framework--build implements framework artefacts, or when creating/modifying commands, skills, or agents. Always use this skill before proposing or implementing changes to the framework itself.
Use when building, styling, or theming UI components, pages, layouts, dashboards, charts, tables, or forms for SaaS products.
| name | add-health-check |
| description | Tech health check: documentation, security, architecture, data analysis. Use when user requests project audit, tech debt review, or health check. |
Suite of skills for complete technical analysis of the project. Always consult CLAUDE.md for general project standards.
/tech-health-check
โโโ PHASE 1 - DISCOVERY (parallel)
โ โโโ context-discovery โ architecture, multi-tenancy, modules
โ โโโ documentation-analyzer โ CLAUDE.md, patterns
โ โโโ infrastructure-check โ MCP, env vars, deps
โ
โโโ PHASE 2 - ANALYSIS (parallel, depends on Phase 1)
โ โโโ security-analyzer โ RLS, secrets, boundaries
โ โโโ architecture-analyzer โ clean arch, imports, CQRS
โ โโโ data-analyzer โ migrations, indexes, N+1
โ
โโโ PHASE 3 - CONSOLIDATION
โโโ HEALTH-REPORT.md โ scorecard + roadmap
| Pillar | Level | Reason |
|---|---|---|
| Documentation | ๐ด Critical | impacts AI dev quality |
| Security | ๐ด Critical | data leaks, privacy |
| Architecture | ๐ High | accumulating tech debt |
| Data | ๐ก Medium | performance, consistency |
| Infrastructure | ๐ต Info | prerequisite for analysis |
Phase 1: context-discovery โ context-discovery.md; documentation-analyzer โ documentation-report.md; infrastructure-check โ infrastructure-report.md.
Phase 2: security-analyzer (deps: context, infrastructure) โ security-report.md; architecture-analyzer (deps: context) โ architecture-report.md; data-analyzer (deps: context, infrastructure) โ data-report.md.
/tech-health-check
Process:
docs/health-checks/YYYY-MM-DD/ with current dateOutput files: context-discovery.md, documentation-report.md, infrastructure-report.md, security-report.md, architecture-report.md, data-report.md, HEALTH-REPORT.md.
Reports written for entrepreneurs who may not be technical โ accessible style, prioritized critical โ desirable. Language follows owner.md (default English); technical terms stay in EN; glossary included in HEALTH-REPORT.md.