CR-2026-03-25: Claude Code /deploy Skill Implementation

# In spoke repo (e.g., domus-captures)
git add -A
git commit -m "docs: Add new runbook"
git push origin main

# Trigger rebuild (must remember exact path)
git -C /home/evanusmodestus/atelier/_bibliotheca/domus-docs commit --allow-empty -m "chore: Trigger rebuild"
git -C /home/evanusmodestus/atelier/_bibliotheca/domus-docs push origin main

/deploy                              # Push and trigger rebuild
/deploy "docs: Add new runbook"      # With commit message (if uncommitted changes)

~/.claude/skills/
└── deploy/
    └── SKILL.md              # Skill definition

---
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 invoked
    │
    ├─► Check: Is this a domus-* spoke repo?
    │       └─► No: Exit with helpful message
    │
    ├─► Check: Any uncommitted changes?
    │       ├─► Yes + no message: Prompt for message
    │       └─► Yes + message provided: Commit with message
    │
    ├─► Push spoke repo to origin/main
    │
    ├─► Create empty commit in domus-docs
    │       └─► Message: "chore: Trigger rebuild (<spoke-name>)"
    │
    ├─► Push domus-docs to origin/main
    │
    └─► Report: URLs and status

basename $(git rev-parse --show-toplevel)

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

# 1. Remove skill
rm -rf ~/.claude/skills/deploy

# 2. Verify removal
ls ~/.claude/skills/

# 3. Restart Claude Code session