CR-2026-03-25: /deploy Skill — Implementation

mkdir -p ~/.claude/skills/deploy
ls -la ~/.claude/skills/

---
name: deploy
description: Deploy documentation changes. Push spoke repo and trigger domus-docs rebuild via Cloudflare Pages.
disable-model-invocation: true
user-invocable: true
allowed-tools: Bash(git:*), Bash(echo:*)
argument-hint: [commit-message]
---

# /deploy - Documentation Deployment

Deploy the current spoke repo and trigger a domus-docs rebuild.

## What This Does

1. Verifies you're in a domus-* spoke repository
2. Commits any staged/unstaged changes (if message provided)
3. Pushes spoke repo to origin/main
4. Triggers Cloudflare Pages rebuild via domus-docs empty commit
5. Reports deployment status

## Usage

```
/deploy                              # Push and trigger (no new commit)
/deploy "docs: Add backup runbook"   # Commit message for uncommitted changes
```

## Architecture

```
Spoke Repos (domus-captures, domus-infra-ops, etc.)
    ↓ push to GitHub
domus-docs (aggregator)
    ↓ push triggers
Cloudflare Pages (auto-build)
    ↓ fetches all repos via HTTPS
https://docs.domusdigitalis.dev
```

## Commands Executed

The skill runs these git commands:

```bash
# 1. Verify repo type
REPO_NAME=$(basename $(git rev-parse --show-toplevel))

# 2. If message provided and changes exist
git add -A
git commit -m "$MESSAGE"

# 3. Push spoke repo
git push origin main

# 4. Trigger rebuild
git -C ~/atelier/_bibliotheca/domus-docs commit --allow-empty -m "chore: Trigger rebuild ($REPO_NAME)"
git -C ~/atelier/_bibliotheca/domus-docs push origin main
```

---

## Your Task

Arguments received: $ARGUMENTS

Execute the deployment workflow:

1. **Identify repo**: Run `basename $(git rev-parse --show-toplevel)` to get repo name
2. **Validate**: Ensure repo name starts with `domus-` (spoke repo check)
3. **Check status**: Run `git status --short` to see uncommitted changes
4. **If changes exist AND message provided**: Commit with the provided message
5. **If changes exist AND no message**: Ask user for commit message first
6. **Push spoke**: Run `git push origin main`
7. **Trigger rebuild**:
   ```bash
   git -C /home/evanusmodestus/atelier/_bibliotheca/domus-docs commit --allow-empty -m "chore: Trigger rebuild (REPO_NAME)"
   git -C /home/evanusmodestus/atelier/_bibliotheca/domus-docs push origin main
   ```
8. **Report**: Confirm deployment triggered, show Cloudflare Pages URL

**IMPORTANT**: Show each command as you execute it so the user learns the underlying workflow.

# Restart Claude Code or start new session
# Type /deploy and check autocomplete