Skip to content

Add collab_scratch/ as a git-ignored handoff space - #24

Merged
davecoulter merged 1 commit into
mainfrom
chore/collab-scratch
Jul 21, 2026
Merged

davecoulter merged 1 commit into
mainfrom
chore/collab-scratch

Conversation

@davecoulter

Copy link
Copy Markdown
Owner

Summary

  • Added collab_scratch/ — a persistent, repo-visible scratch directory for handoff artifacts between the user and Claude (drafts, demo pages, one-off files), as an alternative to Claude's ephemeral session-only temp directory, which is hard to find/reopen and doesn't survive between sessions.
  • Uses a .gitignore inside the folder itself (* / !.gitignore / !README.md) rather than a bare .gitkeep — this both keeps the directory tracked and actively prevents anything dropped into it from ever being staged, which a .gitkeep alone would not do.
  • Added a one-line CLAUDE.md Directory Reference so a future session (no memory of this conversation) knows the convention exists and when to prefer it.

CLI Verification

  • Branch confirmed: chore/collab-scratch
  • Sphinx build passed (local, -W, zero warnings)
  • Verified the ignore behavior directly: staged .gitignore/README.md, then dropped a test file into collab_scratch/ — confirmed it never appeared in git status
  • find . -name ".gitkeep" — confirmed no stray .gitkeep files anywhere in the repo, consistent with going all-in on the .gitignore approach
  • N/A test suite — no code touched
  • N/A docs/diagrams/infrastructure_topology.md — no service/infra changes

Application QA

N/A — no runtime behavior changed; this is a local git/workflow convention only.

🤖 Generated with Claude Code

Gives us a persistent, discoverable place to hand off drafts and
one-off files (e.g. demo pages) between sessions, instead of an
ephemeral scratch directory outside the repo the user can't easily
find or reopen. Nothing inside is version-controlled except the
.gitignore and README explaining the convention.
@github-actions

Copy link
Copy Markdown

Test Results

117 tests  ±0   117 ✅ ±0   6s ⏱️ -1s
  1 suites ±0     0 💤 ±0 
  1 files   ±0     0 ❌ ±0 

Results for commit 7bcfd0c. ± Comparison against base commit eb2963b.

@davecoulter
davecoulter merged commit 7377627 into main Jul 21, 2026
3 checks passed
@davecoulter
davecoulter deleted the chore/collab-scratch branch July 21, 2026 02:46
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