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
Version Upstream Date Notes
1.0.0 v0.31.2 2025-12-01 Initial release