Skip to content

[chore] Organize work-tmp with per-feature subdirectories for agent output#14157

Draft
sfc-gh-lwilby wants to merge 1 commit intodevelopfrom
chore/organize-work-tmp-features
Draft

[chore] Organize work-tmp with per-feature subdirectories for agent output#14157
sfc-gh-lwilby wants to merge 1 commit intodevelopfrom
chore/organize-work-tmp-features

Conversation

@sfc-gh-lwilby
Copy link
Copy Markdown
Collaborator

@sfc-gh-lwilby sfc-gh-lwilby commented Mar 1, 2026

Describe your changes

Introduces a work-tmp/features/<feature-name>/ convention for organizing per-feature working files instead of dumping everything flat into work-tmp/.

Right now work-tmp/ is a flat bucket mixing debug logs, implementation plans, test scripts, and throwaway scratch files. This gives feature work its own organized space with a suggested internal structure.

  • Per-feature subdirectories: work-tmp/features/<feature-name>/ with implementation-plan.md, notes.md, test-apps/
  • Claude Code plansDirectory moved to work-tmp/plans/ to separate auto-generated session plans from feature working files
  • One-off throwaway files can still go directly in work-tmp/

Working files accumulated during feature development often have a longer lifespan than truly temporary files — they're useful as context while the feature is in progress and could feed into implementation plans, tech specs, or other longer-lived documentation. This is a first step toward giving work-tmp/ more structure; further organization (e.g. separating scratch files from feature work) could follow.

Screenshot or video (only for visual changes)

N/A

GitHub Issue Link (if applicable)

N/A

Testing Plan

  • Explanation of why no additional tests are needed: documentation/configuration-only change, no behavior modifications.

Contribution License Agreement

By submitting this pull request you agree that all contributions to this project are made under the Apache 2.0 license.

Made-with: Cursor

Co-authored-by: lawilby <laura.wilby+oss@snowflake.com>
@sfc-gh-lwilby sfc-gh-lwilby added impact:internal PR changes only affect internal code change:chore PR contains maintenance or housekeeping change labels Mar 1, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 1, 2026

✅ PR preview is ready!

Name Link
📦 Wheel file https://core-previews.s3-us-west-2.amazonaws.com/pr-14157/streamlit-1.54.0-py3-none-any.whl
📦 @streamlit/component-v2-lib Download from artifacts
🕹️ Preview app pr-14157.streamlit.app (☁️ Deploy here if not accessible)

@snyk-io
Copy link
Copy Markdown
Contributor

snyk-io bot commented Mar 1, 2026

Snyk checks have passed. No issues have been found so far.

Status Scanner Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues
Licenses 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

@sfc-gh-lwilby sfc-gh-lwilby marked this pull request as ready for review March 2, 2026 06:39
@sfc-gh-lwilby sfc-gh-lwilby requested a review from a team as a code owner March 2, 2026 06:39
Copilot AI review requested due to automatic review settings March 2, 2026 06:39
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Introduces a clearer convention for organizing ephemeral development artifacts under work-tmp/, separating per-feature working materials from general throwaway files and Claude plan outputs.

Changes:

  • Document a work-tmp/features/<feature-name>/ structure for per-feature implementation plans, notes, and test apps.
  • Keep work-tmp/ available for one-off temporary files.
  • Update Claude Code configuration to write plans to work-tmp/plans/.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
AGENTS.md Adds the new work-tmp/features/<feature-name>/ convention and recommended internal structure.
.github/copilot-instructions.md Mirrors the updated work-tmp/ organization guidance for Copilot usage.
.cursor/rules/overview.mdc Mirrors the updated work-tmp/ organization guidance for Cursor rules.
.claude/settings.json Moves plansDirectory to ./work-tmp/plans to separate plan outputs from feature working files.

@sfc-gh-lwilby sfc-gh-lwilby changed the title [chore] Organize work-tmp with per-feature subdirectories [chore] Organize work-tmp with per-feature subdirectories for agent output Mar 2, 2026
@sfc-gh-lwilby sfc-gh-lwilby marked this pull request as draft March 3, 2026 22:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

change:chore PR contains maintenance or housekeeping change impact:internal PR changes only affect internal code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants