This example shows the shape of a FactoryOS run without requiring application code.
The dry run is intentionally documentation-first. It should create or update planning artifacts before any product implementation begins.
/factory "Add media catalog search with WCAG metadata"
- Create feature slug:
media-catalog-search. - Create or update
.specs/media-catalog-search/spec.md. - Create or update
.specs/media-catalog-search/plan.md. - Create or update
.specs/media-catalog-search/tasks.md. - Create or update
.specs/media-catalog-search/validation.md. - Create or update
.tasks/YYYY-MM-DD-media-catalog-search-TASKS.md. - Pick the first unblocked P0 task.
- Execute only that bounded task.
- Run QA if code changed.
- Record verification and progress.
- Stop at the approval gate.
Factory Run
Intent:
Add media catalog search with WCAG metadata.
Feature:
media-catalog-search
Created/Updated:
- .specs/media-catalog-search/spec.md
- .specs/media-catalog-search/plan.md
- .specs/media-catalog-search/tasks.md
- .specs/media-catalog-search/validation.md
- .tasks/YYYY-MM-DD-media-catalog-search-TASKS.md
Executed:
MCAT-001 - Map current ownership and data sources.
Verification:
No product code changed. Mapping complete.
Next:
MCAT-002 - Implement the first approved bounded slice.
Approval Gate:
Human review required before implementation.
- The exact task IDs should match the generated task tracker.
- The command should not claim tests passed unless tests ran.
- If the adopted project has no runnable package commands yet, record that clearly.
- Stop at the approval gate before creating implementation code.