Skip to content

chore: ignore and remove throwaway scratch files - #1439

Merged
wbxl2000 merged 1 commit into
mainfrom
chore/guard-scratch-files
Jul 6, 2026
Merged

chore: ignore and remove throwaway scratch files#1439
wbxl2000 merged 1 commit into
mainfrom
chore/guard-scratch-files

Conversation

@wbxl2000

@wbxl2000 wbxl2000 commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

Related Issue

No linked issue. This is recurring repo hygiene — see the problem below.

Problem

Scratch / exploratory files keep getting committed by accident and then have to be deleted in a follow-up. Concretely, this PR removes the most recent offenders that were already tracked:

  • Agent working notes / handoff docs: HANDOVER-kimi-web-table-width.md
  • One-off UI prototype / design-mockup HTML: composer-toolbar-designs.html (repo root) and apps/kimi-web/design/{queue-composer-mockup,sidebar-show-more-demo,undo-exit-demos}.html

None of these belong in the source tree, but there was no rule or ignore pattern to stop them from being staged.

What changed

  • Delete the 5 already-tracked throwaway files listed above.
  • .gitignore: ignore common scratch-file patterns by class so they cannot be staged again:
    • Handoff / working notes: HANDOVER*.md, HANDOFF*.md, handoff.md, handover.md
    • Throwaway prototypes / mockups / demos: *-designs.html, *-design.html, *-mockup.html, *-demo.html, *-demos.html
    • A dedicated scratch directory for exploratory work: .tmp/
  • AGENTS.md: document the rule so agents can catch this proactively — never stage handoff notes or throwaway HTML prototypes, run git status + git diff --staged --stat before committing, and keep scratch work under .tmp/.

Verified with git check-ignore: the new patterns match the scratch files (e.g. *-designs.html, HANDOVER-*.md, .tmp/*) and do not match legitimate files such as the Vite index.html entrypoints or packages/agent-core/.../handoff.ts.

No publishable package is affected, so this PR needs no changeset.

Checklist

  • I have read the CONTRIBUTING document.
  • I have linked a related issue, or explained the problem above.
  • I have added tests that prove my feature works. (N/A — repo hygiene / ignore rules.)
  • Ran gen-changesets skill, or this PR needs no changeset. (No publishable package affected.)
  • Ran gen-docs skill, or this PR needs no doc update. (Only internal AGENTS.md guidance changed; no user-facing docs.)

Agent working notes (HANDOVER/handoff) and one-off UI prototype HTML files were committed by mistake. Remove the already-tracked ones, add .gitignore patterns for these classes of files and a .tmp/ scratch dir, and document the rule plus a pre-commit self-check in AGENTS.md so future mistakes are caught mechanically.

No publishable package is affected, so this PR needs no changeset.
@changeset-bot

changeset-bot Bot commented Jul 6, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 94d039a

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@wbxl2000
wbxl2000 merged commit 0824e7b into main Jul 6, 2026
10 checks passed
@wbxl2000
wbxl2000 deleted the chore/guard-scratch-files branch July 6, 2026 14:12
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