Skip to content

Commit 04c68a8

Browse files
noelsaw1claude
andcommitted
docs: add MEMORY.md with lessons learned from 4X4.md
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 8d7cc04 commit 04c68a8

1 file changed

Lines changed: 35 additions & 0 deletions

File tree

MEMORY.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
## Lessons Learned (from 4X4.md, 2026-04-05)
2+
3+
### No [Unreleased] section in CHANGELOG
4+
**Type:** feedback
5+
6+
Use versioned blocks on commit instead of batching changes in an [Unreleased] bucket. At solo/small-team velocity, every commit gets a version block immediately, so the unreleased bucket just accumulated stale entries nobody reviewed.
7+
8+
**How to apply:** Always create a new `## [X.Y.Z] - YYYY-MM-DD` block. Never add `[Unreleased]`. The CHANGELOG maintainer rules in the file header enforce this.
9+
10+
---
11+
12+
### Promote experimental scripts after 4+ hardening commits
13+
**Type:** feedback
14+
15+
Scripts with 4+ consecutive hardening releases should move out of `experimental/` to reduce confusion about maturity. Leaving hardened scripts in `experimental/` signals instability that no longer exists.
16+
17+
**How to apply:** When a script in `experimental/` accumulates 4+ commits focused on fixes, edge cases, or robustness, recommend promotion to `tools/` or the appropriate mainline directory.
18+
19+
---
20+
21+
### VS Code extension value is zero-config MCP onboarding
22+
**Type:** project
23+
24+
The extension's real value is zero-config workspace onboarding (MCP server auto-discovery), not wrapping terminal commands with UI chrome. Users already have CLI and MCP tools — the extension eliminates the manual wiring step.
25+
26+
**How to apply:** Prioritize features that reduce setup friction (file watchers, config merging, provider auto-registration). Avoid duplicating functionality already available via MCP tools or CLI.
27+
28+
---
29+
30+
### Wire placeholder features immediately
31+
**Type:** feedback
32+
33+
Don't create a file and leave it disconnected. `.wpcignore` existed as a placeholder but was never wired into WPCC, leaving repo-wide scans broken by false positives. Placeholder files create a false sense of completeness.
34+
35+
**How to apply:** Wire config files, templates, or feature stubs into the consuming code in the same PR. If the integration isn't ready, document the gap in a TODO or issue instead of creating a disconnected file.

0 commit comments

Comments
 (0)