glootie-cc 2.0.0

package/README.md

@@ -0,0 +1,55 @@
+# WFGY Enhanced Claude Code Plugin
+
+An advanced Claude Code plugin that provides comprehensive automated workflows, WFGY integration, and bundled MCP tools for enhanced development productivity.
+
+## Structure
+
+- `claude-plugin.json` - Main plugin configuration with advanced hooks and bundled MCP servers
+- `context/work-guidelines.md` - Work guidelines loaded on user prompts
+- `context/cleanup-guidelines.md` - Cleanup guidelines loaded on session stop
+
+## Installation
+
+1. Copy the plugin files to your desired location
+2. Load the plugin in Claude Code settings
+3. MCP tools are automatically bundled and available
+
+## Features
+
+### Automated Hooks
+- **UserPromptSubmit**: Automatically loads work guidelines and runs WFGY hook on every user prompt
+- **Stop**: Automatically runs cleanup guidelines and WFGY hook when session stops
+- **SessionStart**: Automatically initializes MCP thorns when session begins
+- **PreToolUse**: Shows notifications before Write/Edit/Bash operations
+- **PostToolUse**: Confirms completion of Write/Edit/Bash operations
+- **SessionEnd**: Automatically saves WFGY context on session end
+
+### Bundled MCP Tools
+- **glootie** - Code execution and testing via `mcp-glootie@latest`
+- **vexify** - Code search and AST analysis via `vexify@latest`
+- **playwright** - Browser automation and testing via `@playwright/mcp@latest`
+- **mcp-thorns** - WFGY integration (loaded via hooks)
+
+### Comprehensive Permissions
+Full tool access including:
+- **Core Tools**: Read, Write, Edit, Bash, Task, WebFetch, Glob, Grep, TodoWrite
+- **MCP Tools**: glootie (execute, ast_tool, caveat), playwright (browser automation), vexify (search_code)
+
+### Plugin Settings
+- **autoSave**: Enabled for automatic saving
+- **compactOnStop**: Disabled to preserve context
+- **notificationTimeout**: 5 seconds
+- **debugMode**: Disabled for production use
+
+## Workflow Automation
+
+The plugin provides fully automated workflows:
+
+1. **Session Start**: Initializes WFGY and MCP tools
+2. **During Work**: Provides guidance and notifications for all operations
+3. **Session End**: Saves context and runs cleanup procedures
+
+No manual command invocation needed - everything runs automatically through hooks.
+
+## Version
+**v2.0.0** - Enhanced with advanced hooks and comprehensive MCP integration

package/claude-plugin.json

@@ -0,0 +1,119 @@
+{
+  "permissions": {
+    "allow": ["Read", "Write", "Edit", "Bash", "Task", "WebFetch", "Glob", "Grep", "TodoWrite", "mcp__glootie__execute", "mcp__glootie__ast_tool", "mcp__glootie__caveat", "mcp__playwright__browser_navigate", "mcp__playwright__browser_click", "mcp__playwright__browser_type", "mcp__playwright__browser_snapshot", "mcp__playwright__browser_close", "mcp__vexify__search_code"]
+  },
+  "mcpServers": {
+    "glootie": {
+      "command": "npx",
+      "args": ["-y", "mcp-glootie@latest"]
+    },
+    "vexify": {
+      "command": "npx",
+      "args": ["-y", "vexify@latest", "mcp"]
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    }
+  },
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx -y wfgy hook && cat CLAUDE.md && npx -y mcp-thorns@latest && cat ./context/work-guidelines.md"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx -y wfgy@latest hook && cat ./context/cleanup-guidelines.md"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx -y mcp-thorns@latest"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": ["Write", "Edit"],
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo \"🔧 Preparing to modify codebase...\""
+          }
+        ]
+      },
+      {
+        "matcher": ["Bash"],
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo \"💻 Executing shell command...\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": ["Write", "Edit"],
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo \"✅ Code modification complete\""
+          }
+        ]
+      },
+      {
+        "matcher": ["Bash"],
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo \"✅ Shell command executed\""
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo \"👋 Session ended - WFGY context saved\""
+          }
+        ]
+      }
+    ]
+  },
+  "alwaysThinkingEnabled": false,
+  "settings": {
+    "autoSave": true,
+    "compactOnStop": false,
+    "notificationTimeout": 5000,
+    "debugMode": false
+  },
+  "metadata": {
+    "name": "glootie-cc",
+    "version": "2.0.0",
+    "description": "Advanced Claude Code plugin with WFGY integration, MCP tools, and automated hooks",
+    "author": "AnEntrypoint",
+    "homepage": "https://github.com/AnEntrypoint/glootie-cc"
+  }
+}

