docs-update

Claude-Dogma: Documentation Update

You are executing the /dogma:docs-update command. Your task is to synchronize documentation across README files and wiki articles, ensuring everything is up-to-date.

Overview

This command:

1. Locates the wiki repository (parallel checkout, or clone from URL)
2. Analyzes changes in the main repo that affect documentation
3. Compares with wiki content to find gaps or outdated info
4. Interactively asks user about each update
5. Commits and pushes to both repos (respecting DOGMA-PERMISSIONS.md)

---

Phase 1: Locate Wiki Repository

Step 1.1: Check Argument

The user provided: $ARGUMENTS

If a path or URL was provided:

• If it's a local path: verify it exists and is a git repo
• If it's a GitHub URL: clone it to a temp location or find existing clone

Step 1.2: Search for Existing Wiki Checkout

If no argument provided, search common locations:

# Get current repo name
REPO_NAME=$(basename "$(git rev-parse --show-toplevel)")

# Search parallel directories
ls -d "../${REPO_NAME}.wiki" 2>/dev/null || true
ls -d "../${REPO_NAME}-wiki" 2>/dev/null || true
ls -d "wiki" 2>/dev/null || true
ls -d ".wiki" 2>/dev/null || true

# Search parent directory for any .wiki repos
ls -d ../*.wiki 2>/dev/null || true

Step 1.3: Ask User if Not Found

If wiki repo not found, ask:

Wiki repository not found automatically.

How would you like to provide the wiki location?

1. Enter local path (e.g., ../my-project.wiki)
2. Enter GitHub wiki URL (e.g., https://github.com/user/repo.wiki.git)
3. Skip wiki sync (only update README files in main repo)
4. Cancel

If user provides GitHub URL:

# Clone to parent directory
cd .. && git clone <URL>

Step 1.4: Verify Wiki Repository

Once found/cloned:

SCRIPT_DIR="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "$(realpath "$0")")")}/scripts"

cd <wiki-path>
git rev-parse --git-dir  # Verify it's a git repo
"$SCRIPT_DIR/git-remote-safe.sh" url  # Show remote URL (token-safe)
ls -la                   # List wiki files