GitLab Restructure - Quick Start Guide

Date: 2026-02-05 Status: ACTIVE MIGRATION

---

What Changed?

Three new subgroups created under blueflyio/agent-platform/:

1. agentdashboard/ - 4 projects (Dashboard components)
2. agentmarketplace/ - 4 projects (Marketplace components)
3. models/ - 4 projects (ML models)

---

Immediate Actions Required

1. Update Marketplace Remote URLs (Required)

Affected repositories (if you have them locally):

• ai_agents_marketplace
• NODE_agent-marketplace
• RECIPE_agent_marketplace

Command:

cd ~/Sites/blueflyio/_CURRENT_WORK
./update-marketplace-remotes.sh

This script will:

• Update remote URLs to new subgroup paths
• Verify connectivity
• Show summary of changes

---

2. Verify Models Repositories (Already Correct)

Check these if you have them:

cd ~/Sites/blueflyio/_CURRENT_WORK/models-agentdev
git remote get-url origin
# Should show: https://gitlab.com/blueflyio/agent-platform/models/agentdev.git

Models repos appear to already have correct URLs. No action needed.

---

3. Clone Dashboard Repos (If Needed)

Dashboard repos are NEW - clone if you need them:

cd ~/Sites/blueflyio/_CURRENT_WORK

# Clone all dashboard components
glab repo clone blueflyio/agent-platform/agentdashboard/ai_agents_dashboard
glab repo clone blueflyio/agent-platform/agentdashboard/demo_agentdash
glab repo clone blueflyio/agent-platform/agentdashboard/node-agent_dashboard
glab repo clone blueflyio/agent-platform/agentdashboard/recipe_agentdash

---

Optional: Restructure Local Workspace

This is OPTIONAL but recommended for long-term maintainability.

Benefits of Restructuring

• Matches GitLab organization (easier to understand)
• Clearer project relationships
• No naming conflicts
• Scalable for future growth

Before Restructuring

Current structure (flat):

_CURRENT_WORK/
├── agent-buildkit/
├── ai_agents_marketplace/
├── models-agentdev/
└── ... (62 repos in flat structure)

After Restructuring

New structure (hierarchical):

_CURRENT_WORK/
├── agent-platform/
│   ├── agent-buildkit/
│   ├── agent-protocol/
│   ├── agentdashboard/
│   │   ├── ai_agents_dashboard/
│   │   └── ...
│   ├── agentmarketplace/
│   │   ├── ai_agents_marketplace/
│   │   └── ...
│   └── models/
│       ├── agentdev/
│       └── ...
├── ossa/
│   └── lab/
└── root-projects/
    ├── agent-registry/
    └── ...

Run Restructure (Safely)

Step 1: Test with dry-run

cd ~/Sites/blueflyio/_CURRENT_WORK
./restructure-workspace.sh --dry-run

Review the output to see what would change.

Step 2: Run for real

./restructure-workspace.sh
# Type 'yes' when prompted

This will:

• Create automatic backup at ~/Sites/blueflyio/_BACKUP_YYYYMMDD_HHMMSS/
• Move repos to new structure
• Show summary of changes

Step 3: Verify & cleanup

# Check new structure
ls -la ~/Sites/blueflyio/_CURRENT_WORK/agent-platform/

# If everything looks good, delete backup after 7 days
rm -rf ~/Sites/blueflyio/_BACKUP_*

---

After Migration

Update Worktrees

Any existing worktrees will need to be recreated:

# Remove old worktree
/dev:cleanup-issue 845

# Create new worktree from new location
/dev:start-issue 845

Update IDE Workspace

If using VS Code, Cursor, or similar:

1. Close workspace
2. Remove old folder references
3. Add new folder references from new structure
4. Reload workspace

---

Verification Checklist

• Marketplace remote URLs updated
• Models remote URLs verified
• Dashboard repos cloned (if needed)
• Worktrees recreated from new locations
• IDE workspace updated
• Can build/test projects from new locations
• CI/CD pipelines still work

---

Troubleshooting

Problem: Script says "repository not found"

• Solution: You don't have that repo locally. Skip it or clone from GitLab.

Problem: "Remote URL already correct"

• Solution: No action needed. Already pointing to right location.

Problem: "Permission denied"

• Solution: Make script executable: chmod +x *.sh

Problem: Worktree path errors

• Solution: Remove old worktrees first: /dev:cleanup-issue {issue-number}

---

Getting Help

Full documentation: See gitlab-organization-restructure-analysis.md (37KB)

Questions?

• Check GitLab structure: https://gitlab.com/blueflyio/agent-platform
• Review full analysis document
• Contact team lead

---

Quick Reference

New Subgroup URLs

Migration Files

• update-marketplace-remotes.sh - Update remote URLs (REQUIRED)
• restructure-workspace.sh - Restructure local workspace (OPTIONAL)
• gitlab-organization-restructure-analysis.md - Full documentation (37KB)
• RESTRUCTURE-QUICK-START.md - This file

---

Last Updated: 2026-02-05 Status: Ready for execution