Skip to content

chore(gitignore): declare intent to track .devflow/conventions.md - #325

Merged
dean0x merged 1 commit into
mainfrom
chore/gitignore-conventions-negation
Aug 26, 2026
Merged

chore(gitignore): declare intent to track .devflow/conventions.md#325
dean0x merged 1 commit into
mainfrom
chore/gitignore-conventions-negation

Conversation

@dean0x

@dean0x dean0x commented Aug 26, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a negation entry for .devflow/conventions.md to .gitignore, declaring the intent that this file should eventually be version-controlled.

What this line does: Records that .devflow/conventions.md is a candidate for tracking.

What this line does NOT do: It is currently inert. Git does not descend into an ignored parent directory to evaluate file-level negations — so !.devflow/conventions.md has no practical effect until the parent .devflow/ directory is also un-ignored. The file also does not yet exist on disk.

Why the parent is left ignored (PF-025): A prior incident (!dir/sub/ negation under an ignored parent) un-ignored the entire .devflow/docs/ subtree, exposing ~66 paths carrying local filesystem paths and personal email addresses in a public repository. Un-ignoring the parent directory is deliberately out of scope here and must be a separate, carefully reviewed change.

Why commit it now: This clears the working tree ahead of the v0.4.0 release pre-flight, which requires a clean tree. Leaving the modification uncommitted would block the pre-flight.

Changes

  • .gitignore: one line added — !.devflow/conventions.md

Breaking Changes

None.

Testing

  • git diff --stat main..HEAD confirms exactly 1 file changed, 1 insertion.
  • Pre/post untracked count: 1 → 0 (no untracked files were exposed — the PF-025 detection signal).
  • node scripts/verify-no-control-bytes.mjs passes (531 files, 0 violations).

Related Issues

None (working-tree hygiene ahead of release pre-flight).

Add a negation entry for .devflow/conventions.md to record that this
file should eventually be version-controlled when the surrounding
infrastructure is in place.

Currently inert for two reasons:
1. .devflow/conventions.md does not exist on disk yet.
2. Git does not descend into an ignored parent directory, so a
   file-level negation inside .devflow/ has no effect until the
   parent directory is also un-ignored.

The parent directory is deliberately left ignored (see PF-025: a
!dir/sub/ negation under an ignored parent previously exposed ~66
.devflow/docs/ paths carrying local filesystem paths and personal
email addresses in the public repository). Un-ignoring the parent
is out of scope here.

This commit clears the working tree ahead of the v0.4.0 release
pre-flight, which requires a clean tree.

Co-Authored-By: Claude <noreply@anthropic.com>
@dean0x
dean0x merged commit 6d41777 into main Aug 26, 2026
22 checks passed
@dean0x
dean0x deleted the chore/gitignore-conventions-negation branch August 26, 2026 19:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant