start-vibing-stacks 1.0.0

package/stacks/php/stack.json

@@ -0,0 +1,95 @@
+{
+  "id": "php",
+  "name": "PHP",
+  "icon": "🐘",
+  "runtime": "PHP 8.3+",
+  "minVersion": "8.3.0",
+  "packageManager": "composer",
+  "extensions": [".php", ".blade.php", ".twig", ".phtml"],
+  "testExtensions": ["*Test.php", "*_test.php"],
+  "detectFiles": ["composer.json", "index.php", "artisan", "public/index.php"],
+  "commands": {
+    "test": "vendor/bin/phpunit",
+    "lint": "vendor/bin/phpstan analyse --level=6",
+    "format": "vendor/bin/php-cs-fixer fix",
+    "serve": "php -S localhost:8000 -t public/",
+    "build": null
+  },
+  "qualityGates": [
+    { "name": "PHPStan", "command": "vendor/bin/phpstan analyse --level=6", "required": true, "order": 1 },
+    { "name": "PHPUnit", "command": "vendor/bin/phpunit", "required": true, "order": 2 },
+    { "name": "CS Fixer", "command": "vendor/bin/php-cs-fixer fix --dry-run --diff", "required": false, "order": 3 }
+  ],
+  "frameworks": [
+    { "id": "laravel", "name": "Laravel", "icon": "🏗️", "detectFiles": ["artisan", "bootstrap/app.php"] },
+    { "id": "laravel-octane", "name": "Laravel + Octane (RoadRunner)", "icon": "🚀", "detectFiles": ["artisan", "rr.yaml"] },
+    { "id": "symfony", "name": "Symfony", "icon": "🎵", "detectFiles": ["symfony.lock"] },
+    { "id": "codeigniter", "name": "CodeIgniter", "icon": "🧩", "detectFiles": ["spark"] },
+    { "id": "vanilla", "name": "Vanilla PHP", "icon": "📄" }
+  ],
+  "databases": [
+    { "id": "mysql", "name": "MySQL / MariaDB", "icon": "🐬" },
+    { "id": "postgresql", "name": "PostgreSQL", "icon": "🐘" },
+    { "id": "mongodb", "name": "MongoDB", "icon": "🍃" },
+    { "id": "sqlite", "name": "SQLite", "icon": "📁" },
+    { "id": "none", "name": "None", "icon": "❌" }
+  ],
+  "frontendOptions": [
+    { "id": "react-tailwind", "name": "ReactJS 19+ / TailwindCSS 4+", "icon": "⚛️" },
+    { "id": "tailwind-vanilla", "name": "TailwindCSS 4+ / Vanilla JS", "icon": "🎨" },
+    { "id": "blade", "name": "Blade Templates (Laravel)", "icon": "🖼️" },
+    { "id": "livewire", "name": "Livewire + Alpine.js", "icon": "⚡" },
+    { "id": "twig", "name": "Twig Templates (Symfony)", "icon": "🌿" },
+    { "id": "none", "name": "API only — no frontend", "icon": "❌" }
+  ],
+  "deployTargets": [
+    { "id": "shared-hosting", "name": "Shared Hosting (FTP)", "icon": "🌐" },
+    { "id": "docker", "name": "Docker", "icon": "🐳" },
+    { "id": "vps-ssh", "name": "VPS (SSH)", "icon": "☁️" },
+    { "id": "cpanel", "name": "cPanel", "icon": "📦" },
+    { "id": "forge", "name": "Laravel Forge", "icon": "🔨" },
+    { "id": "vapor", "name": "Laravel Vapor (AWS)", "icon": "☁️" }
+  ],
+  "skills": [
+    "php-patterns",
+    "phpunit-testing",
+    "phpstan-analysis",
+    "composer-workflow",
+    "security-scan-php"
+  ],
+  "requirements": [
+    {
+      "name": "PHP",
+      "command": "php",
+      "versionFlag": "-v",
+      "minVersion": "8.3.0",
+      "installCommand": {
+        "macos": "brew install php@8.3",
+        "linux": "sudo apt install -y php8.3-cli php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip"
+      },
+      "versionRegex": "PHP\\s+(\\d+\\.\\d+\\.\\d+)"
+    },
+    {
+      "name": "Composer",
+      "command": "composer",
+      "versionFlag": "--version",
+      "minVersion": "2.0.0",
+      "installCommand": {
+        "macos": "brew install composer",
+        "linux": "curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer"
+      },
+      "versionRegex": "(\\d+\\.\\d+\\.\\d+)"
+    },
+    {
+      "name": "Node.js",
+      "command": "node",
+      "versionFlag": "--version",
+      "minVersion": "18.0.0",
+      "installCommand": {
+        "macos": "brew install node",
+        "linux": "curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt install -y nodejs"
+      },
+      "versionRegex": "v?(\\d+\\.\\d+\\.\\d+)"
+    }
+  ]
+}

