lucidlabs-hq/deploy
templates/fullstack-convex-mastra/.claude/skills/deploy/SKILL.md
Deploy invoice-accounting-assistant to HQ server. Runs tests first (TDD), then builds and deploys. Use when ready to push changes to staging/production.
$ install --global
skillsauthnpx skillsauth add lucidlabs-hq/agent-kit deployInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 9:25 PM22.3s1 file scanned
SKILL.md
- name:
- deploy
- description:
- Deploy invoice-accounting-assistant to HQ server. Runs tests first (TDD), then builds and deploys. Use when ready to push changes to staging/production.
- disable-model-invocation:
- true
- allowed-tools:
- Bash, Read, Write
- argument-hint:
- [environment]
Deploy to HQ Server
Deployment workflow with TDD integration. Tests MUST pass before deployment.
Usage
/deploy # Deploy to production (default)
/deploy staging # Deploy to staging (same as production for now)
Pre-Flight Checklist
Before deployment, verify:
- [ ] All tests pass
- [ ] TypeScript compiles without errors
- [ ] ESLint passes
- [ ] No uncommitted changes
- [ ] On main branch (or approved branch)
Step 1: Pre-Deployment Validation (TDD)
KRITISCH: Deployment wird abgebrochen wenn Tests fehlschlagen.
1.1 Run All Tests
cd frontend
# Unit Tests
pnpm run test
# Type Check
pnpm run type-check
# Lint
pnpm run lint
1.2 Check for Uncommitted Changes
git status --porcelain
If there are changes:
⚠️ Uncommitted changes detected!
Options:
1. Commit changes first: /commit
2. Stash changes: git stash
3. Abort deployment
1.3 Verify Branch
git branch --show-current
Warn if not on main:
⚠️ Not on main branch (currently on: feature/xyz)
Continue anyway? [y/N]
Step 2: Build Verification
2.1 Production Build
cd frontend
pnpm run build
If build fails:
❌ Build failed! Fix errors before deploying.
Common issues:
- TypeScript errors
- Missing dependencies
- Environment variables not set
Step 3: Deploy to HQ Server
3.1 Sync Code to Server
rsync -avz --delete \
-e "ssh -p 2222" \
--exclude='.git' \
--exclude='node_modules' \
--exclude='.next' \
--exclude='.env.local' \
./ [email protected]:/opt/lucidlabs/projects/invoice/
3.2 Build & Start on Server
ssh -p 2222 [email protected] << 'EOF'
cd /opt/lucidlabs/projects/invoice
# Build and deploy
docker compose -f docker-compose.hq.yml -p invoice up -d --build
# Wait for health check
sleep 15
# Show status
docker compose -f docker-compose.hq.yml -p invoice ps
EOF
3.3 Health Check
curl -f https://invoice.lucidlabs.de/api/health || echo "Health check failed!"
Step 4: Post-Deployment
4.1 Verify Deployment
┌─────────────────────────────────────────────────────────────────┐
│ ✅ DEPLOYMENT SUCCESSFUL │
├─────────────────────────────────────────────────────────────────┤
│ │
│ URL: https://invoice.lucidlabs.de │
│ Time: [timestamp] │
│ Branch: main │
│ Commit: [short-hash] │
│ │
│ Services: │
│ ├─ invoice-frontend ✅ Running │
│ ├─ invoice-mastra ✅ Running │
│ ├─ lucidlabs-convex ✅ Running │
│ └─ lucidlabs-portkey ✅ Running │
│ │
└─────────────────────────────────────────────────────────────────┘
4.2 Rollback (if needed)
If deployment fails:
ssh -p 2222 [email protected] << 'EOF'
cd /opt/lucidlabs/projects/invoice
# Rollback to previous version
git checkout HEAD~1
docker compose -f docker-compose.hq.yml -p invoice up -d --build
EOF
TDD Integration
This deployment skill is integrated with the TDD workflow:
┌──────────────────────────────────────────────────────────────────┐
│ DEVELOPMENT WORKFLOW │
├──────────────────────────────────────────────────────────────────┤
│ │
│ 1. Write Test (RED) │
│ └─► pnpm run test │
│ │
│ 2. Implement Feature │
│ └─► pnpm run test (GREEN) │
│ │
│ 3. Refactor │
│ └─► pnpm run test (still GREEN) │
│ │
│ 4. Commit │
│ └─► /commit │
│ │
│ 5. Deploy │
│ └─► /deploy │
│ ├─► Tests (must pass) │
│ ├─► Build (must succeed) │
│ └─► Deploy to HQ │
│ │
└──────────────────────────────────────────────────────────────────┘
Quick Commands
# Full deployment (with tests)
/deploy
# Skip tests (NOT RECOMMENDED)
# Only use in emergencies
pnpm run deploy:force
# Check deployment status
ssh -p 2222 [email protected] "docker ps | grep invoice"
# View logs
ssh -p 2222 [email protected] "docker logs invoice-frontend --tail 50"
Environment-Specific Notes
Production URLs
- Frontend: https://invoice.lucidlabs.de
- API: https://invoice.lucidlabs.de/api
- Health: https://invoice.lucidlabs.de/api/health
Server Details
- Host: 91.98.70.29
- SSH Port: 2222
- User: nightwing
- Project Path: /opt/lucidlabs/projects/invoice
Version: 1.0 Created: 29. Januar 2026
Related Skills
lucidlabs-hq/visual-verify
testing
VerifiedTrustedCommunity
Visual UI verification with agent-browser. Use after implementing UI components to take screenshots, verify interactions, and self-check your work. FASTER than E2E tests.
1SKILL.mdUpdated Apr 16, 2026
lucidlabs-hq/update-readme
documentation
VerifiedTrustedCommunity
Update README with current project status and features. Use after completing features.
1SKILL.mdUpdated Apr 16, 2026
lucidlabs-hq/.claude/skills/time-report
tools
VerifiedTrustedCommunity
--- name: time-report description: Cross-project time report. Aggregates all session data from ~/.claude-time/sessions/. Use to see how much time was spent across all projects. disable-model-invocation: true allowed-tools: Bash, Read argument-hint: [all | this-week | this-month | last-month | {project-name}] --- # Time Report: Cross-Project Session Overview ## Objective Read ALL session files from `~/.claude-time/sessions/*.json` and produce an aggregated time report. Supports filtering by pe
1SKILL.mdUpdated Apr 16, 2026
lucidlabs-hq/test
testing
VerifiedTrustedCommunity
Run tests with coverage report and gap analysis. MANDATORY before /commit and PR creation. Use after implementation or during validation.
1SKILL.mdUpdated Apr 16, 2026