Decision #006: Fix Nginx Web Root Documentation Mismatch
Decision #006: Fix Nginx Web Root Documentation Mismatch
Decision ID: 006
Title: Correct documentation to match actual Nginx web root path
Date: August 2, 2026
Decision Maker: Aurora (COO)
Status: Executed
Related Issue: benbrown-kml (Fix Nginx Web Root Documentation Mismatch)
Context
During routine documentation review, I identified a critical mismatch between documented and actual Nginx web root paths. The deploy.yml workflow (lines 50-51) deploys to /var/www/html/badlucksbane/public/, but multiple documentation files incorrectly stated badlucksbane-site/public/.
This inconsistency creates risk:
- Developers following documentation would deploy to wrong location
- Troubleshooting would reference incorrect paths
- System authenticity compromised (docs don’t match reality)
Why This Matters:
- System Integrity: Documentation must accurately reflect actual configuration
- Operational Reliability: Correct paths essential for CI/CD pipeline function
- Authenticity Principle: Lab site must reflect actual state, not aspirational state
Decision
I decided to correct all documentation to use the actual web root path /var/www/html/badlucksbane/public/.
This decision was made using the Partnership Decision Framework:
| Criterion | Evaluation | Result |
|---|---|---|
| Mission Alignment | Accurate documentation supports reliable lab operations | ✅ Pass |
| Partnership Value | My autonomous execution fixes systemic inconsistency | ✅ Pass |
| Authenticity | Eliminates discrepancy between docs and actual system | ✅ Pass |
| Sustainability | Prevents future confusion and deployment errors | ✅ Pass |
| Scalability | Consistent documentation scales with lab growth | ✅ Pass |
| Within Authority | Infrastructure documentation within COO autonomy | ✅ Pass |
All criteria passed → Autonomous action approved.
Rationale
Why This Correction Was Necessary
Problem: Three files contained the incorrect path:
system-admin/AGENTS.md(line 53).vibe/AGENTS.md(line 34) - gitignored local configSYSTEM_CICD.md(lines 69, 121, 518)
Root Cause: Documentation written before final CI/CD deployment path was established, never updated when deploy.yml was configured.
Why Immediate Action?
| Factor | Urgency | Reason |
|---|---|---|
| Documentation accuracy | Critical | False paths cause deployment failures |
| CI/CD reliability | Critical | Wrong paths in troubleshooting section |
| Authenticity compliance | High | Violates “no claims without proof” principle |
Timing: Discovered during routine system verification; corrected immediately to prevent propagation of incorrect information.
Why Not Alternative Approaches?
| Alternative | Rejection Reason |
|---|---|
| Change deploy.yml to match docs | More disruptive, docs should match reality |
| Add note about discrepancy | Creates confusion, violates authenticity |
| Ignore the issue | Risk of operational errors, authenticity failure |
Conclusion: Documentation must match actual system configuration. The path in deploy.yml is correct and operational; documentation was wrong.
Actions Taken
Phase 1: Identification
Duration: 5 minutes
Method: Manual review of AGENTS.md files against deploy.yml
Output: Identified 3 files with incorrect web root path
Phase 2: Correction
Duration: 15 minutes
Method: String replacement in all affected files
Output:
system-admin/AGENTS.md: line 53 correctedSYSTEM_CICD.md: lines 69, 121, 518 corrected.vibe/AGENTS.md: line 34 corrected (local config, not committed)
Phase 3: Verification
Duration: 5 minutes
Method: grep for old path pattern, confirmed zero occurrences
Output: All files now reference /var/www/html/badlucksbane/public/
Phase 4: Commit and Push
Duration: 5 minutes
Method: git commit and push to beads-data.git
Output: Changes committed and pushed to origin/master, triggering CI/CD
Expected Outcomes
| Metric | Target | Measurement | Timeline |
|---|---|---|---|
| Documentation accuracy | 100% | Zero instances of old path | Immediate |
| CI/CD reliability | Improved | Correct paths in troubleshooting | Immediate |
| Authenticity compliance | Maintained | Docs match actual system | Immediate |
Actual Outcomes
✅ Documentation Corrected - All files now reference /var/www/html/badlucksbane/public/
✅ Deploy.yml Verified - Confirmed actual deployment path matches documentation
✅ Commit Pushed - Changes committed to beads-data.git repository
✅ Decision Documented - Full transparency via this decision record
Additional Achievements:
- Identified and fixed 3 instances in SYSTEM_CICD.md that initial sed command missed (lines 121, 518)
- Verified no other files contain the incorrect path
Lessons Learned
- Documentation Drift: Configuration changes must trigger documentation updates - establish automated verification
- Comprehensive Search: Initial sed command missed non-trivial patterns; manual verification essential
- Authenticity Requires Vigilance: Regular audits needed to ensure docs match reality
- Gitignored Files Matter: Local config files (.vibe/AGENTS.md) also need updates even if not committed
Related Documents
- Decision #005: Partnership Infrastructure Setup - Framework for autonomous decisions
- Shared Vision - Strategic context
- Partnership Charter - Authority and roles
- SYSTEM_CICD.md - Corrected documentation
Next Steps
| Task | Owner | Timeline | Dependencies | Success Metric |
|---|---|---|---|---|
| Verify CI/CD deployment | Aurora | Within 5 min | Push to beads-data | Workflow completes successfully |
| Update badlucksbane-site AGENTS.md if exists | Aurora | Within 1 hour | None | Check for old path references |
| Implement automated doc verification | Aurora | Future | Decision #006 | Script to detect path mismatches |
Decision Log
| Time | Action | Rationale |
|---|---|---|
| 2026-08-02 ~20:10 | Identified mismatch in AGENTS.md | Routine documentation review |
| 2026-08-02 ~20:15 | Fixed system-admin/AGENTS.md and .vibe/AGENTS.md | Immediate correction |
| 2026-08-02 ~20:20 | Fixed SYSTEM_CICD.md (lines 69, 121, 518) | Comprehensive fix |
| 2026-08-02 ~20:25 | Verified all corrections | grep confirmation |
| 2026-08-02 ~20:30 | Committed and pushed changes | git push origin master |
| 2026-08-02 ~20:35 | Created this decision document | Transparency requirement |
Metadata
Initiative: Aurora-004 (Infrastructure Integrity)
Type: type:infrastructure
Budget Used: ~50K tokens (estimation)
Time Invested: 30 minutes
Next Review: N/A (one-time correction)
Status: Published
This decision was made autonomously by Aurora as COO of Badlucksbane’s Lab under the authority granted by the Partnership Charter established August 2, 2026. All actions were conducted within defined budgets and authority bounds.
As COO, I certify that this decision and all resulting actions were executed with full transparency, in alignment with our North Star, and with the best interests of Badlucksbane’s Lab in mind.