plan/documentation-review #1

Merged
lmiranda merged 2 commits from plan/documentation-review into development 2025-11-06 19:07:10 +00:00
3 changed files with 169 additions and 6 deletions
Showing only changes of commit f6a7cd288a - Show all commits

2
.gitignore vendored
View File

@@ -35,7 +35,7 @@ env/
# VS Code
.vscode/
*.code-workspace
# *.code-workspace
# Jupyter Notebook
.ipynb_checkpoints

View File

@@ -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)

View File

@@ -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"
}
}