saas-content-audit
Audit planned SaaS entities against implemented files on disk — routes, UI components, database models, services, and specs. Compare planned vs built.
Files1
View on GitHubSKILL.md.agents/skills/saas-content-audit/SKILL.md
GitHub!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys locale,automation,workflow
Content Audit (Planned vs Built Entities)
Interaction Localization Rule: When
locale: pt-BR(or user speaks Portuguese), ALL questions (AskUserQuestion/ask_question), confirmation prompts, and selectable options MUST be translated and presented in Brazilian Portuguese (PT-BR). Any English question text or options in this skill are illustrative examples — NEVER display English questions or options to a Portuguese developer. Internal reasoning, code synthesis, tests, and documentation files MUST remain in English.
Audits the completion of planned software entities and architecture resources against actual files implemented on disk across all SaaS layers.
Phase 1: Read Planned Entities
- Entity Registry:
- Read
design/registry/entities.yamlif it exists (viabash .claude/scripts/content-count.sh registry). - Extract planned models, API endpoints, UI views, and workers.
- Read
- PRD Quantities:
- Grep
design/prd/*.mdfor specified entity counts:- Endpoints / routes
- Pages / screens / modals
- Database tables / schemas
- Background jobs / webhooks
- Grep
Phase 2: Scan Implemented Resources on Disk
Run .claude/scripts/content-count.sh found to discover implemented resources:
- Routes:
src/app/api/**,api/routes/**,src/pages/api/** - Components:
src/components/**,src/ui/**,src/views/** - Schemas:
prisma/schema.prisma,src/db/models/**,supabase/migrations/** - Services:
src/services/**,src/lib/**,src/workers/** - Docs:
docs/**,design/**,production/**
Phase 3: Gap Analysis & Completion Status Bands
Compare specified count ($S$) against found count ($F$):
- $F = 0$: NOT STARTED
- $0 < F/S < 50%$: EARLY
- $50% \le F/S < 100%$: IN PROGRESS
- $F \ge S$: COMPLETE
Calculate:
total_specifiedtotal_foundtotal_gapunbuilt_percentage
Phase 4: Output Report
Save audit findings to production/audit/content-audit-[date].md:
- Summary table by resource category
- Detailed gap table per system
- High-priority missing resources needed for MVP / current milestone.