feat: add opt-in knowledge management integration (ADR + DISCOVERIES)

.claude-plugin/marketplace.json

@@ -1,9 +1,9 @@
 {
-  "name": "superpowers-dev",
-  "description": "Development marketplace for Superpowers core skills library",
+  "name": "jthurlburt-claude-plugins",
+  "description": "Custom plugins for Claude Code",
   "owner": {
-    "name": "Jesse Vincent",
-    "email": "[email protected]"
+    "name": "Jacob Hurlburt",
+    "email": "[email protected]"
   },
   "plugins": [
     {
@@ -12,9 +12,9 @@
       "version": "3.2.2",
       "source": "./",
       "author": {
-        "name": "Jesse Vincent",
-        "email": "[email protected]"
-      }
+        "name": "Jacob Hurlburt"
+      },
+      "strict": true
     }
   ]
 }

.claude-plugin/plugin.json

@@ -9,5 +9,12 @@
   "homepage": "https://github.com/obra/superpowers",
   "repository": "https://github.com/obra/superpowers",
   "license": "MIT",
-  "keywords": ["skills", "tdd", "debugging", "collaboration", "best-practices", "workflows"]
+  "keywords": [
+    "skills",
+    "tdd",
+    "debugging",
+    "collaboration",
+    "best-practices",
+    "workflows"
+  ]
 }

.gitignore

@@ -1,2 +1,3 @@
 .worktrees/
 .private-journal/
+/node_modules/

.pre-commit-config.yaml

@@ -0,0 +1,42 @@
+repos:
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v4.0.0-alpha.8
+    hooks:
+      - id: prettier
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-merge-conflict
+        args: [--assume-in-merge]
+      - id: check-yaml
+        args: [--unsafe]
+      - id: no-commit-to-branch
+        args: [--branch, main]
+      - id: debug-statements
+      - id: mixed-line-ending
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.18.4
+    hooks:
+      - id: gitleaks
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/adamchainz/blacken-docs
+    rev: 1.19.1
+    hooks:
+      - id: blacken-docs
+        additional_dependencies:
+          - black==22.12.0
+  - repo: https://github.com/ikamensh/flynt
+    rev: 1.0.6
+    hooks:
+      - id: flynt
+  - repo: https://github.com/rhysd/actionlint
+    rev: v1.7.7
+    hooks:
+      - id: actionlint

CHANGELOG.md

