docs(project-context): update stale "pitfall line" wording to "pitfall" (#2710)

Aligns the how-to and theory docs with the skill terminology change
from #2709.
This commit is contained in:
Alex Verkhovsky
2026-08-10 15:36:26 -07:00
committed by GitHub
parent 15f5375644
commit 890fcda760
2 changed files with 2 additions and 2 deletions
+1 -1
View File
@@ -73,7 +73,7 @@ The result is small by design. When the evidence supports ten lines, ten lines i
There is one rule that inverts the pruning instinct, and getting it wrong quietly destroys the best content in the file.
**A policy or pitfall line retires only when the thing it guards is gone** — removed, or now mechanically enforced — **or when a human retires it.** Absence of recent failures is never grounds. A working rule erases its own evidence, and much of the value of the block is the failures that no longer happen.
**A policy or pitfall retires only when the thing it guards is gone** — removed, or now mechanically enforced — **or when a human retires it.** Absence of recent failures is never grounds. A working rule erases its own evidence, and much of the value of the block is the failures that no longer happen.
## Two altitudes, two artifacts
+1 -1
View File
@@ -55,7 +55,7 @@ At the end it tells you what went in, what was left out and why, and the reasoni
## Keeping it healthy
- **Refresh** after real change — re-checks that the caveats still hold, diffs deletions and renames since the recorded commit, updates what moved, and never re-asks what you already settled
- **Record** the moment an agent gets something wrong — that's the only admissible source for a pitfall line
- **Record** the moment an agent gets something wrong — that's the only admissible source for a pitfall
- **Audit** on demand — re-verifies everything and prunes; the block ends smaller or equal, never larger
A rule stays until the thing it guards is gone or you retire it. Nothing broke lately is never a reason to delete one — a working rule erases its own evidence.