domains / families / software-engineering / understand-project-yylo

understand-project-yylo

authentic

Inspect the current product architecture, dependencies, and validation

When to use

• Before planning or implementing a requested change, when you need current architecture, dependencies, and validation loops.
• To hand grounded findings to `plan-ledger-tasks-yylo` (planning) or a task worktree (implementation).

When not to use

• Read-only: reports current behavior, sources of truth, affected components, risks, unknowns, and the smallest validation loop - does not implement.
• Bounded investigation only; do not materialize controller-private metadata in a product worktree.
• Durable specs are captured as immutable Artifact Records only when the installed `yy ledger artifact` API supports it; otherwise stop with the external draft intact.

Skill page

Source