commands-production-audit
type: command component_type: command name: production-audit description: Comprehensive production readiness audit usage: /production-audit [--quick|--full|--report] [path] arguments:
- name: path type: string required: false description: Path to audit (default: project root) options:
- name: --quick type: boolean default: false description: Quick audit (critical items only)
- name: --full type: boolean default: true description: Full comprehensive audit
- name: --report type: boolean default: false description: Generate detailed report file
- name: --category type: string default: all description: Audit specific category moe_confidence: 0.878 track: M quality_score: 80 moe_classified: 2026-01-03 last_reviewed: '2026-02-12'
/production-audit - Production Readiness Audit Command
Purpose
Perform comprehensive production readiness audit against CODITECT standards with scoring and remediation guidance.
Usage
# Full audit (default)
/production-audit
# Quick audit
/production-audit --quick
# Generate report file
/production-audit --report
# Audit specific category
/production-audit --category security
Required Tools
| Tool | Purpose | Required |
|---|---|---|
Read | Access project files for audit | Yes |
Glob | Find files matching patterns | Yes |
Grep | Search for patterns (secrets, issues) | Yes |
Bash | Run git, linting, security tools | Optional |
Write | Generate report file (if --report) | Optional |
Agent Used:
production-readiness-auditor- Main audit execution
Categories
| Category | Weight | What's Checked |
|---|---|---|
| Repository Structure | 15% | Required files, directories |
| Documentation | 20% | README coverage, quality |
| File Organization | 15% | Naming, placement |
| Git & Version Control | 10% | .gitignore, history |
| Code Quality | 15% | Tests, linting |
| CI/CD | 10% | Pipelines, automation |
| Security | 10% | Secrets, scanning |
| Metadata | 5% | Frontmatter, versions |
Output
Summary
## Production Readiness Audit
Score: 78/100 (Grade C+)
Status: ⚠️ Needs Improvement
Blocking Issues: 3
High Priority: 5
Medium Priority: 8
Detailed Report
## Detailed Scores
| Category | Score | Max |
|----------|-------|-----|
| Repository Structure | 12 | 15 |
| Documentation | 14 | 20 |
| File Organization | 13 | 15 |
| Git & Version Control | 8 | 10 |
| Code Quality | 12 | 15 |
| CI/CD | 8 | 10 |
| Security | 7 | 10 |
| Metadata | 4 | 5 |
## Blocking Issues
1. Missing CLAUDE.md at root
2. Exposed API key in config
3. No CI/CD pipeline
## Remediation Plan
Phase 1 (Critical):
- [ ] Create CLAUDE.md
- [ ] Remove exposed secrets
- [ ] Add basic CI/CD
Projected Score: 88/100 (B+)
Grades
| Score | Grade | Status |
|---|---|---|
| 95-100 | A+ | Exemplary |
| 90-94 | A | Production Ready |
| 85-89 | A- | Production Ready |
| 80-84 | B+ | Near Ready |
| 75-79 | B | Acceptable |
| 70-74 | C+ | Needs Work |
| <70 | C-F | Not Ready |
Related Commands
/organize- Fix organization issues/structure- Structure validation/readme-gen- Documentation fixes/naming-check- Naming fixes
Agents Used
production-readiness-auditor
Action Policy
<default_behavior> This command audits production readiness. Provides:
- Category-by-category scoring
- Issue identification
- Remediation guidance
- Report generation
Read-only unless --auto-fix specified. </default_behavior>
Success Output
When production-audit completes:
✅ COMMAND COMPLETE: /production-audit
Score: <N>/100
Grade: <grade>
Blocking: <N> issues
Status: <Production Ready|Needs Work>
Output Validation
Before completing, verify output contains:
- Overall score (N/100)
- Grade assigned (A+ through F)
- Status (Production Ready/Needs Work/Not Ready)
- Blocking issues count with details
- Detailed scores table (8 categories)
- Remediation plan with checkboxes
- Projected score after remediation
- Report file created (if --report)
Completion Checklist
Before marking complete:
- All categories audited
- Score calculated
- Issues listed
- Remediation provided
- Report generated (if --report)
Failure Indicators
This command has FAILED if:
- ❌ Path not found
- ❌ Audit failed
- ❌ No score generated
- ❌ Report incomplete
When NOT to Use
Do NOT use when:
- Quick check only (use /organize --score)
- Single file review
- Non-project directory
Anti-Patterns (Avoid)
| Anti-Pattern | Problem | Solution |
|---|---|---|
| Ignore blocking | Can't deploy | Fix critical first |
| Skip categories | Incomplete audit | Full audit |
| No report | Lost insights | Use --report |
Principles
This command embodies:
- #3 Complete Execution - Full audit
- #9 Based on Facts - Score-based assessment
- #6 Clear, Understandable - Clear grades
Full Standard: CODITECT-STANDARD-AUTOMATION.md
Version: 1.0.0 Created: 2026-01-02