Skip to content

Commit 1c6ccfc

Browse files
committed
Keep working notes out of the repository
docs/plans/ collected fifteen analysis documents in a day. They are scaffolding for decisions, and a plan describing finished work is a stale doc waiting to happen — the same failure that had PRODUCT.md documenting behaviour the code never had. Ignored rather than curated: durable conclusions belong in the reference docs or the tracking issue. The two committed files are removed from git and left on disk.
1 parent 336cfd5 commit 1c6ccfc

4 files changed

Lines changed: 4 additions & 123 deletions

File tree

.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,3 +24,6 @@ evals/capability/results/*
2424
!evals/capability/results/baseline-0286.json
2525
local-harness-bench/
2626
subagents/
27+
28+
# Working notes and design spikes — local only, never committed
29+
docs/plans/

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,4 +90,4 @@ Interchange is the standard library for this repo, consumed as published `@intx/
9090
- `docs/PLUGINS.md` — plugin manifest system and discovery
9191
- `docs/TELEMETRY.md` — what usage telemetry is collected and why
9292
- `docs/PERFTRACE.md` — local PerfTrace and opt-in OTEL export settings
93-
- `docs/plans/` — non-normative working notes and design spikes; check before starting related work
93+
`docs/plans/` is git-ignored: local working notes and design spikes only. Durable conclusions belong in the docs above or in the tracking issue — never left as a plan file, which is a stale doc waiting to happen.

docs/plans/codex-request-parity-checklist.md

Lines changed: 0 additions & 90 deletions
This file was deleted.

docs/plans/reasoning-effort-by-role.md

Lines changed: 0 additions & 32 deletions
This file was deleted.

0 commit comments

Comments
 (0)