package/templates/CLAUDE-default.md

@@ -0,0 +1,54 @@
+# {{PROJECT_NAME}}
+
+## Last Change
+
+**Branch:** main
+**Date:** {{DATE}}
+**Summary:** Initial project setup with start-vibing-stacks
+
+## 30 Seconds Overview
+
+{{PROJECT_NAME}} is a {{STACK}} project using {{FRAMEWORK}} framework.
+
+## Stack
+
+| Component | Technology |
+|-----------|------------|
+| Stack | {{STACK}} |
+| Framework | {{FRAMEWORK}} |
+| Database | {{DATABASE}} |
+
+## Architecture
+
+```
+project/
+├── src/           # Source code
+├── tests/         # Tests
+├── public/        # Public assets
+├── .claude/       # AI agent configuration
+│   ├── agents/    # Specialized agents
+│   ├── skills/    # Knowledge base
+│   ├── hooks/     # Validation hooks
+│   └── config/    # Project configuration
+└── CLAUDE.md      # This file
+```
+
+## Critical Rules
+
+- Follow stack-specific patterns in `.claude/skills/`
+- Run quality gates before every commit
+- Document all changes in domain files
+- Use conventional commits
+
+## FORBIDDEN
+
+| Action | Reason |
+|--------|--------|
+| Skip tests | Quality gate will block |
+| Direct commits to main | Use feature branches |
+| Ignore type errors | PHPStan/TypeScript must pass |
+| Hardcode secrets | Use environment variables |
+
+## Quality Gates
+
+Read `.claude/config/active-project.json` for stack-specific commands.

package/templates/CLAUDE-php.md

@@ -0,0 +1,88 @@
+# {{PROJECT_NAME}}
+
+## Last Change
+
+**Branch:** main
+**Date:** {{DATE}}
+**Summary:** Initial project setup with start-vibing-stacks (PHP)
+
+## 30 Seconds Overview
+
+{{PROJECT_NAME}} is a PHP 8.3+ project using {{FRAMEWORK}}.
+
+## Stack
+
+| Component | Technology |
+|-----------|------------|
+| Language | PHP >= 8.3 |
+| Framework | {{FRAMEWORK}} |
+| Database | {{DATABASE}} |
+| Package Manager | Composer |
+| Static Analysis | PHPStan (level 6) |
+| Testing | PHPUnit |
+| Code Style | PHP-CS-Fixer (PSR-12) |
+
+## Architecture
+
+```
+project/
+├── src/              # Application source (PSR-4: App\)
+├── public/           # Web root (index.php)
+├── config/           # Configuration files
+├── tests/
+│   ├── Unit/         # PHPUnit unit tests
+│   └── Feature/      # Feature/integration tests
+├── storage/          # Logs, cache, uploads
+├── .claude/          # AI agent configuration
+├── composer.json     # Dependencies
+├── phpstan.neon      # Static analysis config
+└── CLAUDE.md         # This file
+```
+
+## Critical Rules
+
+- **PHP >= 8.3** — use modern features (readonly, enums, typed constants)
+- **`declare(strict_types=1)`** in EVERY PHP file
+- **PSR-4 autoloading** — no manual includes
+- **Prepared statements** — NEVER concatenate SQL
+- **Type everything** — properties, params, returns
+- **htmlspecialchars()** — all user output
+- **password_hash/verify** — NEVER md5/sha1
+
+## FORBIDDEN
+
+| Action | Reason |
+|--------|--------|
+| `eval()` | Remote code execution risk |
+| `mysql_*` functions | Deprecated, use PDO |
+| `extract($_POST)` | Variable injection |
+| `include $_GET[...]` | Local file inclusion |
+| SQL without prepared statements | SQL injection |
+| `echo $userInput` without escape | XSS |
+| `md5($password)` | Weak hashing |
+| PHP < 8.3 syntax | Version requirement |
+
+## Quality Gates
+
+```bash
+vendor/bin/phpstan analyse --level=6   # Static analysis
+vendor/bin/phpunit                      # Tests
+vendor/bin/php-cs-fixer fix --dry-run   # Code style
+```
+
+## HTTP Requests
+
+All database queries MUST use prepared statements:
+
+```php
+$stmt = $pdo->prepare("SELECT * FROM users WHERE id = :id");
+$stmt->execute([':id' => $userId]);
+```
+
+## Workflow
+
+1. Create feature branch
+2. Implement with types, strict mode
+3. Run PHPStan + PHPUnit
+4. Update domains & CLAUDE.md
+5. Commit → merge to main