Files
PaperClipAI/.gitignore
T
DottaandPaperclip 39906096c4 chore: ignore personal agent instructions (#16970)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work.
> - Contributors use repository instructions to guide their local
agents.
> - Personal instructions can differ between contributors.
> - A root `AGENTS.local.md` file can hold these personal additions.
> - Git must keep this file out of shared commits by default.
> - This pull request adds a root ignore rule for the file.

## Linked Issues or Issue Description

**What existing behavior does this improve?**

Git ignore rules for personal agent instructions in a local checkout.

**Current behavior**

Git lists a root `AGENTS.local.md` as an untracked file. A contributor
can add it to a commit by mistake.

**Proposed behavior**

Git ignores the root `AGENTS.local.md` by default. Each contributor can
keep personal instructions in that file.

**Reason and benefit**

Personal agent settings stay local. Contributors can keep using the
shared `AGENTS.md` for repository rules.

**Breaking changes**

None. The rule applies only to an untracked file at the repository root.

No related public issues or pull requests appeared in searches for
`AGENTS.local.md`.

## What Changed

- Add `/AGENTS.local.md` to `.gitignore` under a personal agent
instructions comment.

## Verification

- `git check-ignore -v AGENTS.local.md` selects the new root ignore
rule.
- `git ls-files AGENTS.local.md` returns no tracked files.
- `git diff --name-only origin/master...HEAD` lists only `.gitignore`.
- `git diff --check origin/master...HEAD` passes.
- `pnpm -r typecheck`, `pnpm test:run`, and `pnpm build` were attempted.
All three stopped before execution because pnpm could not fetch and
verify the pinned `pnpm@9.15.4` through the network sandbox. This
checkout also has no installed dependencies. The Git checks above
passed. CI status remains separate.

## Risks

Low risk. Git will hide a root `AGENTS.local.md` from normal staging.
Existing tracked files remain tracked. The ignore rule does not make
Codex load the file; contributors must configure that separately.

## Model Used

OpenAI Codex (GPT-6), with file editing, shell execution, and GitHub
tools. The exact backend model ID and context window were not exposed in
this session.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have searched GitHub for duplicate or related PRs and linked
them above
- [x] I have either (a) linked existing issues with `Fixes: #` / `Closes
#` / `Refs #` OR (b) described the issue in-PR following the relevant
issue template
- [x] I have not referenced internal/instance-local Paperclip issues or
links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip`
URLs)
- [x] My branch name describes the change (e.g. `docs/...`, `fix/...`)
and contains no internal Paperclip ticket id or instance-derived details
- [ ] I have run tests locally and they pass
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [ ] All Paperclip CI gates are green
- [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
- [x] I will address all Greptile and reviewer comments before
requesting merge

Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-10-20 09:53:43 -05:00

102 lines
1.9 KiB
Plaintext

node_modules
node_modules/
**/node_modules
**/node_modules/
dist/
dist-preview/
dist-flow-preview/
server/ui-dist/
server/dist-runtime/
packages/paperclip-runner/runner/target/
ui/storybook-static/
ui/storybook/generated/
ui/storybook/.storybook/preview.tsx
maps/generated/
.env
*.tsbuildinfo
drizzle/meta/
.vite/
coverage/
.DS_Store
._*
.AppleDouble
.LSOverride
data/
.paperclip/
.pnpm-store/
tmp-*
cli/tmp/
# Scratch/seed scripts (but not scripts/ dir)
check-*.mjs
!.github/scripts/check-*.mjs
!.github/scripts/tests/check-*.mjs
!scripts/check-*.mjs
new-agent*.json
newcompany.json
seed-*.mjs
server/check-*.mjs
server/seed-*.mjs
packages/db/seed-*.mjs
# npm publish build artifacts
cli/package.dev.json
# Build artifacts in src directories
server/src/**/*.js
server/src/**/*.js.map
server/src/**/*.d.ts
server/src/**/*.d.ts.map
tmp/
feedback-export-*
diagnostics/
# Editor / tool temp files
*.tmp
.vscode/
.claude/settings.local.json
.paperclip-local/
.paperclip-runtime/
/.idea/
/.agents/
# Personal agent instructions
/AGENTS.local.md
# Doc maintenance cursor
.doc-review-cursor
# Playwright
tests/e2e/test-results/
tests/e2e/playwright-report/
tests/runner-e2e/results/
.env.runner-e2e.local
tests/release-smoke/test-results/
tests/release-smoke/playwright-report/
test-results/issue-detail-perf/
tests/storybook-visual/.cache/
tests/storybook-visual/.snapshots/
tests/storybook-visual/baseline-review/
tests/storybook-visual/test-results/
tests/storybook-visual/repository-skill-results/
tests/storybook-visual/playwright-report/
.superset/
.superpowers/
.claude/worktrees/
.herenow
.vercel/
.env.local
test-results/
# Retained local lifecycle behavior measurements
.lifecycle-baseline/
# Copilot assets are generated from pinned platform packages during installation.
/packages/paperclip-runner/provider-assets/
/server/provider-assets/
# Local native Runner test/session state
.paperclip-runner-prp/
# Opt-in CI timing artifacts
.ci-profile/