Skip to content

consolidate: curate learnings, skills, and guidelines (2026-02-28) - #13

Merged
ahoym merged 14 commits into
mainfrom
consolidate/2026-02-28
Feb 28, 2026
Merged

consolidate: curate learnings, skills, and guidelines (2026-02-28)#13
ahoym merged 14 commits into
mainfrom
consolidate/2026-02-28

Conversation

@ahoym

@ahoym ahoym commented Feb 28, 2026

Copy link
Copy Markdown
Owner

Summary

Automated consolidation sweep of ~/.claude/ knowledge corpus — learnings, skills, and guidelines. Converged after 3 rounds (9 sweeps) with 4 HIGHs, 3 MEDIUMs applied, 1 MEDIUM blocked.

Key actions:

  • Deduplicated research-methodology.md (content already in skill-design.md) and parallel-planning.md (merged into parallel-plans.md)
  • Removed duplicate sections from parallel-plans.md already covered in claude-code.md
  • Folded thin xrpl-testing-patterns.md (1 pattern, 16 lines) into xrpl-patterns.md
  • Wired xrpl-typescript-fullstack persona with Detailed references to XRPL learnings
  • Fixed bare filename references in do-refactor-code/SKILL.md to use full ~/.claude/learnings/ paths
  • Fixed outdated reference path in quantum-tunnel-claudes/SKILL.md

Blocked (needs human decision):

  • guidelines/validation.md is not @-referenced in CLAUDE.md — whether to wire it as always-on is a preference call

Changes

Learnings (35 → 32 files):

  • Deleted: research-methodology.md, parallel-planning.md, xrpl-testing-patterns.md
  • Modified: parallel-plans.md (deduped sections), xrpl-patterns.md (absorbed testing patterns)
  • New: xrpl-patterns.md entries from folded file

Skills:

  • do-refactor-code/SKILL.md — fixed 2 bare filename refs → full ~/.claude/learnings/ paths
  • quantum-tunnel-claudes/SKILL.md — fixed reference path

Personas:

  • xrpl-typescript-fullstack.md — added Detailed references section (4 learnings files linked)

Consolidation output (new, metadata only):

  • consolidate-output/ — spec, progress, report, decisions, blockers, lows, compounded-learnings

Screenshots

N/A

Test plan

  • Verify no broken @-references in CLAUDE.md after merge
  • Spot-check that deleted files' content is preserved in their merge targets
  • Review blocked item in consolidate-output/blockers.md — decide on validation.md wiring

Checklist

  • No content lost — all deletes are merges into authoritative files
  • Review compounded-learnings.md for insights to persist via /learnings:compound
  • Decide on validation.md blocker

Generated with Claude Code

ahoym and others added 14 commits February 28, 2026 08:25
29 skills across 5 namespaces evaluated. Fixed ambiguous reference
path in do-refactor-code (bare filename → full ~/.claude/ path).
1 LOW recorded: orphaned subagent-patterns.md in skill-references.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
B-1: Fold validation.md (unreferenced guideline) into learnings/skill-design.md
L-1: Delete orphaned skill-references/subagent-patterns.md, remove stale reference from multi-agent-patterns.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
5 learnings compounded from consolidation loop into skill-design.md and
ralph-loop.md. Remove consolidate-output/ working files from PR diff.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Instead of deleting the orphaned reference file, wire it into the 3 skills
that launch subagents (explore-repo, do-security-audit, parallel-plan:execute).
Restores cross-reference from multi-agent-patterns.md. Removes the now-incorrect
"orphaned skill-references" learning from skill-design.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…anup rule

Extend MEDIUM auto-apply reference wiring to cover skill-reference files
(not just personas). Add tiebreaker principle: when a finding has both a
cleanup option (delete) and an opportunity option (wire/restructure),
prefer opportunity — it fixes root cause and is reversible.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Consolidation agent now persists meta-insights directly into the
learnings system during the loop instead of staging them to
compounded-learnings.md for manual post-loop compounding. Removes
compounded-learnings.md from output files — compound actions log to
decisions.md like all other actions.

Also: session-start learnings gate now uses ambient context (branch,
CWD, git status) with filename-only glob for cheaper compliance, and
two new learnings on Skill tool limitations in worktrees.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@ahoym
ahoym merged commit ffbf7c4 into main Feb 28, 2026
@ahoym
ahoym deleted the consolidate/2026-02-28 branch February 28, 2026 18:33
ahoym added a commit that referenced this pull request Mar 13, 2026
Learnings extracted from algo-trading PRs #3-#13, covering:
- Code quality: dead code removal, guard variables, dict inlining, function reuse
- Code review: exceptions vs Optional, accurate summaries, feature naming
- Python: __post_init__ for derived dataclass fields
- Git: stacked PR risks, dependency chain abandonment
- Process conventions (new file): pyproject.toml anchoring, migration scripts,
  cross-cutting refactor deferral, plan-first PRs

Also updates extract-request-learnings skill templates to strip Source/Frequency
from general learnings (learning matters, not provenance) and only show Frequency
on project learnings when value is "convention".

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
ahoym added a commit that referenced this pull request May 17, 2026
Addresses team review (#12, #13, #14) on PR #109.

- `cutoff = time.time() - args.days * 86400` (wall-clock) instead of
  anchoring to the newest log entry. `--days 7` now means "last 7 calendar
  days" rather than "7 days before last activity".
- `import argparse` and `import time` move to the top-level import block.
- All four percentage calculations use `round(100 * n / d)` instead of
  integer floor division: overall suggestion-fire rate, top-performers
  rate, and both tier hit rates. 2-of-3 now reads as 67%, not 66%.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ahoym added a commit that referenced this pull request May 18, 2026
Addresses team review (#12, #13, #14) on PR #109.

- `cutoff = time.time() - args.days * 86400` (wall-clock) instead of
  anchoring to the newest log entry. `--days 7` now means "last 7 calendar
  days" rather than "7 days before last activity".
- `import argparse` and `import time` move to the top-level import block.
- All four percentage calculations use `round(100 * n / d)` instead of
  integer floor division: overall suggestion-fire rate, top-performers
  rate, and both tier hit rates. 2-of-3 now reads as 67%, not 66%.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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