Every file under docs/internal/ ends up in the bootstrap/skills-memory
artifact (per metadata.json: "Full project docs, internal docs, identity
files, and skill definitions"). Stale handoffs, dated build reports,
single-commit reviews, and superseded design notes were polluting the
embedding index with low-signal chunks.
Removed:
- TLS-CERT-LIFECYCLE-HANDOFF.md, GLASSPANE-FREEBSD-HANDOFF.md,
CMS-ASTRO-SOURCE-OF-TRUTH-HANDOFF.md (handoffs whose work has landed)
- HOST-DB-READINESS-REVIEW.md, HOST-DB-REBOOT-REVIEW.md,
HOST-DB-RECOVERY-PLAN.md, SYSTEM-NAMESPACE-BRANCH-REVIEW.md
(commit/branch reviews self-marked as historical)
- BUILD-TEST-REPORT-06.APR.2026.md, test-results.md (dated snapshots)
- DEBUG_CHECKLIST.md (Feb 2026 known-issues list, top item already fixed)
- BOOTABLE-ISO-PLAN-V1.md (V1 plan; ISO-FIRST-BOOT-IMPLEMENTATION.md is now
the source of truth)
- STRAPI-FREEBSD-SETUP.md, PI-SKILLS-INTEGRATION.md, CODEX-FREEBSD.md
(workarounds and one-off design notes for resolved/superseded paths)
- REFACTOR-PLAN.md, nanoclaw-architecture-final.md, AGENT-HARNESS-V2.md,
AGENT-SKILLS-VS-REALITY.md (older planning/architecture docs whose
decisions are now in code or ARCHITECTURE.md)
- BUILTIN-KNOWLEDGE-SPEC.md, LOCAL-KNOWLEDGE-BOOTSTRAP.md (early specs
superseded by SKILLS-ARTIFACT-V1-PLAN.md)
- HEARTBEAT.md (design doc; implementation lives in scripts/heartbeat.sh
and src/controlplane-heartbeat.ts)
- POSTGRES-PERMISSIONS.md (one-off fix recipe)
- RUNTIME-MANIFEST-DESIGN.md (status: Implemented; design is in code now)
Updates to remaining files patch broken cross-links:
- ARCHITECTURE.md drops the two table rows pointing at deleted docs
- doc/THREE-BIRD-ARCHITECTURE.md drops Strapi-setup link references
- docs/internal/SKILLS-ARTIFACT-V1-PLAN.md drops the "Depends on" line
- docs/internal/SUDO_REPLACEMENT.md trims its list of internal docs that
reference sudo
- .agent/skills/setup and .agent/skills/docs-deployment drop pointers to
REFACTOR-PLAN and DEBUG_CHECKLIST
Net: 23 files deleted, 7566 lines removed. docs/internal/ goes from 41 to
18 markdown files. The artifact's next refresh will see proportionally
less noise in retrieval.
---
Build: FAIL | Tests: FAIL — 16 failed
Add comprehensive docs-deployment skill for host-level multi-language documentation:
SKILL.md:
- Complete skill definition and guide (600+ lines)
- Architecture overview and deployment flow
- Multi-language support (en, de, fr, es)
- Crowdin integration workflow
- Troubleshooting guide
- Quick reference for common tasks
- Performance metrics and capacity planning
Templates:
- nginx-vhost-template.conf: Production-ready multi-language routing
* Language-specific locations (/en/, /de/, /fr/, /es/)
* Zero-downtime symlink swaps
* SSL/TLS configuration
* Security headers and caching
- language-selector.html: Beautiful language picker UI
* Mobile-responsive design
* Supports 4 languages
* Links to Crowdin translation project
Date Format Fix (User-Facing):
- Change from YYYYMMDD (20260324) to DD.mon.YYYY (24.mar.2026)
- docs-compile.sh: Update date generation and validation
- docs-sync.cron.sh: Update to match compile.sh format
- All version directories now human-readable: docs-v0.9.0_24.mar.2026
This format is:
- User-friendly (appears in directory names, documentation)
- Consistent with Slovenian date preferences
- Easily sortable (day.month.year order)
- Clear in translated documentation
Skill enables operators and authors to:
- Understand the complete documentation deployment system
- Set up Crowdin projects from scratch
- Troubleshoot common issues
- Monitor deployment health
- Perform rollbacks and manual syncs
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
---
Build: pass | Tests: FAIL — Tests 2 failed | 487 passed | 10 skipped (499)
