docs: compress SKILL.md change logs + compact April PM runs#408
Merged
Conversation
Two cleanup items deferred from PR #406: 1. SKILL.md ## Change Log compression (28 files) - Drop "Initial version" entries (pure noise) - Keep most recent 3 substantive entries per change log - Drop entire section if only "Initial version" remained (4 sections) - ~25KB of historical narrative removed - Top trims: idea-to-pdd 14→3, ocs-chatbot-qa 11→3, connect-opp-setup 10→3, llo-launch 9→3, ocs-agent-setup 9→3 - Older entries preserved in git history; the most recent 3 entries are what an agent needs to understand current behavior. 2. .claude/pm/runs/ April logs compacted (10 files → 1 learning) - Apr 8 → Apr 29 covered 10 PM scout cycles that shaped the 0.13.x platform: archetypes-as-first-class, real-run-beats- spec-review, class-level preventers, doctor-probes-as- invariant-enforcement, operator-can-fix vs can't, stale- metadata-is-dangerous. - Distilled into docs/learnings/2026-04-pm-runs-compacted.md (cross-cycle patterns + shipped-findings table + dropped- items list). Each pattern points at the Convention/Gotcha it hardened into. - May 10 perf-lens run kept as-is (recent enough to read raw). - Originals preserved in git history. Files changed: 39 (28 SKILL.md compressions + 10 PM deletions + 1 new learning + 4 version files). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Both deferred items from PR #406, shipped together.
1. SKILL.md Change Log compression (28 files)
Per-skill
## Change Logsections were carrying 5-13 historical entries that bloat the skill's context every time it dispatches. Compressor:Initial versionentries unconditionally (pure noise)Initial versionwas there (4 such sections)The remaining 3 entries are what an agent needs to understand current behavior. Older entries are preserved in git history under each skill's blame log.
Top trims:
idea-to-pddocs-chatbot-qaconnect-opp-setupllo-launchocs-agent-setuppdd-to-deliver-apppdd-to-learn-appocs-chatbot-eval~25KB of historical narrative removed across 28 files. The other ~55 skills with change logs already had ≤3 substantive entries (no compression needed).
2.
.claude/pm/runs/April compaction (10 files → 1 learning)The April PM scout cycles documented the platform's pre-0.13 evolution: 10 lens-by-lens runs from Apr 8 → Apr 29 covering archetype-as-first-class, real-run-beats-spec-review, class-level preventers, doctor-probes-as-invariant-enforcement, operator-can-fix vs can't, and stale-metadata-is-dangerous.
Distilled into
docs/learnings/2026-04-pm-runs-compacted.mdwith:Originals preserved in git history. The May 10 perf-lens run is recent enough to keep as-is.
Test plan
clean-installstatus checkdocs/learnings/2026-04-pm-runs-compacted.mdreads coherently🤖 Generated with Claude Code