study

name	study
description	Analyze the current codebase using Factory's observation engine. Generates a report covering code quality, eval scores, open issues, backlog items, observability coverage, and improvement opportunities. Use when the user wants to understand the state of their project before making changes.
disable-model-invocation	true

/factory:study

Analyze the current codebase and generate an observation report.

Prerequisites

command -v factory >/dev/null 2>&1 || uv tool install "${CLAUDE_PLUGIN_ROOT}"

Execution

factory study "$(pwd)"

This produces a report at .factory/strategy/observations.md covering:

• Eval scores — current composite and per-dimension breakdown
• Open issues — from GitHub, if available
• Backlog items — pending work from .factory/strategy/backlog.md
• Observability coverage — logging density and uninstrumented files
• Hypothesis budget — how many improvements to target this cycle
• Cross-project insights — patterns from sibling projects (if any)

For cross-project insights, pass --projects-dir:

factory study "$(pwd)" --projects-dir ~/factory-projects

After studying, use /factory:implement to act on the findings.