# Deploy Mode Support & Troubleshooting

> Reference for step-05b-deploy.md — mode variations and common issues.

## Mode Support

### Standard Mode

Full handoff with all implementation details:
- All 7 file categories
- Complete BR-to-code mapping
- Full API endpoint summary
- Detailed prd.json
- Comprehensive progress tracker

### Micro Mode (use_case = micro)

Simplified handoff with minimal scope:
- Only essential CRUD entity + controller
- 3 core SeedData entries (omit some optional ones)
- Basic prd.json with simplified sections
- Lightweight progress.txt
- Display `/ralph-loop` command for later use

### Delta Mode (use_case = refactoring)

Focused handoff for changes:
- Only affected modules listed
- Reuse existing implementation patterns
- Highlight what changed vs baseline
- Update only affected prd.json sections
- Progress tracker shows only delta tasks

## Troubleshooting

| Issue | Resolution |
|-------|-----------|
| All modules missing handoff data | Return to step-05a-handoff.md. Handoff MUST be written to each module feature.json. |
| prd.json generation failed | Verify ss derive-prd command is installed and feature.json path is correct. |
| progress.txt incomplete | Ensure all CORE SeedData entries are present: 2 app-level (NavigationApplication + ApplicationRoles) + per module (NavigationModule + NavigationSections + Permissions + Roles). Check topological order. |
| BA manifest not found | Create docs/business/index.json if missing. Use schema provided in section 3. |
| Manifest entries incorrect | Verify appCode, moduleCode, and version match feature.json metadata exactly. |
| ba-interactive.html is too small (< 100KB) | FEATURE_DATA not serialized correctly. Verify JSON structure. Re-run FEATURE_DATA build. |
| moduleSpecs missing from HTML | FEATURE_DATA.moduleSpecs is empty or not included in JSON. Verify each module is iterated and populated. |
| Scope keys still show "mustHave" instead of "vital" | Conversion from feature.json keys to HTML keys failed. Check cadrage.scope conversion logic. |
| Wireframes array is empty | Verify each module has specification.uiWireframes. If missing, add wireframe stubs. |
| dependencyGraph missing | Verify master feature.json has consolidation.dependencyGraph. If missing, create empty nodes/edges arrays. |
| HTML opens but data blank (localStorage issue) | Clear browser localStorage. HTML will load pre-populated FEATURE_DATA on first load. |
| Export/re-import fails | Verify exported JSON matches original feature.json schema. Validate with `/business-analyse -x --validate`. |
