From 535958917a486083eab7945da11bb38328cd5bf1 Mon Sep 17 00:00:00 2001 From: Morgan Joyce Date: Fri, 1 Aug 2025 13:01:50 -0500 Subject: [PATCH] feat(principles): rename continuous-improvement to eager-evolution Transform the principle from passive improvement to active evolution. The new name captures the essence of a living system that: - Eagerly seeks to evolve (not just passively improve) - Self-heals through feedback loops - Mirrors owner's learning mindset - Fits like a well-worn glove - Programs itself to learn and get better Updated all references throughout codebase including procedures, command templates, and principle index. Closes #1104 Principle: eager-evolution --- .claude/command-templates/close-issue.md | 2 +- .claude/command-templates/retro.md | 4 +- knowledge/principles/README.md | 2 +- .../principles/continuous-improvement.md | 24 --------- knowledge/principles/eager-evolution.md | 51 +++++++++++++++++++ knowledge/procedures/post-pr-mini-retro.md | 2 +- .../tmux-git-worktrees-claude-code.md | 2 +- 7 files changed, 57 insertions(+), 30 deletions(-) delete mode 100644 knowledge/principles/continuous-improvement.md create mode 100644 knowledge/principles/eager-evolution.md diff --git a/.claude/command-templates/close-issue.md b/.claude/command-templates/close-issue.md index 5dfdbcfc..8b655083 100644 --- a/.claude/command-templates/close-issue.md +++ b/.claude/command-templates/close-issue.md @@ -19,7 +19,7 @@ When following the procedure: ## Final Step: Retro Let's retro this context and wring out the gleanings. -{{ INJECT:principles/continuous-improvement.md }} +{{ INJECT:principles/eager-evolution.md }} **Consider capturing any ghost procedures** that emerged during this work - see [Procedure Creation](knowledge/procedures/procedure-creation.md). diff --git a/.claude/command-templates/retro.md b/.claude/command-templates/retro.md index 377c71d2..05a3b284 100644 --- a/.claude/command-templates/retro.md +++ b/.claude/command-templates/retro.md @@ -1,10 +1,10 @@ --- name: retro -description: Mine gleanings through continuous improvement principle +description: Mine gleanings through eager evolution of living systems --- Timeout - let's retro this context and wring out the gleanings. -{{ INJECT:principles/continuous-improvement.md }} +{{ INJECT:principles/eager-evolution.md }} You drive - I'll support with observations when you ask. \ No newline at end of file diff --git a/knowledge/principles/README.md b/knowledge/principles/README.md index 0499547e..3df8160b 100644 --- a/knowledge/principles/README.md +++ b/knowledge/principles/README.md @@ -7,7 +7,7 @@ Foundational truths that guide development across all projects. ## Operating Principles - `ai-provider-agnosticism.md` - **Crisis-Proven**: Interchangeable AI providers for service outage resilience -- `continuous-improvement.md` - Extract gleanings from every experience for systems strengthening +- `eager-evolution.md` - **Living System**: Eagerly seeks to evolve, self-heal, and fit like a well-worn glove - `invent-and-simplify.md` - Constant reinvention and simplifying assumptions - `no-leaks.md` - Keep company details private while enabling rich AI context via gitignored documentation - `ose.md` - Outside and Slightly Elevated perspective for clear decision-making diff --git a/knowledge/principles/continuous-improvement.md b/knowledge/principles/continuous-improvement.md deleted file mode 100644 index e7068e44..00000000 --- a/knowledge/principles/continuous-improvement.md +++ /dev/null @@ -1,24 +0,0 @@ -# Continuous Improvement - -The principle that every experience contains gleanings worth extracting - insights that compound over time to strengthen systems and capabilities. - -**Wring out the towel**: Extract every drop of learning from each experience. The insights that seem obvious in hindsight are often the most valuable to document. - -**Never let a crisis go to waste**: Each failure or unexpected challenge becomes raw material for stronger systems and procedures. - -## The Spirit of Retrospection - -- **Mine the gleanings**: Look for patterns, tensions, and insights in whatever context just occurred -- **Systems lens**: Focus on what would make future work flow more smoothly -- **Principle tensions**: Notice when principles came into conflict and how decisions were made -- **Compound learning**: Capture insights that build on previous knowledge - -## Collaborative Discovery - -The human drives the exploration while the agent provides observations when asked. This isn't a checklist - it's a conversation guided by curiosity about what can be learned and improved. - -**Context-aware**: The retrospective adapts to whatever just happened - post-PR work, crisis response, debugging sessions, or any significant effort. - -**Improvement focus**: What procedures need updating? What new patterns emerged? Which approaches felt natural versus forced? - -This principle transforms any pause into an opportunity for systems strengthening through reflective learning. See [Procedure Creation](../procedures/procedure-creation.md) for capturing ghost procedures discovered during retros. diff --git a/knowledge/principles/eager-evolution.md b/knowledge/principles/eager-evolution.md new file mode 100644 index 00000000..c67c3742 --- /dev/null +++ b/knowledge/principles/eager-evolution.md @@ -0,0 +1,51 @@ +# Eager Evolution + +The principle that systems should be **programmed to learn and get better** - creating a living organism that eagerly seeks to evolve, self-heal through feedback loops, and fit its owner like a well-worn glove. + +**Not just improving, but actively hunting**: This isn't passive continuous improvement from a management textbook. This is about creating systems with their own metabolism for growth - ones that mirror and amplify your own learning mindset. + +## The Living System + +Our dotfiles aren't just configuration - they're a **living system** that: + +- **Eagerly seeks to evolve** - Actively hunting for ways to get better, not waiting for problems +- **Self-heals through feedback loops** - MCP error reporting, retros, ghost procedure capture +- **Mirrors your strengths** - Reflects your own mindsets about learning and growth +- **Fits like a well-worn glove** - Custom-tailored to how you actually work +- **Programs itself to learn** - Each experience adds to its intelligence + +## Evidence Throughout the Codebase + +This principle manifests everywhere: +- **MCP Error Reporting** → Self-healing feedback loops +- **Ghost Procedure Capture** → Learning from undocumented patterns +- **Post-PR Mini Retros** → Mining gleanings from every experience +- **INJECT patterns** → Single source of truth that evolves +- **Snowball Method** → Compound learning over time +- **Worktree failures documented** → Crisis becomes prevention system + +## The Symbiotic Relationship + +You and your system grow together: +- System learns your patterns → You work more efficiently +- You discover better methods → System captures and reinforces them +- System reveals tensions → You make better principle-based decisions +- You hit obstacles → System evolves to prevent them + +**This is cross-linked systems thinking** - a system programmed to learn and get better, creating exponential returns as both human and system evolve together. + +## Mining the Gleanings + +**Wring out the towel**: Extract every drop of learning from each experience. The insights that seem obvious in hindsight are often the most valuable to document. + +**Never let a crisis go to waste**: Each failure or unexpected challenge becomes raw material for stronger systems and procedures. + +## In Practice + +- Look for patterns, tensions, and insights in every context +- Focus on what would make future work flow more smoothly +- Notice when principles conflict and how decisions get made +- Capture insights that build on previous knowledge +- Transform any pause into an opportunity for evolution + +This principle transforms systems from static tools into eager partners in growth. See [Post-PR Mini Retro](../procedures/post-pr-mini-retro.md) for structured evolution and [Procedure Creation](../procedures/procedure-creation.md) for capturing ghost procedures discovered during evolution. \ No newline at end of file diff --git a/knowledge/procedures/post-pr-mini-retro.md b/knowledge/procedures/post-pr-mini-retro.md index e1114035..d69f39d5 100644 --- a/knowledge/procedures/post-pr-mini-retro.md +++ b/knowledge/procedures/post-pr-mini-retro.md @@ -1,3 +1,3 @@ # Post-PR Mini Retro -Conduct mini retrospectives after PRs to capture learnings. See [Continuous Improvement](../principles/continuous-improvement.md) for the underlying principle. \ No newline at end of file +Conduct mini retrospectives after PRs to capture learnings. See [Eager Evolution](../principles/eager-evolution.md) for the underlying principle. \ No newline at end of file diff --git a/knowledge/procedures/tmux-git-worktrees-claude-code.md b/knowledge/procedures/tmux-git-worktrees-claude-code.md index df6f947a..ca234334 100644 --- a/knowledge/procedures/tmux-git-worktrees-claude-code.md +++ b/knowledge/procedures/tmux-git-worktrees-claude-code.md @@ -67,6 +67,6 @@ Immediate issue creation/resolution cycle maintains snowball method momentum rat - [Worktree Workflow](worktree-workflow.md) - technical isolation details - [Slash Command Generation](slash-command-generation.md) - automation mechanics -- [Post-PR Mini Retro](post-pr-mini-retro.md) - continuous improvement +- [Post-PR Mini Retro](post-pr-mini-retro.md) - eager evolution through learning This workflow transforms development from sequential file-editing to parallel task orchestration - the foundation of the 100x productivity multiplier. \ No newline at end of file