lmiranda
2e65b60725
Major refactoring of projman plugin architecture: Skills Extraction (17 new files): - Extracted reusable knowledge from commands and agents into skills/ - branch-security, dependency-management, git-workflow, input-detection - issue-conventions, lessons-learned, mcp-tools-reference, planning-workflow - progress-tracking, repo-validation, review-checklist, runaway-detection - setup-workflows, sprint-approval, task-sizing, test-standards, wiki-conventions Command Consolidation (17 → 12 commands): - /setup: consolidates initial-setup, project-init, project-sync (--full/--quick/--sync) - /debug: consolidates debug-report, debug-review (report/review modes) - /test: consolidates test-check, test-gen (run/gen modes) - /sprint-status: absorbs sprint-diagram via --diagram flag Architecture Cleanup: - Remove plugin-level mcp-servers/ symlinks (6 plugins) - Remove plugin README.md files (12 files, ~2000 lines) - Update all documentation to reflect new command structure - Fix documentation drift in CONFIGURATION.md, COMMANDS-CHEATSHEET.md Commands are now thin dispatchers (~20-50 lines) that reference skills. Agents reference skills for domain knowledge instead of inline content. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
224 lines
4.7 KiB
Markdown
224 lines
4.7 KiB
Markdown
# Setup Workflows
|
|
|
|
Shared workflows for the `/setup` command modes.
|
|
|
|
## Mode Detection Logic
|
|
|
|
Determine setup mode automatically:
|
|
|
|
```
|
|
1. Check ~/.config/claude/gitea.env exists
|
|
- If missing → FULL mode needed
|
|
|
|
2. If gitea.env exists, check project .env
|
|
- If .env missing → QUICK mode (project setup)
|
|
|
|
3. If both exist, compare git remote with .env values
|
|
- If mismatch → SYNC mode needed
|
|
- If match → already configured, offer reconfigure option
|
|
```
|
|
|
|
## Full Setup Workflow
|
|
|
|
Complete first-time setup including MCP servers, credentials, and project.
|
|
|
|
### Phase 1: Environment Validation
|
|
|
|
```bash
|
|
# Check Python 3.10+
|
|
python3 --version # Should be 3.10+
|
|
```
|
|
|
|
If Python < 3.10, stop and ask user to install.
|
|
|
|
### Phase 2: MCP Server Setup
|
|
|
|
1. **Locate Plugin Installation**
|
|
```bash
|
|
ls ~/.claude/plugins/marketplaces/leo-claude-mktplace/mcp-servers/gitea/
|
|
```
|
|
|
|
2. **Check Virtual Environment**
|
|
```bash
|
|
ls ~/.claude/plugins/marketplaces/leo-claude-mktplace/mcp-servers/gitea/venv/
|
|
```
|
|
|
|
3. **Create venv if Missing**
|
|
```bash
|
|
cd ~/.claude/plugins/marketplaces/leo-claude-mktplace/mcp-servers/gitea/
|
|
python3 -m venv venv
|
|
./venv/bin/pip install -r requirements.txt
|
|
```
|
|
|
|
4. **Optional: NetBox MCP Setup**
|
|
Ask user if they need NetBox integration.
|
|
|
|
### Phase 3: System-Level Configuration
|
|
|
|
1. **Create Config Directory**
|
|
```bash
|
|
mkdir -p ~/.config/claude
|
|
```
|
|
|
|
2. **Create gitea.env Template**
|
|
```env
|
|
GITEA_API_URL=https://your-gitea-instance/api/v1
|
|
GITEA_API_TOKEN=
|
|
```
|
|
|
|
3. **Token Entry (SECURITY)**
|
|
- DO NOT ask for token in chat
|
|
- Instruct user to edit file manually
|
|
- Provide command: `nano ~/.config/claude/gitea.env`
|
|
|
|
4. **Validate Token**
|
|
```bash
|
|
curl -s -H "Authorization: token $TOKEN" "$GITEA_API_URL/user"
|
|
```
|
|
- 200 OK = valid
|
|
- 401 = invalid token
|
|
|
|
### Phase 4: Project-Level Configuration
|
|
|
|
See **Quick Setup Workflow** below.
|
|
|
|
### Phase 5: Final Validation
|
|
|
|
Display summary:
|
|
- MCP server: ✓/✗
|
|
- System config: ✓/✗
|
|
- Project config: ✓/✗
|
|
|
|
**Important:** Session restart required for MCP tools to load.
|
|
|
|
---
|
|
|
|
## Quick Setup Workflow
|
|
|
|
Project-level setup only (assumes system config exists).
|
|
|
|
### Step 1: Verify System Config
|
|
|
|
```bash
|
|
cat ~/.config/claude/gitea.env
|
|
```
|
|
|
|
If missing or empty token, redirect to FULL mode.
|
|
|
|
### Step 2: Verify Git Repository
|
|
|
|
```bash
|
|
git rev-parse --git-dir 2>/dev/null
|
|
```
|
|
|
|
If not a git repo, stop and inform user.
|
|
|
|
### Step 3: Check Existing Config
|
|
|
|
If `.env` exists:
|
|
- Show current GITEA_ORG and GITEA_REPO
|
|
- Ask: Keep current or reconfigure?
|
|
|
|
### Step 4: Detect Org/Repo
|
|
|
|
Parse git remote URL:
|
|
|
|
```bash
|
|
git remote get-url origin
|
|
# https://gitea.example.com/org-name/repo-name.git
|
|
# → org: org-name, repo: repo-name
|
|
```
|
|
|
|
### Step 5: Validate via API
|
|
|
|
```bash
|
|
curl -s -H "Authorization: token $TOKEN" \
|
|
"$GITEA_API_URL/repos/$ORG/$REPO"
|
|
```
|
|
|
|
- 200 OK = auto-fill without asking
|
|
- 404 = ask user to confirm/correct
|
|
|
|
### Step 6: Create .env
|
|
|
|
```env
|
|
GITEA_ORG=detected-org
|
|
GITEA_REPO=detected-repo
|
|
```
|
|
|
|
### Step 7: Check .gitignore
|
|
|
|
If `.env` not in `.gitignore`:
|
|
- Warn user about security risk
|
|
- Offer to add it
|
|
|
|
---
|
|
|
|
## Sync Workflow
|
|
|
|
Update project config when git remote changed.
|
|
|
|
### Step 1: Read Current Config
|
|
|
|
```bash
|
|
grep GITEA_ORG .env
|
|
grep GITEA_REPO .env
|
|
```
|
|
|
|
### Step 2: Detect Git Remote
|
|
|
|
Parse current remote URL (same as Quick Step 4).
|
|
|
|
### Step 3: Compare Values
|
|
|
|
| Current | Detected | Action |
|
|
|---------|----------|--------|
|
|
| Match | Match | "Already in sync" - exit |
|
|
| Different | Different | Show diff, ask to update |
|
|
|
|
### Step 4: Show Changes
|
|
|
|
```
|
|
Current: org/old-repo
|
|
Detected: org/new-repo
|
|
|
|
Update configuration? [y/n]
|
|
```
|
|
|
|
### Step 5: Validate New Values
|
|
|
|
API check on detected org/repo.
|
|
|
|
### Step 6: Update .env
|
|
|
|
Replace GITEA_ORG and GITEA_REPO values.
|
|
|
|
### Step 7: Confirm
|
|
|
|
```
|
|
✓ Project configuration updated
|
|
GITEA_ORG: new-org
|
|
GITEA_REPO: new-repo
|
|
```
|
|
|
|
---
|
|
|
|
## Visual Header
|
|
|
|
All setup modes use:
|
|
|
|
```
|
|
╔══════════════════════════════════════════════════════════════════╗
|
|
║ 📋 PROJMAN ║
|
|
║ ⚙️ SETUP ║
|
|
║ [Mode: Full | Quick | Sync] ║
|
|
╚══════════════════════════════════════════════════════════════════╝
|
|
```
|
|
|
|
## DO NOT
|
|
|
|
- Ask for tokens in chat (security risk)
|
|
- Skip venv creation for MCP servers
|
|
- Create .env without checking .gitignore
|
|
- Proceed if API validation fails
|