@fermindi/pwn-cli 0.4.0 → 0.5.0

package/cli/update.js

@@ -166,12 +166,13 @@ export default async function updateCommand(args = []) {
     if (templateContent !== currentContent) {
       if (dryRun) {
         console.log(`   📝 Would update: CLAUDE.md`);
-        if (currentContent) {
+        // Only mention backup if content is actually different (not empty)
+        if (currentContent && currentContent !== templateContent) {
           console.log(`   📦 Would backup: CLAUDE.md → ~CLAUDE.md`);
         }
       } else {
-        // Backup existing CLAUDE.md
-        if (existsSync(claudeMdPath) && currentContent) {
+        // Backup existing CLAUDE.md only if it has custom content (different from template)
+        if (existsSync(claudeMdPath) && currentContent && currentContent !== templateContent) {
           renameSync(claudeMdPath, backupClaudeMdPath);
           console.log(`   📦 Backed up: CLAUDE.md → ~CLAUDE.md`);
           backed_up.push('CLAUDE.md');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fermindi/pwn-cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Professional AI Workspace - Inject structured memory and automation into any project for AI-powered development",
   "type": "module",
   "bin": {

package/src/core/inject.js

@@ -175,23 +175,28 @@ export async function inject(options = {}) {
     // Update .gitignore
     updateGitignore(cwd, silent);
 
-    // Handle CLAUDE.md: backup existing and copy PWN template to root
+    // Handle CLAUDE.md: backup existing (only if different) and copy PWN template to root
     let backupInfo = { backed_up: [] };
     const claudeMdPath = join(cwd, 'CLAUDE.md');
     const backupClaudeMdPath = join(cwd, '~CLAUDE.md');
     const templateClaudeMd = join(targetDir, 'agents', 'claude.md');
+    const templateContent = existsSync(templateClaudeMd) ? readFileSync(templateClaudeMd, 'utf8') : '';
 
-    // Backup existing CLAUDE.md if present
+    // Backup existing CLAUDE.md if present AND different from template
     if (backedUpContent['CLAUDE.md'] || backedUpContent['claude.md']) {
       const originalName = backedUpContent['CLAUDE.md'] ? 'CLAUDE.md' : 'claude.md';
       const originalPath = join(cwd, originalName);
+      const existingContent = backedUpContent[originalName]?.content || '';
 
-      if (existsSync(originalPath)) {
+      // Only backup if content is different from PWN template
+      if (existsSync(originalPath) && existingContent !== templateContent) {
         renameSync(originalPath, backupClaudeMdPath);
         backupInfo.backed_up.push({ from: originalName, to: '~CLAUDE.md' });
         if (!silent) {
           console.log(`📦 Backed up ${originalName} → ~CLAUDE.md`);
         }
+      } else if (existsSync(originalPath) && !silent) {
+        console.log(`⏭️  Skipped backup: ${originalName} is identical to PWN template`);
       }
     }
 

package/templates/workspace/.ai/agents/claude.md

@@ -38,9 +38,9 @@ Read these files in order:
    - Ask user before deviating from active decisions
 
 2. **`/.ai/memory/patterns.md`**
-   - Codebase patterns learned by team
-   - Apply these patterns to new work
-   - Add new patterns when discovered
+   - Index of patterns documented in `.ai/patterns/`
+   - Check which patterns exist for this project
+   - Add index entry when creating new pattern files
 
 3. **`/.ai/memory/deadends.md`**
    - Failed approaches documented (DE-XXX)
@@ -208,6 +208,42 @@ If any gate fails:
 - Ask user if unsure how to proceed
 - Don't commit until gates pass
 
+### Pattern Checkpoint (Mandatory Before Commit)
+
+Before every commit, review the work done and check if any pattern should be documented.
+
+**Document a pattern when ANY of these criteria are met:**
+
+1. **User corrected your approach** - The user told you to do something differently. Document the correct approach so future sessions don't repeat the mistake.
+2. **You chose between alternatives** - You evaluated 2+ options and picked one. Document what was chosen and why.
+3. **Workaround for limitation** - A library, framework, or tool has a non-obvious limitation. Document the workaround.
+4. **Convention established** - First time implementing a certain type of thing in this codebase (first API route, first test, first component). Document the convention for consistency.
+5. **Repeated approach** - You used the same approach 2+ times in this session. Document it to avoid re-deriving it.
+6. **Non-trivial solution** - The solution wasn't obvious or took investigation to find. Document it so it's immediately available next time.
+
+**If a criterion is met:**
+
+1. Create pattern file: `.ai/patterns/{category}/{pattern-name}.md`
+   ```markdown
+   # Pattern Name
+
+   ## Context
+   When to apply this pattern.
+
+   ## Pattern
+   Description or code example.
+
+   ## Rationale
+   Why this approach works better.
+
+   ## Examples
+   - `src/path/file.ts:42`
+   ```
+2. Add index entry to `.ai/memory/patterns.md`
+3. Commit pattern files together with the code change
+
+**If no criteria are met:** proceed to commit normally. Don't force patterns that aren't there.
+
 ### Commit Message Format
 
 Use conventional commits:
@@ -245,15 +281,9 @@ When completing work:
    - [x] US-042: My completed task (YYYY-MM-DD)
    ```
 
-2. Update `/.ai/memory/patterns.md` if new pattern discovered
-   ```
-   ## New Pattern Category
-
-   ### Pattern Name
-   **Context:** When to use
-   **Pattern:** Description
-   **Rationale:** Why it's better
-   ```
+2. Document patterns following the **Pattern Checkpoint** criteria above
+   - Create file in `.ai/patterns/{category}/{name}.md`
+   - Add index entry in `.ai/memory/patterns.md`
 
 3. Add to `/.ai/memory/deadends.md` if approach failed
    ```
@@ -590,7 +620,7 @@ When finishing a session:
    - Add completion date if done
 
 3. **Document learnings**
-   - Update `/.ai/memory/patterns.md` if discovered pattern
+   - Document patterns in `.ai/patterns/` and index in `memory/patterns.md`
    - Update `/.ai/memory/deadends.md` if failed approach
    - Reference in commit messages
 

package/templates/workspace/.ai/memory/patterns.md

@@ -1,65 +1,19 @@
-# Codebase Patterns
+# Codebase Patterns Index
 
-This file documents recurring patterns discovered during development.
+This file is an index of patterns documented in `.ai/patterns/`.
+Each entry links to the full pattern file.
 
-## Format
+## Registered Patterns
 
-Each pattern follows this structure:
+<!-- AI: Add entries here as you create pattern files -->
+<!-- Format: - [{category}/{name}](.ai/patterns/{category}/{name}.md) - Brief description -->
 
-```markdown
-## Pattern Category
-
-### Pattern Name
-**Context:** When this pattern applies
-**Pattern:** Code example or description
-**Rationale:** Why this is the better approach
-**Example Location:** Where to find real examples
-```
-
----
-
-## Add New Patterns
-
-When you discover a useful pattern:
-
-1. Identify the category (Frontend, Backend, Testing, etc.)
-2. Fill in all sections
-3. Add code example if possible
-4. Commit with message: `docs: add pattern - [name]`
-5. Update `patterns/index.md` if this should be auto-applied
-
----
-
-## Pattern Categories
-
-- **Frontend:** React, TypeScript, styling, component patterns
-- **Backend:** API design, database queries, middleware
-- **Testing:** Unit tests, integration tests, fixtures
-- **Performance:** Caching, memoization, optimization
-- **Security:** Input validation, authentication, authorization
-- **Error Handling:** Exception patterns, recovery strategies
-- **Data Structures:** Modeling domain objects effectively
-
----
-
-## Template for New Pattern
-
-```markdown
-## [Category]
-
-### [Pattern Name]
-**Context:** (When to use this pattern)
-**Pattern:** (Description or code example)
-**Rationale:** (Why this is better)
-**Example Location:** (Where in codebase)
-```
+_No patterns registered yet._
 
 ---
 
-## Notes
+## How to Add
 
-- Patterns should be language-agnostic when possible
-- Prioritize patterns that prevent common bugs
-- Link related patterns together
-- Update this file as team learns new approaches
-- Archive rarely-used patterns after 3 months of no references
+1. Create pattern file: `.ai/patterns/{category}/{pattern-name}.md`
+2. Add index entry here with link and brief description
+3. Commit both files together

package/templates/workspace/.claude/commands/save.md

@@ -103,10 +103,50 @@ Create a session summary:
 ## Dead Ends
 - DE-XXX: description (if any)
 
+## Patterns Documented
+- [{category}/{name}] - description (if any)
+
 ---
 *Saved: {ISO timestamp}*
 ```
 
+### 6. Pattern Extraction (.ai/patterns/)
+
+Review the entire session and extract patterns. Check each criterion:
+
+1. **User corrected your approach** → Document the correct approach
+2. **You chose between alternatives** → Document what was chosen and why
+3. **Workaround for limitation** → Document the workaround
+4. **Convention established** → Document for consistency
+5. **Repeated approach** → Document to avoid re-deriving
+6. **Non-trivial solution** → Document for future sessions
+
+**For each pattern found:**
+
+1. Create file: `.ai/patterns/{category}/{pattern-name}.md`
+   ```markdown
+   # Pattern Name
+
+   ## Context
+   When to apply this pattern.
+
+   ## Pattern
+   Description or code example.
+
+   ## Rationale
+   Why this approach works better.
+
+   ## Examples
+   - `src/path/file.ts:42`
+   ```
+
+2. Add index entry to `.ai/memory/patterns.md`:
+   ```markdown
+   - [{category}/{name}](.ai/patterns/{category}/{name}.md) - Brief description
+   ```
+
+**If no patterns found:** Confirm "Patterns: no new patterns this session"
+
 ---
 
 ## Output Format
@@ -119,6 +159,7 @@ PWN Save Complete:
 - Tasks: {X} active, {Y} completed
 - Dead Ends: {new count or "no new"}
 - Decisions: {new count or "no new"}
+- Patterns: {new count or "no new"}
 - Archive: .ai/memory/archive/{filename}
 - Last updated: {timestamp}
 ```
@@ -132,6 +173,7 @@ PWN Save Complete:
 3. **decisions.md**: Organized entries with proper DEC-XXX IDs
 4. **active.md**: Only current sprint tasks
 5. **archive/**: One file per session with summary
+6. **patterns/**: One file per pattern, indexed in memory/patterns.md
 
 ---
 

package/templates/workspace/.claude/settings.json

@@ -2,20 +2,11 @@
   "hooks": {
     "Notification": [
       {
-        "matcher": "permission_prompt",
+        "matcher": "",
         "hooks": [
           {
             "type": "command",
-            "command": "pwn notify send \"Claude Code aguardando permissão\" --title \"PWN\""
-          }
-        ]
-      },
-      {
-        "matcher": "idle_prompt",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "pwn notify send \"Claude Code aguardando input\" --title \"PWN\""
+            "command": "pwn notify send \"Claude Code aguardando permissao\" --title \"PWN\""
           }
         ]
       }