Skip to content

docs(agents): record dual-pi-ai lesson, shed narrative to HISTORY.md, lean pass (refs #539) - #540

Merged
apmantza merged 1 commit into
masterfrom
docs/agents-lesson-lean
Sep 15, 2026
Merged

apmantza merged 1 commit into
masterfrom
docs/agents-lesson-lean

Conversation

@apmantza

Copy link
Copy Markdown
Owner

Follow-up to #538. Consulted agents.md sections: Maintaining This File (placement, timeless wording, shed-to-HISTORY, cite-by-symbol), What is pi-free, Architecture at a Glance, Provider Categories, Recurring Defect Shapes, Testing, Release Workflow (changelog gate).

Lesson recorded: defect shape 10 (dual pi-ai copies) with the three proven don'ts (peer floor in lockstep; no devDependency; overrides can't target peers).

Lean pass (net -8 lines, dedup only — no live rules removed):

  • Merged the duplicated Native-providers paragraph and the duplicated Paid/Native category rows (pre-merge-inclusive copies).
  • Staleness fixes: peer floor line (was all->=0.81.0), vitest v4.1.10 -> v5, added missing lib/wire-signature.ts tree entry.

HISTORY.md: seeded with the #539 incident narrative per its shedding discipline (live rule stays in agents.md). Also added the missing [Unreleased] Fixed changelog entry for #538.

@sonarqubecloud

Copy link
Copy Markdown

@apmantza
apmantza merged commit 2503cf2 into master Sep 15, 2026
16 checks passed
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