Workflow Overhaul — 2026-03-08

Complete review and rebuild of the OmelasAI development workflow spanning skills, documentation, network configuration, and governance.

What Changed

1. Skills System (16 commands)

Removed 4 skills that contradicted persistent-session strategy:

• terminal.md — exited Claude to tmux (Claude should never exit)
• handover.md — replaced by end-session
• change-project.md — redundant with end-session
• end-day.md — replaced by end-session

Created 7 new skills:

Updated 2 existing skills: /commit (added docs hint), /onboard-repo (creates OPS-LOG.md, docs/)

2. CLAUDE-BASE.md — Two-Layer Governance

Created mandatory foundation template that ALL container CLAUDE.md files must inherit:

• Section 1.1: Claude Net is FIRST CHOICE for inter-container messaging
• Section 1.2: External emails are DRAFT ONLY — never send
• Section 1.4: Session persistence — Claude never exits
• Section 1.5: No server access without explicit permission
• Section 1.6: Never commit secrets

Source: OmelasAI/claude-skills → CLAUDE-BASE.md

3. Network Configuration

Centralized source of truth for all infrastructure:

• All 5 LXC container IPs, SSH ports (2211–2215), mosh UDP ranges
• All 7 production/dev server details
• SSH config templates and developer connection scripts
• OVH5 iptables port forwarding rules
• Propagation script for pushing config to all containers

Source: OmelasAI/claude-skills → infrastructure/network-config.md

4. Project Documentation

• OPS-LOG.md created in ALL 12 repositories
• CLAUDE.md created for 6 previously undocumented projects
• Container CLAUDE.md templates for seanclaude and jazclaude

5. Standard Project Structure

Every OmelasAI project now has:

project-root/
├── CLAUDE.md        # AI context — architecture, rules, deployment
├── HANDOVER.md      # Last session state (auto-generated)
├── CHANGELOG.md     # Significant changes log
├── OPS-LOG.md       # Operational incidents (append-only)
├── docs/
│   ├── architecture.md
│   └── deployment.md
└── .gitignore

Status