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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed

jthurlburt wants to merge 89 commits into obra:main from jthurlburt:feature/amplifier-integration

.claude-plugin/marketplace.json

            
                      Original file line number
                      Diff line number
                      Diff line change
                  
    @@ -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

-Original file line number
+Diff line change
@@ Expand Up / @@ -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

-Original file line number
+Diff line change
@@ -1,2 +1,3 @@
     .worktrees/
     .private-journal/
+    /node_modules/

.pre-commit-config.yaml

-Original file line number
+Diff line change
@@ -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

-Original file line number
+Diff line change
@@ -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

            
                      Original file line number
                      Diff line number
                      Diff line change
                  
    @@ -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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

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

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!