From f6a7cd288ac6de7df4a234283164fd5a7eaaa1d8 Mon Sep 17 00:00:00 2001 From: l3ocho Date: Thu, 6 Nov 2025 08:56:30 -0500 Subject: [PATCH] initial setup: setting documents updated --- .gitignore | 2 +- CLAUDE.md | 27 ++++-- hhl-claude-agents.code-workspace | 146 +++++++++++++++++++++++++++++++ 3 files changed, 169 insertions(+), 6 deletions(-) create mode 100644 hhl-claude-agents.code-workspace diff --git a/.gitignore b/.gitignore index 2e74085..7a1cb5c 100644 --- a/.gitignore +++ b/.gitignore @@ -35,7 +35,7 @@ env/ # VS Code .vscode/ -*.code-workspace +# *.code-workspace # Jupyter Notebook .ipynb_checkpoints diff --git a/CLAUDE.md b/CLAUDE.md index 867bf4d..2df7d94 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -258,11 +258,22 @@ hyperhivelabs/claude-plugins/ - Plugin works with or without CLAUDE.md **Plugin Development:** -- Use `claude-plugin-developer` skill for all plugin-related work -- Reference when creating/updating plugin manifests, commands, agents, hooks, or MCP servers -- Ensures compliance with Anthropic's security requirements and best practices -- Provides templates, validation tools, and troubleshooting guidance -- Critical for proper plugin structure, path safety, and marketplace publication +- **ALWAYS use the `claude-plugin-developer` skill for all plugin-related work** +- Invoke the skill when: + - Creating new plugin manifests (`plugin.json`) + - Developing commands, agents, hooks, or MCP servers + - Validating plugin structure and security + - Troubleshooting plugin loading issues + - Publishing to marketplaces +- The skill provides: + - Security best practices and validation + - Templates and helper scripts + - Complete reference documentation + - Path safety requirements (`${CLAUDE_PLUGIN_ROOT}`) + - Manifest schema validation +- **Critical:** Ensures compliance with Anthropic's security requirements +- Location: `.claude/skills/claude-plugin-developer/` +- Usage: Invoke via Skill tool when working on plugin components ## Multi-Project Context (PMO Plugin) @@ -328,6 +339,12 @@ This repository contains comprehensive planning documentation: - **`docs/projman-python-quickstart.md`** - Python-specific implementation guide - **`docs/two-mcp-architecture-guide.md`** - Deep dive into two-MCP architecture +**Skills:** +- **`.claude/skills/claude-plugin-developer/`** - Plugin development guidance and validation tools + - Use this skill for all plugin-related work (manifests, commands, agents, hooks, MCP servers) + - Includes security validation, templates, and helper scripts + - Invoke via Skill tool when working on plugin components + **Start with:** `docs/DOCUMENT-INDEX.md` for navigation guidance ## Recent Updates (Updated: 2025-06-11) diff --git a/hhl-claude-agents.code-workspace b/hhl-claude-agents.code-workspace new file mode 100644 index 0000000..ec82006 --- /dev/null +++ b/hhl-claude-agents.code-workspace @@ -0,0 +1,146 @@ +{ + "folders": [ + { + "path": "." + } + ], + "settings": { + // ===== Terminal Settings ===== + "terminal.integrated.defaultLocation": "editor", + "terminal.integrated.fontSize": 12, + // ===== Python Interpreter & Environment ===== + "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python", + "python.terminal.activateEnvInCurrentTerminal": true, + "python.envFile": "${workspaceFolder}/.env", + // ===== Python Analysis & Type Checking ===== + "python.analysis.autoFormatStrings": true, + "python.analysis.typeCheckingMode": "standard", + "python.analysis.completeFunctionParens": true, + "python.analysis.inlayHints.functionReturnTypes": true, + "python.analysis.inlayHints.variableTypes": true, + "python.analysis.extraPaths": [ + "${workspaceFolder}/src" + ], + "python.analysis.autoImportCompletions": true, + // ===== Python Testing (pytest) ===== + "python.testing.pytestEnabled": true, + "python.testing.unittestEnabled": false, + "python.testing.pytestArgs": [ + "tests", + "-v", + "--tb=short" + ], + "python.testing.cwd": "${workspaceFolder}", + "python.testing.autoTestDiscoverOnSaveEnabled": true, + // ===== Editor General Settings ===== + "editor.colorDecorators": true, + "editor.minimap.autohide": "none", + "editor.formatOnSave": true, + "editor.codeActionsOnSave": { + "source.organizeImports": "explicit" + }, + "editor.folding": true, + "editor.foldingStrategy": "auto", + "workbench.colorCustomizations": { + "statusBar.background": "#d16003", + "statusBar.foreground": "#ffffff", + "statusBar.noFolderBackground": "#000000", + "statusBar.debuggingBackground": "#d16003", + "statusBar.border": "#d16003", + "statusBarItem.remoteBackground": "#aa4f04" + }, + // ===== File Settings ===== + "files.trimTrailingWhitespace": true, + "files.insertFinalNewline": true, + "files.exclude": { + "**/__pycache__": true, + "**/*.pyc": true, + "**/.pytest_cache": true, + "**/.mypy_cache": true, + "**/.venv": true, + "**/.env": false, + "**/.vscode": false, + "**/.DS_Store": true, + "**/.claude": false, + "**/.coverage": true, + "**/htmlcov": true + }, + // ===== Python-Specific Settings ===== + "[python]": { + "diffEditor.ignoreTrimWhitespace": false, + "editor.formatOnType": true, + "editor.wordBasedSuggestions": "off", + "editor.defaultFormatter": "ms-python.black-formatter", + "editor.codeActionsOnSave": { + "source.organizeImports": "explicit" + } + }, + // ===== Black Formatter Settings ===== + "black-formatter.args": [ + "--line-length=88" + ], + // ===== JSON Settings ===== + "json.format.enable": true, + "json.format.keepLines": true, + "[json]": { + "editor.quickSuggestions": { + "strings": true + }, + "editor.suggest.insertMode": "replace", + "editor.defaultFormatter": "vscode.json-language-features" + }, + // ===== Favorites Extension Settings ===== + "favorites.groups": [ + "Core", + "Planning", + "Plugins", + "MCP", + "Skills" + ], + "favorites.currentGroup": "Core", + "favorites.resources": [ + { + "filePath": "CLAUDE.md", + "group": "Core" + }, + { + "filePath": "README.md", + "group": "Core" + }, + { + "filePath": "hhl-claude-agents.code-workspace", + "group": "Core" + }, + { + "filePath": ".gitignore", + "group": "Core" + }, + { + "filePath": "docs/references/projman-pmo/DOCUMENT-INDEX.md", + "group": "Planning" + }, + { + "filePath": "docs/references/projman-pmo/CORRECT-ARCHITECTURE.md", + "group": "Planning" + }, + { + "filePath": "docs/references/projman-pmo/projman-implementation-plan-updated.md", + "group": "Planning" + }, + { + "filePath": "docs/references/projman-pmo/projman-python-quickstart.md", + "group": "Planning" + }, + { + "filePath": "docs/references/projman-pmo/two-mcp-architecture-guide.md", + "group": "Planning" + }, + { + "filePath": ".claude-plugins/marketplace.json", + "group": "Plugins" + } + ], + "workbench.panel.defaultLocation": "right" + + } +}