@@ -0,0 +1,96 @@
+# Changelog
+
+## Fork Information
+
+**Forked from**: [obra/superpowers](https://github.com/obra/superpowers) v3.2.2
+**Marketplace**: `jthurlburt/claude-settings`
+
+This is a personal fork with additional skills and enhancements borrowed from multiple sources.
+
+## [Unreleased]
+
+### Added
+
+- Knowledge management integration: Opt-in [ADR](https://adr.github.io/) (Architecture Decision Records) and DISCOVERIES patterns from [Microsoft Amplifier](https://github.com/microsoft/amplifier) (2025-11-03)
+  - `/setup-knowledge-management` slash command with embedded templates
+  - 9 skills updated to integrate with `docs/decisions/` and `docs/discoveries/` when present
+  - Skills fall back to `mem` for personal tracking when patterns not enabled
+  - Comprehensive integration documented in `docs/decisions/001-adopt-knowledge-management.md`
+
+## Attribution
+
+Skills and concepts borrowed from:
+
+- [obra/superpowers](https://github.com/obra/superpowers) - Base framework and core skills
+- [superpowers-skills](https://github.com/obra/superpowers-skills) - Problem-solving patterns
+- [CCPlugins](https://github.com/brennercruvinel/CCPlugins) - Development workflow skills
+- [claude-codex-settings](https://github.com/fcakyon/claude-codex-settings/tree/main) - Enhancement concepts and hooks
+- [Microsoft Amplifier](https://github.com/microsoft/amplifier) - Ambiguity and tension management patterns
+
+## Added Skills
+
+**From superpowers-skills:**
+
+- `simplification-cascades` - Find unifying principles that eliminate components
+- `collision-zone-thinking` - Force unrelated concepts together for innovation
+- `meta-pattern-recognition` - Spot universal patterns across domains
+- `inversion-exercise` - Flip assumptions to reveal alternatives
+- `scale-game` - Test at extremes to expose fundamental truths
+- `when-stuck` - Dispatch router to appropriate problem-solving technique
+- `tracing-knowledge-lineages` - Understand technical decision evolution
+- `preserving-productive-tensions` - Recognize when to preserve multiple approaches
+
+**From CCPlugins:**
+
+- `documentation-management` - Holistic documentation maintenance
+- `predict-issues` - Proactive problem identification with risk assessment
+- `code-and-project-cleanup` - Safe cleanup of code and project artifacts
+
+**New skills:**
+
+- `extracting-patterns-from-projects` - Systematic analysis methodology for external projects (2025-10-23)
+- `enhancing-superpowers` - Project-specific integration guide for superpowers (2025-10-23)
+
+## Enhanced Skills
+
+Skills with added capabilities from concept extraction:
+
+**brainstorming:**
+
+- External source adaptation pattern
+- Progressive reasoning framework (steel man alternatives, bias checking)
+
+**systematic-debugging:**
+
+- Auto-fix patterns with skill linkage for common test failures
+
+**predict-issues:**
+
+- Security-specific risk analysis (exploitability, exposure, blast radius)
+
+**executing-plans:**
+
+- Continuous validation between tasks (type checks, import validation)
+
+**finishing-a-development-branch:**
+
+- Documentation synchronization check
+- Optional commit history cleanup guidance
+
+**writing-plans:**
+
+- Existing pattern survey before planning
+
+**receiving-code-review:**
+
+- Pattern alignment checks before implementing feedback
+
+**dispatching-parallel-agents:**
+
+- Generalized from debugging-only to cover research, analysis, and any parallel tasks (2025-10-23)
+
+## Structural Changes
+
+- Flattened skills directory structure (removed nested categories)
+- Standardized skill names to Title Case per Anthropic guidelines
+- Added hooks from claude-codex-settings for session management

README.md

@@ -6,27 +6,39 @@ Give Claude Code superpowers with a comprehensive skills library of proven techn
 
 - **Testing Skills** - TDD, async testing, anti-patterns
 - **Debugging Skills** - Systematic debugging, root cause tracing, verification
+- **Problem-Solving Skills** - Simplification, innovation, pattern recognition, assumption challenges
+- **Research Skills** - Decision archaeology, knowledge lineage tracing
 - **Collaboration Skills** - Brainstorming, planning, code review, parallel agents
-- **Development Skills** - Git worktrees, finishing branches, subagent workflows
+- **Development Skills** - Git worktrees, finishing branches, subagent workflows, cleanup automation
+- **Documentation Skills** - Holistic documentation management
 - **Meta Skills** - Creating, testing, and sharing skills
 
 Plus:
-- **Slash Commands** - `/superpowers:brainstorm`, `/superpowers:write-plan`, `/superpowers:execute-plan`
+
+- **Slash Commands** - `/superpowers:brainstorm`, `/superpowers:write-plan`, `/superpowers:execute-plan`, `/superpowers:setup-knowledge-management`
+- **Knowledge Management** - Opt-in [ADR](https://adr.github.io/) (Architecture Decision Records) and DISCOVERIES patterns for tracking decisions and non-obvious solutions
 - **Automatic Integration** - Skills activate automatically when relevant
 - **Consistent Workflows** - Systematic approaches to common engineering tasks
 
-## Learn More
+## Attribution
+
+This is a personal fork of [obra/superpowers](https://github.com/obra/superpowers) with additional skills and enhancements borrowed from:
+
+- [superpowers-skills](https://github.com/obra/superpowers-skills) - Problem-solving patterns
+- [CCPlugins](https://github.com/brennercruvinel/CCPlugins) - Development workflow skills
+- [claude-codex-settings](https://github.com/fcakyon/claude-codex-settings/tree/main) - Enhancement concepts
+- [Microsoft Amplifier](https://github.com/microsoft/amplifier) - Tension management patterns
 
-Read the introduction: [Superpowers for Claude Code](https://blog.fsck.com/2025/10/09/superpowers/)
+See [CHANGELOG.md](CHANGELOG.md) for detailed changes and additions.
 
 ## Installation
 
 ### Via Plugin Marketplace (Recommended)
 
 ```bash
 # In Claude Code
-/plugin marketplace add obra/superpowers-marketplace
-/plugin install superpowers@superpowers-marketplace
+/plugin marketplace add jthurlburt/claude-settings
+/plugin install superpowers@jthurlburt-claude-plugins
 ```
 
 ### Verify Installation
@@ -46,23 +58,27 @@ Read the introduction: [Superpowers for Claude Code](https://blog.fsck.com/2025/
 ### Using Slash Commands
 
 **Brainstorm a design:**
+
 ```
 /superpowers:brainstorm
 ```
 
 **Create an implementation plan:**
+
 ```
 /superpowers:write-plan
 ```
 
 **Execute the plan:**
+
 ```
 /superpowers:execute-plan
 ```
 
 ### Automatic Skill Activation
 
 Skills activate automatically when relevant. For example:
+
 - `test-driven-development` activates when implementing features
 - `systematic-debugging` activates when debugging issues
 - `verification-before-completion` activates before claiming work is done
@@ -71,33 +87,59 @@ Skills activate automatically when relevant. For example:
 
 ### Skills Library
 
-**Testing** (`skills/testing/`)
+**Testing**
+
 - **test-driven-development** - RED-GREEN-REFACTOR cycle
 - **condition-based-waiting** - Async test patterns
 - **testing-anti-patterns** - Common pitfalls to avoid
+- **testing-skills-with-subagents** - Validate skill quality
 
-**Debugging** (`skills/debugging/`)
-- **systematic-debugging** - 4-phase root cause process
+**Debugging**
+
+- **systematic-debugging** - 4-phase root cause process (enhanced)
 - **root-cause-tracing** - Find the real problem
 - **verification-before-completion** - Ensure it's actually fixed
 - **defense-in-depth** - Multiple validation layers
 
-**Collaboration** (`skills/collaboration/`)
-- **brainstorming** - Socratic design refinement
-- **writing-plans** - Detailed implementation plans
-- **executing-plans** - Batch execution with checkpoints
+**Problem-Solving**
+
+- **simplification-cascades** - Find unifying principles that eliminate components
+- **collision-zone-thinking** - Force unrelated concepts together for innovation
+- **meta-pattern-recognition** - Spot universal patterns across domains
+- **inversion-exercise** - Flip assumptions to reveal alternatives
+- **scale-game** - Test at extremes to expose fundamental truths
+- **when-stuck** - Dispatch router to appropriate problem-solving technique
+- **predict-issues** - Proactive problem identification with risk assessment (enhanced)
+
+**Research & Architecture**
+
+- **tracing-knowledge-lineages** - Understand technical decision evolution
+- **preserving-productive-tensions** - Recognize when to preserve multiple approaches
+- **extracting-patterns-from-projects** - Systematic analysis methodology for external projects
+
+**Collaboration**
+
+- **brainstorming** - Socratic design refinement (enhanced)
+- **writing-plans** - Detailed implementation plans (enhanced)
+- **executing-plans** - Batch execution with checkpoints (enhanced)
 - **dispatching-parallel-agents** - Concurrent subagent workflows
 - **requesting-code-review** - Pre-review checklist
-- **receiving-code-review** - Responding to feedback
-- **using-git-worktrees** - Parallel development branches
-- **finishing-a-development-branch** - Merge/PR decision workflow
+- **receiving-code-review** - Responding to feedback (enhanced)
 - **subagent-driven-development** - Fast iteration with quality gates
 
-**Meta** (`skills/meta/`)
+**Development Workflow**
+
+- **using-git-worktrees** - Parallel development branches
+- **finishing-a-development-branch** - Merge/PR decision workflow (enhanced)
+- **documentation-management** - Holistic documentation maintenance
+- **code-and-project-cleanup** - Safe cleanup of code and project artifacts
+
+**Meta**
+
 - **writing-skills** - Create new skills following best practices
 - **sharing-skills** - Contribute skills back via branch and PR
-- **testing-skills-with-subagents** - Validate skill quality
 - **using-superpowers** - Introduction to the skills system
+- **enhancing-superpowers** - Project-specific integration guide for superpowers
 
 ### Commands
 
@@ -132,14 +174,14 @@ Skills live directly in this repository. To contribute:
 4. Use the `testing-skills-with-subagents` skill to validate quality
 5. Submit a PR
 
-See `skills/meta/writing-skills/SKILL.md` for the complete guide.
+See `skills/writing-skills/SKILL.md` for the complete guide.
 
 ## Updating
 
 Skills update automatically when you update the plugin:
 
 ```bash
-/plugin update superpowers
+/plugin update superpowers@jthurlburt/claude-settings
 ```
 
 ## License