Skip to content

docs(.agent/memories): session 2026-05-27 feedback + pitfall learnings#3215

Merged
alekspetrov merged 1 commit into
mainfrom
docs/session-2026-05-27-memories
May 27, 2026
Merged

docs(.agent/memories): session 2026-05-27 feedback + pitfall learnings#3215
alekspetrov merged 1 commit into
mainfrom
docs/session-2026-05-27-memories

Conversation

@alekspetrov
Copy link
Copy Markdown
Collaborator

Summary

Four operational learnings captured during the Wave 4 reconciliation session, routed to Navigator memory per project CLAUDE.md (auto-memory deprecated for new writes).

File Type What it captures
`feedback_use_worktree_for_reconciliation` learning Use `.claude/worktrees/` for multi-branch work, not the main repo's checked-out feature branch
`feedback_no_apologies_just_working_project` learning Verify build/tests after every change; lead with technical fact, not reassurance
`feedback_check_state_before_designing` learning Run a check once before designing a recurring monitor; don't manufacture work
`pitfall_verify_branch_before_destructive_ops` pitfall `pwd` + `git status` + READ output before any `rm` / `checkout --` / branch delete

Test plan

  • Docs-only PR — no tests

Four operational learnings captured during the Wave 4 reconciliation session.
Routed to Navigator memory per project CLAUDE.md (auto-memory deprecated).

- feedback_use_worktree_for_reconciliation — don't operate from main repo's
  checked-out feature branch for multi-branch work; create a worktree
- feedback_no_apologies_just_working_project — verify build/tests after
  every change; lead with technical fact not reassurance
- feedback_check_state_before_designing — run the check once before
  designing a recurring monitor; don't make work for non-problems
- pitfall_verify_branch_before_destructive_ops — pwd + git status + READ
  output before any rm / checkout -- / branch delete in main repo
@codecov-commenter
Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@alekspetrov alekspetrov merged commit b76edf0 into main May 27, 2026
3 checks passed
@alekspetrov alekspetrov deleted the docs/session-2026-05-27-memories branch May 27, 2026 15:05
alekspetrov added a commit that referenced this pull request May 29, 2026
Captures the flow established during the 2026-05-27 Wave 4 reconciliation
session: audit before wipe, classify each file vs origin/main, work in a
fresh worktree, tar-backup before destructive ops, one PR per task, defer
new code to Pilot via GH issues.

Includes the hardened pitfall table — patterns that broke the build mid-
session and the mitigations that prevent recurrence. Cross-links the four
session feedback/pitfall memories that landed in #3215.

Expected use: any future session that walks into untracked files +
diverged branches + "what is actually shipped vs draft?" confusion.
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.

2 participants