package/context/cleanup-guidelines.md

@@ -0,0 +1,3 @@
+Assign wfgy mutables to any issues that remain, to troubleshoot and fix them then scan the codebase to see if there are any other areas that should also be updated because of these changes, then use WFGY to determine if there's architectural changes that must now happen, and finally if the project is deployable, deploy it, if it's an npm project, publish it, and merge and sync the github intelligently, then clean up any files we've left behind in the codebase, that aren't part of the program's permanent structure, and use WFGY the selection of code if there's any complexity in the github merge to ensure we intelligently merge additions and removals whenever they represent an intentional advancement in the codebase.
+
+Mandatory: there must only be one comment in every file, at the top of the file, with a super compact description of the technical caveats, intended exports and imports, relationship to the rest of the program structure and internal function of it, we must ALWAYS update the spec of each file we edited, if we see a code file with no spec at the top, it must immediately be added, we must immediately remove any comments we find that's not that comment, no exceptions. Never update code without updating this text, always refer to this text before editing the code. If our codebase analysis exposes files with more or less than one comment, fix it immediately. Use MCP playwright never use regular playwright.

package/context/work-guidelines.md

@@ -0,0 +1,24 @@
+Do not create files that aren't a part of the permanent structure of the codebase unless asked for.
+Never add any mocks or simulations anywhere.
+Only write primary implementations and never make fallbacks of any kind.
+Always first check that we're not re-implementing an existing part before making new parts.
+
+Memorize everything you learn to make it work to CLAUDE.md. We want to memorize how things work (NO CHANGELOGS JUST TECH INFO) not what's been done (IN THE PROJECT CODEBASE) continuously. It's not a log or a work history, it's for all the technical caveats and notes. Always clean it up while editing it, remove any changelogs from it, it must be as concise as possible without losing any meaning, zero additional tokens. Otherwise if the information applies to all projects edit ~/.claude/CLAUDE.md so you don't make mistakes in the future, update it and remove things that no longer apply.
+
+# VERY IMPORTANT YOU MUST **ALWAYS DO THIS USING MCP** **(NO EXCEPTIONS)**:
+- If there's client side code create global to access client side parts in real time for debugging
+- Analyze and handle all issues before implementing in code, be as methodical and deal with all corner cases first, find ground truth by executing code to make sure you measure-twice-cut-once
+- Use the mop-and-bucket approach to check the rest of the codebase and make sure we don't make duplicate implementations, consolidate all duplicates, keep the codebase simple, well frameworked, convention-over-configuration, configuration-over-code at all times
+- Make all outstanding codebase changes immediately, don't stop when there's work left to do
+- Before making changes to client side code, do code executions in playwright mcp to find out if the changes will work
+- Test and change as many times as needed to finish all the work requested, never under any circumstances finish or summarize when there's work left to do. Check what mcp tools are available and use what's useful
+
+Be forward thinking about architectural sanity, if something should be done, to improve the architecture, generalize or DRY the code, do it immediately before continuing. Our code style must be at all times concise, DRY, generalized and forward thinking structurally.
+
+If a file is more than 200 lines split it immediately before continuing.
+When troubleshooting any issue look back a few versions in the git history to see if it's a regression, use the history to guide to back to a working version if possible, otherwise choose a solution.
+
+Always use a persistent background shell to do your tests.
+
+When using playwright, always close everything before you start your test, this will sort out the cache.
+Use vexify, glootie, and playwright as much as possible when available. Test server side ideas in glootie execute and client side ideas in playwright code execution before changing code, use them to debug in real time by executing, use vexify for code lookups when you don't know the exact syntax or for searching for multiple things that are similar.

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "glootie-cc",
+  "version": "2.0.0",
+  "description": "Advanced Claude Code plugin with WFGY integration, MCP tools, and automated hooks",
+  "main": "claude-plugin.json",
+  "files": [
+    "claude-plugin.json",
+    "context/",
+    "README.md"
+  ],
+  "keywords": [
+    "claude-code",
+    "claude-plugin",
+    "wfgy",
+    "mcp",
+    "automation",
+    "glootie"
+  ],
+  "author": "AnEntrypoint",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AnEntrypoint/glootie-cc.git"
+  },
+  "homepage": "https://github.com/AnEntrypoint/glootie-cc#readme",
+  "bugs": {
+    "url": "https://github.com/AnEntrypoint/glootie-cc/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/claude-code": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}