Superdisco MoAI Sync Skill

Purpose

Manage MoAI-ADK fork (superdisco-agents/moai-adk) with automatic customization tracking and upstream synchronization.

Project Structure

/Users/rdmtv/Documents/claydev-local/projects-v2/moai-ir-deck/
├── .claude/                    # Claude Code configuration
│   ├── agents/moai/           # Custom & modified agents
│   ├── skills/                # Skills including this one
│   │   └── superdisco-moai-sync/  # THIS SKILL
│   └── commands/moai/         # Commands
├── .moai/                     # MoAI configuration
│   ├── config/config.json     # Project config (version here)
│   ├── customizations/        # MANIFEST & changelog
│   └── scripts/               # Utility scripts
├── moai-adk/                  # Local MoAI-ADK repository
│   └── src/moai_adk/templates/  # Template source
├── CLAUDE.md                  # Alfred execution directives
└── CLAUDE.local.md            # Local-only configuration

Git Workflow

┌─────────────────────────────────────────────────────────────┐
│              SUPERDISCO FORK WORKFLOW                       │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  [upstream: modu-ai/moai-adk]                              │
│         │                                                   │
│         │ git fetch upstream                               │
│         ▼                                                   │
│  [Local moai-adk/]  ◄────── git merge (selective)          │
│         │                                                   │
│         │ git push origin                                  │
│         ▼                                                   │
│  [origin: superdisco-agents/moai-adk]                      │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Protected Files (Never Overwrite)

These files are tracked as customizations and protected during upstream sync:

Custom Agents (superdisco prefix)

• src/moai_adk/templates/.claude/agents/moai/builder-workflow-designer.md (NEW)
• src/moai_adk/templates/.claude/agents/moai/builder-reverse-engineer.md (NEW)

Modified Agents (TOON v4.0 integration)

• src/moai_adk/templates/.claude/agents/moai/builder-workflow.md
• src/moai_adk/templates/.claude/agents/moai/builder-agent.md
• src/moai_adk/templates/.claude/agents/moai/builder-command.md
• src/moai_adk/templates/.claude/agents/moai/builder-skill.md

Custom Skills

• src/moai_adk/templates/.claude/skills/moai-library-toon/
• .claude/skills/superdisco-moai-sync/ (this skill)

Local-Only Files

• CLAUDE.local.md
• .moai/config/config.json
• .claude/commands/moai/99-release.md

Commands

Check Version Status

uv run .claude/skills/superdisco-moai-sync/scripts/check_version.py

Check Agent & Skill Colors

uv run .claude/skills/superdisco-moai-sync/scripts/check_agents.py          # Human-readable table
uv run .claude/skills/superdisco-moai-sync/scripts/check_agents.py --json   # JSON output
uv run .claude/skills/superdisco-moai-sync/scripts/check_agents.py --verbose # Detailed output

Track Customizations

uv run .claude/skills/superdisco-moai-sync/scripts/track_changes.py

Sync Upstream

uv run .claude/skills/superdisco-moai-sync/scripts/sync_upstream.py --preview
uv run .claude/skills/superdisco-moai-sync/scripts/sync_upstream.py --apply

Push to Fork

uv run .claude/skills/superdisco-moai-sync/scripts/push_fork.py --message "feat: description"

Add Color Properties

# Preview changes without applying
uv run .claude/skills/superdisco-moai-sync/scripts/add_colors.py --dry-run

# Apply color updates
uv run .claude/skills/superdisco-moai-sync/scripts/add_colors.py --apply

# Process only agents or skills
uv run .claude/skills/superdisco-moai-sync/scripts/add_colors.py --agents
uv run .claude/skills/superdisco-moai-sync/scripts/add_colors.py --skills

Color Scheme:

• Red: Official MoAI (expert-, manager-, mcp-, ai-, builder-agent/skill/command, moai-*)
• Yellow: Custom Superdisco (builder-workflow-designer, builder-workflow, builder-reverse-engineer, superdisco-*)
• Blue: Claude Code default

Validate Color Consistency (Planned)

# Meta checker to validate all agents have correct colors
uv run .claude/skills/superdisco-moai-sync/scripts/check_agents.py

Modules

• modules/customization-tracker.md - Track all customizations
• modules/upstream-sync.md - Sync with modu-ai/moai-adk
• modules/fork-workflow.md - Git fork operations
• modules/conflict-resolver.md - Handle merge conflicts

Integration with Agents

This skill is auto-loaded by:

• manager-git - For Git operations
• builder-* - For customization tracking

Version History