---

doc_id: DOC-2025-00001 title: lunar-snake-hub doc_type: reference status: active canonical: true created: 2025-10-30 tags: [hub, overview, reference, infrastructure] summary: Central hub for lunar-snake projects - single source of truth for specs, agent rules, build components, and shared infrastructure source: author: agent agent: claude model: sonnet-4.5

lunar-snake-hub

Central hub for lunar-snake projects - Single source of truth for specs, agent rules, and shared infrastructure.

🎯 Purpose

This repository provides:

• Specifications & RFCs - API contracts, architecture decisions, design docs
• Agent Rules - AI agent prompts, coding standards, best practices
• Pre-commit Hooks - Shared linting, formatting, security checks
• Infrastructure Templates - Docker, Terraform, GitHub Actions

🏗️ Architecture

Satellite repos (like lablab-bean) consume this hub via:

1. .hub-manifest.toml - Pins versions of packs to use
2. task hub:sync - Fetches assets to .hub-cache/ (gitignored)
3. Runtime access - Agents read rules; build orchestration is provided by the separate unify-build repository

Key principle: Satellites commit only code + manifest. All shared assets are synced at runtime.

📁 Structure

lunar-snake-hub/
├── .agent/              # Agent configs (rules, skills, workflows, adapters)
│   ├── rules/           # Coding standards & project rules
│   ├── skills/          # Reusable skills
│   ├── workflows/       # Orchestrated workflows
│   ├── adapters/        # IDE-specific configs (Cline, Roo, etc.)
│   └── scripts/         # Helper scripts for agent workflows
├── specs/              # Specifications & RFCs
│   └── {domain}/
│       └── v{version}/
│           ├── rfc.md
│           ├── adr.md
│           └── schema/
├── precommit/          # Pre-commit hooks
│   ├── .pre-commit-config.base.yaml
│   └── hooks/
├── infra/              # Infrastructure & secrets
│   ├── .sops.yaml
│   └── secrets/
│       └── *.enc.yaml
├── .github/
│   └── workflows/      # Reusable GitHub Actions
├── docs/               # Documentation
│   ├── README.md       # 📖 Documentation index
│   ├── architecture/   # Design docs & decisions
│   ├── guides/         # How-to guides
│   ├── operations/     # Runbooks & procedures
│   └── sessions/       # Session handovers & progress

🚀 Quick Start (For Satellites)

1. Add manifest to your project

.hub-manifest.toml:

[hub]
repo = "GiantCroissant-Lunar/lunar-snake-hub"

[packs]
precommit = "0.1.0"

2. Add sync task

Taskfile.yml:

tasks:
  hub:sync:
    desc: Sync assets from lunar-snake-hub
    cmds:
      - |
        if [ ! -d .hub-cache/hub-repo ]; then
          git clone https://github.com/GiantCroissant-Lunar/lunar-snake-hub .hub-cache/hub-repo
        else
          git -C .hub-cache/hub-repo pull
        fi
        cp -r .hub-cache/hub-repo/.agent .hub-cache/
        echo "✅ Hub sync complete"

3. Gitignore synced content

.gitignore:

.hub-cache/

4. Sync and use

task hub:sync
# Agents now read from .hub-cache/.agent/rules/

📚 Documentation

📖 Documentation Index - Complete guide to all documentation

Quick Access

• Quick Start - What to read first
• Phase 1 Progress - Current implementation status
• MCP Setup - Smithery server configuration
• Architecture Discussion - Complete system design
• Phase 1 Checklist - Step-by-step implementation guide

🔐 Secrets Management

Secrets are encrypted with SOPS and stored in infra/secrets/*.enc.yaml.

Decrypt:

sops decrypt infra/secrets/mac-mini.enc.yaml

Encrypt:

sops encrypt infra/secrets/mac-mini.yaml > infra/secrets/mac-mini.enc.yaml

🛠️ Infrastructure Services

This hub supports a Mac Mini "brain" running:

• Letta - Persistent agent memory
• Qdrant - Vector database for RAG
• Context Gateway - HTTP API for context retrieval
• n8n - Workflow orchestration

See infra/README.md for setup.

🔧 Build System

Build orchestration and reusable NUKE components are now owned by the dedicated unify-build repository.

Satellite repos should use unify-build for all build pipelines and publish workflows; lunar-snake-hub no longer ships build scripts or NUKE components.

📦 Versioning

Releases are tagged by pack type:

• packs-precommit-v0.1.0 - Pre-commit hooks
• spec-{domain}-v1.0.0 - Specification releases

📦 npm Package Consumption

Install into a consumer repo (runs hook installer automatically via postinstall):

npm install @giantcroissant-lunar/lunar-snake-hub

Uninstall (runs cleanup via preuninstall,

...