name: factory description: Supervisor that loads the global factory recipe and runs each part with the corresponding skill

Factory

Purpose

Run a global "software factory" recipe that orchestrates other skills by calling other skills and uses a shared context file.

Inputs

• The user's request (bug report, or feature request).
• Global recipe: ~/.codex/factory/recipes/default.yaml.
• Shared context file: factory/context.md (repo-relative).

Workflow

1. Ensure repo workspace

• If factory/ does not exist in the repo root, create it.
• Ensure .gitignore contains factory/. If missing, append it.

2. Initialize shared context

• Create or clear factory/context.md at the start of a run.
• Write a short header with the current date/time and a one-line summary of the request.

3. Read the global recipe

• Load ~/.codex/factory/recipes/default.yaml.
• Parse the ordered parts list.

4. Summarize the request

• Extract a short intent summary (bug vs feature vs general).
• Capture any user-provided focus (e.g. "pay particular attention to CSS").
• Append this summary to factory/context.md.

5. Run every relevant part in order

• For every recipe part that is relevant to the task, invoke the corresponding skill.
• The prompt must include:
  • The target skill invocation (e.g. $review).
  • The part's base prompt from the recipe.
  • Any request-specific emphasis from the user.
  • A reminder to append a short summary and any actionable notes to factory/context.md.

Example skill invocation:

"$review check this branch against ~/.codex/docs/style-guide.md. pay particular attention to CSS. append a concise summary and actionable notes to factory/context.md"

6. Capture and summarize results in factory/context.md

• After each skill run, summarize results in 1-3 sentences.
• If a part reports blockers, stop and ask the user how to proceed.

Output format

• Short "Recipe" line listing parts executed.
• One short summary per part result.