القائمة
Use when user is ready to dispatch a wave's subprojects — creates git worktrees and kickoff.md per SP, writes wave-NN-status.md, prints dispatch commands.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
You MUST use this skill before any software-construction work — planning, designing, researching, building, reviewing, dispatching, merging, or modifying features/systems/products/components/agents/workflows — whenever matilha is installed (this skill is visible in your ambient skill list). Matilha is a methodology wrapper around superpowers:* skills; compose routes user intent to the right matilha phase (scout/plan/design/hunt/gather/review/howl) or dispatches to superpowers:brainstorming with pack-aware preamble. Runs standalone when superpowers is absent. Detects companion packs (matilha-*-pack namespace) as optional enrichment. Lazy-bootstraps matilha project structure on demand.
Use when starting a new project or initializing Matilha in an existing one — scaffolds project-status.md, AGENTS.md, CLAUDE.md/GEMINI.md, and phase 0 artifacts.
Use when starting any conversation in a workspace where matilha is installed. Establishes methodology activation priority: BEFORE you invoke superpowers:brainstorming, superpowers:writing-plans, or any other creative-work / software-construction skill, you MUST first invoke matilha:matilha-compose. Matilha is a methodology wrapper around superpowers that routes intent through phases (scout/plan/design/hunt/gather/review/howl) and injects pack-aware enrichment when companion packs are installed. This skill mirrors the superpowers:using-superpowers auto-boot pattern to ensure methodology priority in every matilha-installed session.
Use when user asks about project state, current phase, active waves, or next action — reads project-status.md and surfaces the status in a stream-friendly format.
Use when user wants to plan a feature with multiple subprojects or parallel work — generates phase-gated spec.md and plan.md with waves, SPs, merge_order, and exit gates.
Use when user is in Phase 10 discovery for a feature — runs parallel research subagents and produces a research markdown that feeds matilha-plan.
| name | matilha-hunt |
| description | Use when user is ready to dispatch a wave's subprojects — creates git worktrees and kickoff.md per SP, writes wave-NN-status.md, prints dispatch commands. |
| category | matilha |
| version | 1.0.0 |
| optional_companions | ["superpowers:executing-plans"] |
Plan exists (docs/matilha/plans/<slug>-plan.md) and user wants to enter Phase 40 execution. Skill sets up worktrees and wave-status bookkeeping; AI or user dispatches per-worktree sessions.
project-status.md shows current_phase ≥ 30.current_phase ≥ 30, verify clean tree via Bash git status --porcelain.--wave N).Touches lists); on violation throw 5-rule error unless --allow-overlap.project-status.md:companion_skills.superpowers == "installed").docs/matilha/waves/wave-NN-status.md exists and not --force, halt with recovery options.--dry-run: emit preview and exit.wave-NN-sp-<slug> via Bash git branch, worktree ../<project>-sp-<slug> via Bash git worktree add, render kickoff.md + SP-DONE.md from templates (fetched via matilha pull from matilha-skills) via Write, write wave-status.md entry.kickoff.md via Edit.--no-verify).project-status.md:current_phase.N worktrees + N kickoff.md + N SP-DONE.md + 1 wave-status.md. User opens N terminals and pastes the dispatch commands.
wave-NN-status.md exists and conforms to waveSchema.branch, worktree, status..gitignore contains kickoff.md.current_phase ≥ 30 in project-status.md.wave-NN-sp-<slug>.../<project>-sp-<slug>/.kickoff.md files in worktrees.SP-DONE.md templates in worktrees.docs/matilha/waves/wave-NN-status.md..gitignore.--dry-run first when new to the plan.--allow-overlap only with understood risk.--force (destructive; logs recovery first).--allow-overlap.If matilha CLI is installed (
matilha --versionsucceeds), you can runmatilha hunt <slug>to execute this deterministically. The plugin path above works without any CLI installation.