Initial commit

2025-11-29 18:04:01 +08:00
commit 715968653b
4 changed files with 225 additions and 0 deletions
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -0,0 +1,12 @@
+{
+  "name": "analyze-codebase",
+  "description": "Generate comprehensive analysis and documentation of entire codebase",
+  "version": "1.0.0",
+  "author": {
+    "name": " Anand Tyagi",
+    "url": "https://github.com/ananddtyagi"
+  },
+  "commands": [
+    "./commands"
+  ]
+}
--- a/README.md
+++ b/README.md
@@ -0,0 +1,3 @@
+# analyze-codebase
+
+Generate comprehensive analysis and documentation of entire codebase
--- a/commands/analyze-codebase.md
+++ b/commands/analyze-codebase.md
@@ -0,0 +1,165 @@
+---
+allowed-tools: Bash(find:*), Bash(ls:*), Bash(tree:*), Bash(grep:*), Bash(wc:*), Bash(du:*), Bash(head:*), Bash(tail:*), Bash(cat:*), Bash(touch:*)
+description: Generate comprehensive analysis and documentation of entire codebase
+---
+
+# Comprehensive Codebase Analysis
+
+## Project Discovery Phase
+
+### Directory Structure
+!`find . -type d -not -path "./node_modules/*" -not -path "./.git/*" -not -path "./dist/*" -not -path "./build/*" -not -path "./.next/*" -not -path "./coverage/*" | sort`
+
+### Complete File Tree
+!`tree -a -I 'node_modules|.git|dist|build|.next|coverage|*.log' -L 4`
+
+### File Count and Size Analysis
+- Total files: !`find . -type f -not -path "./node_modules/*" -not -path "./.git/*" | wc -l`
+- Code files: !`find . -name "*.js" -o -name "*.ts" -o -name "*.jsx" -o -name "*.tsx" -o -name "*.py" -o -name "*.java" -o -name "*.php" -o -name "*.rb" -o -name "*.go" -o -name "*.rs" -o -name "*.cpp" -o -name "*.c" | grep -v node_modules | wc -l`
+- Project size: !`du -sh . --exclude=node_modules --exclude=.git --exclude=dist --exclude=build`
+
+## Configuration Files Analysis
+
+### Package Management
+- Package.json: @package.json
+- Package-lock.json exists: !`ls package-lock.json 2>/dev/null || echo "Not found"`
+- Yarn.lock exists: !`ls yarn.lock 2>/dev/null || echo "Not found"`
+- Requirements.txt: @requirements.txt
+- Gemfile: @Gemfile
+- Cargo.toml: @Cargo.toml
+- Go.mod: @go.mod
+- Composer.json: @composer.json
+
+### Build & Dev Tools
+- Webpack config: @webpack.config.js
+- Vite config: @vite.config.js
+- Rollup config: @rollup.config.js
+- Babel config: @.babelrc
+- ESLint config: @.eslintrc.js
+- Prettier config: @.prettierrc
+- TypeScript config: @tsconfig.json
+- Tailwind config: @tailwind.config.js
+- Next.js config: @next.config.js
+
+### Environment & Docker
+- .env files: !`find . -name ".env*" -type f`
+- Docker files: !`find . -name "Dockerfile*" -o -name "docker-compose*"`
+- Kubernetes files: !`find . -name "*.yaml" -o -name "*.yml" | grep -E "(k8s|kubernetes|deployment|service)"`
+
+### CI/CD Configuration
+- GitHub Actions: !`find .github -name "*.yml" -o -name "*.yaml" 2>/dev/null || echo "No GitHub Actions"`
+- GitLab CI: @.gitlab-ci.yml
+- Travis CI: @.travis.yml
+- Circle CI: @.circleci/config.yml
+
+## Source Code Analysis
+
+### Main Application Files
+- Main entry points: !`find . -name "main.*" -o -name "index.*" -o -name "app.*" -o -name "server.*" | grep -v node_modules | head -10`
+- Routes/Controllers: !`find . -path "*/routes/*" -o -path "*/controllers/*" -o -path "*/api/*" | grep -v node_modules | head -20`
+- Models/Schemas: !`find . -path "*/models/*" -o -path "*/schemas/*" -o -path "*/entities/*" | grep -v node_modules | head -20`
+- Components: !`find . -path "*/components/*" -o -path "*/views/*" -o -path "*/pages/*" | grep -v node_modules | head -20`
+
+### Database & Storage
+- Database configs: !`find . -name "*database*" -o -name "*db*" -o -name "*connection*" | grep -v node_modules | head -10`
+- Migration files: !`find . -path "*/migrations/*" -o -path "*/migrate/*" | head -10`
+- Seed files: !`find . -path "*/seeds/*" -o -path "*/seeders/*" | head -10`
+
+### Testing Files
+- Test files: !`find . -name "*test*" -o -name "*spec*" | grep -v node_modules | head -15`
+- Test config: @jest.config.js
+
+### API Documentation
+- API docs: !`find . -name "*api*" -name "*.md" -o -name "swagger*" -o -name "openapi*" | head -10`
+
+## Key Files Content Analysis
+
+### Root Configuration Files
+@README.md
+@LICENSE
+@.gitignore
+
+### Main Application Entry Points
+!`find . -name "index.js" -o -name "index.ts" -o -name "main.js" -o -name "main.ts" -o -name "app.js" -o -name "app.ts" -o -name "server.js" -o -name "server.ts" | grep -v node_modules | head -5 | while read file; do echo "=== $file ==="; head -50 "$file"; echo; done`
+
+## Your Task
+
+Based on all the discovered information above, create a comprehensive analysis that includes:
+
+## 1. Project Overview
+- Project type (web app, API, library, etc.)
+- Tech stack and frameworks
+- Architecture pattern (MVC, microservices, etc.)
+- Language(s) and versions
+
+## 2. Detailed Directory Structure Analysis
+For each major directory, explain:
+- Purpose and role in the application
+- Key files and their functions
+- How it connects to other parts
+
+## 3. File-by-File Breakdown
+Organize by category:
+- **Core Application Files**: Main entry points, routing, business logic
+- **Configuration Files**: Build tools, environment, deployment
+- **Data Layer**: Models, database connections, migrations
+- **Frontend/UI**: Components, pages, styles, assets  
+- **Testing**: Test files, mocks, fixtures
+- **Documentation**: README, API docs, guides
+- **DevOps**: CI/CD, Docker, deployment scripts
+
+## 4. API Endpoints Analysis
+If applicable, document:
+- All discovered endpoints and their methods
+- Authentication/authorization patterns
+- Request/response formats
+- API versioning strategy
+
+## 5. Architecture Deep Dive
+Explain:
+- Overall application architecture
+- Data flow and request lifecycle
+- Key design patterns used
+- Dependencies between modules
+
+## 6. Environment & Setup Analysis
+Document:
+- Required environment variables
+- Installation and setup process
+- Development workflow
+- Production deployment strategy
+
+## 7. Technology Stack Breakdown
+List and explain:
+- Runtime environment
+- Frameworks and libraries
+- Database technologies
+- Build tools and bundlers
+- Testing frameworks
+- Deployment technologies
+
+## 8. Visual Architecture Diagram
+Create a comprehensive diagram showing:
+- High-level system architecture
+- Component relationships
+- Data flow
+- External integrations
+- File structure hierarchy
+
+Use ASCII art, mermaid syntax, or detailed text representation to show:
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│     Frontend    │────▶│      API        │────▶│    Database     │
+│   (React/Vue)   │     │   (Node/Flask)  │     │ (Postgres/Mongo)│
+└─────────────────┘     └─────────────────┘     └─────────────────┘
+
+## 9. Key Insights & Recommendations
+Provide:
+- Code quality assessment
+- Potential improvements
+- Security considerations
+- Performance optimization opportunities
+- Maintainability suggestions
+
+Think deeply about the codebase structure and provide comprehensive insights that would be valuable for new developers joining the project or for architectural decision-making.
+
+At the end, write all of the output into a file called "codebase_analysis.md"
--- a/plugin.lock.json
+++ b/plugin.lock.json
@@ -0,0 +1,45 @@
+{
+  "$schema": "internal://schemas/plugin.lock.v1.json",
+  "pluginId": "gh:ccplugins/awesome-claude-code-plugins:plugins/analyze-codebase",
+  "normalized": {
+    "repo": null,
+    "ref": "refs/tags/v20251128.0",
+    "commit": "44a7ee893440181071f9d41d28f7092e1102ccee",
+    "treeHash": "79856c87d621d5910d96da597f0d80ef665be05bd94e9a70ac8c848dd1225bf7",
+    "generatedAt": "2025-11-28T10:14:31.714538Z",
+    "toolVersion": "publish_plugins.py@0.2.0"
+  },
+  "origin": {
+    "remote": "git@github.com:zhongweili/42plugin-data.git",
+    "branch": "master",
+    "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
+    "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
+  },
+  "manifest": {
+    "name": "analyze-codebase",
+    "description": "Generate comprehensive analysis and documentation of entire codebase",
+    "version": "1.0.0"
+  },
+  "content": {
+    "files": [
+      {
+        "path": "README.md",
+        "sha256": "ccd60b717a4e3b42f0a7f979d5dc1fa6f4d9d11bdb378ef604531f88a7bd36b6"
+      },
+      {
+        "path": ".claude-plugin/plugin.json",
+        "sha256": "3b417db832b473bda6444634181c9490b880e44694cd86747c9871f6f678f297"
+      },
+      {
+        "path": "commands/analyze-codebase.md",
+        "sha256": "879714da8bd2d5f94319ccf3d0a3389cf097f817082fd1b2637622eceb0f9058"
+      }
+    ],
+    "dirSha256": "79856c87d621d5910d96da597f0d80ef665be05bd94e9a70ac8c848dd1225bf7"
+  },
+  "security": {
+    "scannedAt": null,
+    "scannerVersion": null,
+    "flags": []
+  }
+}