manifold-suggest

name	manifold-suggest
description	Analyze current tasks and suggest parallelization opportunities. Examines task descriptions for file overlap and dependency patterns to recommend safe parallel execution groups. Use when planning multi-task work.

/manifold-suggest

Purpose

Satisfies: RT-4 (Codex hooks via skills), TN1 (skills-as-hooks pattern)

This skill provides auto-suggestion equivalent to Claude Code's auto-suggester hook. Since Codex CLI does not have lifecycle hooks, this skill packages the same functionality as an on-demand capability.

When to Use

• When you have 2+ tasks that might be parallelizable
• Before executing a multi-task plan from /manifold:m4-generate
• When planning implementation of multiple artifacts

Instructions

When the user invokes this skill with a list of tasks (or you detect multiple tasks in the current plan):

1. Parse task descriptions to identify:

   • Which files each task is likely to modify
   • Dependencies between tasks (e.g., "implement auth" must precede "add auth tests")
   • Estimated scope (single file, module, cross-cutting)

2. Detect file overlap between tasks:

   • Tasks modifying the same files CANNOT run in parallel
   • Tasks in different directories are usually safe to parallelize
   • Test files can often run in parallel with implementation

3. Form safe parallel groups:

   • Group tasks that have NO file overlap
   • Identify sequential dependencies that must be preserved
   • Calculate estimated speedup

4. Output a suggestion in this format:

## Parallelization Analysis

### Safe Parallel Groups
- **Group 1**: Task A, Task B (no file overlap)
- **Group 2**: Task C, Task D (independent modules)

### Sequential (must be ordered)
- Task E → Task F (dependency: E creates files F needs)

### Recommendation
<Parallelize / Sequential / Mixed> — Estimated speedup: <n>x

### Warnings
- <any overlap concerns or low-confidence predictions>

Decision Criteria

Condition	Recommendation
2+ tasks, no overlap	Parallelize
Some overlap, safe groups exist	Mixed (parallel groups + sequential)
All tasks overlap	Sequential
Single task	N/A

If the user hasn't specified tasks, check for a .manifold/ directory and look at the current phase to suggest what tasks might be parallelizable in the next phase.