Software Practices

Scope JJ File Tracking

VCS-SCOPE-JJ-FILE-TRACKING

VCS JJOwnershipSource Truth
Give feedback

Summary

Pass intended paths to jj file track and jj file untrack. Scoped tracking keeps local-only, generated, or unrelated files out of publication state.

Rule

Scope jj file track and untrack commands to intended paths.

Why

jj file track and jj file untrack can affect more files than intended if paths are omitted or globbed too broadly. Path-scoping matters when local plans, generated files, or private override files should stay untracked.

Helps

  • Prevents accidental publication or removal of local-only and unrelated files.

Limits

Broad tracking is acceptable during an intentional repo import or generated-file policy change. For normal edits, name the paths.

Agent Instruction

Scope jj file track and untrack commands to intended paths because `jj file track` and `jj file
untrack` can affect more files than intended if paths are omitted or globbed too broadly.

Mechanisms

Supported by explicit paths, .git/info/exclude, global ignores, jj status, and diff review after track or untrack commands.

References