houmao-utils-workspace-mgr

Plan and execute Houmao-standard multi-agent workspace layouts with Git worktrees and submodules.

18|3|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/igamenovoer/houmao --skill houmao-utils-workspace-mgr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: houmao-utils-workspace-mgr
Source: https://github.com/igamenovoer/houmao/tree/main/src/houmao/agents/assets/system_skills/houmao-utils-workspace-mgr
Command: npx skills add https://github.com/igamenovoer/houmao --skill houmao-utils-workspace-mgr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of repeatedly setting up complex multi-agent directory structures and Git workspace mechanics correctly before launching agents.

Core Features & Use Cases

  • Plan-first workspace layout: generate a precise dry-run plan showing exactly what directories, Git worktrees, ignores, symlinks, and submodule actions would change.
  • Execute standardized workspace scaffolding: create Houmao-standard in-repo or out-of-repo workspace layouts, including per-agent branches/worktrees and shared knowledge paths.
  • Git-aware safety and integration rules: handle local-state symlink policies safely, materialize tracked submodules using controlled modes, and update launch-profile CWDs only after the workspace exists.
  • Use case: when you want to spin up a team of agents to work on a repo task, you can prepare an in-repo workspace for several launch profiles, with per-agent write surfaces and integration-ready shared-KB paths.

Quick Start

Use houmao-utils-workspace-mgr plan in-repo workspace for <launch-profiles> to generate a dry-run workspace change plan before you approve execution.

Frequently Asked Questions about houmao-utils-workspace-mgr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a multi-agent workspace with Git worktrees for different launch profiles?

To set up a multi-agent workspace, generate a dry-run plan to preview directory structures and Git worktrees, then execute the scaffolding to create per-agent branches, safe local-state symlinks, and launch-profile CWDs.

What is a dry-run workspace plan and when do I need it for multi-agent repos?

A dry-run workspace plan shows exactly what directories, Git worktrees, ignores, and submodule actions will change before execution. You need it to inspect and approve structural changes before launching multiple agent processes across repos.

Does this workspace automation tool handle tracked submodule materialization safely?

Yes, this workspace automation tool handles tracked submodule materialization using controlled modes, ensuring safe integration rules and local-state symlink policies are applied when preparing in-repo or out-of-repo layouts.

Can I prepare an out-of-repo workspace layout for multiple agent profiles?

Yes, you can prepare standardized out-of-repo workspace layouts for multiple agent profiles, creating per-agent write surfaces and integration-ready shared knowledge paths while maintaining safe Git worktree mechanics.

What's the best way to update launch-profile CWDs after creating workspace structures?

The best way to update launch-profile CWDs is to execute the workspace scaffolding first, ensuring the directory structure exists, then applying the CWD updates automatically as a final step to prevent path resolution errors.