appiq-solution 1.2.0 → 1.3.1

package/#Tools/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "appiq-solution",
+  "version": "1.3.0",
+  "description": "🚀 APPIQ SOLUTION: Flutter Mobile Development Extension - Eine spezialisierte Erweiterung der BMAD Method für Flutter Mobile App Entwicklung",
+  "main": "tools/cli.js",
+  "bin": {
+    "appiq-solution": "tools/bmad-npx-wrapper.js",
+    "appiq": "tools/bmad-npx-wrapper.js",
+    "bmad": "tools/bmad-npx-wrapper.js",
+    "bmad-method": "tools/bmad-npx-wrapper.js"
+  },
+  "scripts": {
+    "build": "node tools/cli.js build",
+    "build:agents": "node tools/cli.js build --agents-only",
+    "build:teams": "node tools/cli.js build --teams-only",
+    "list:agents": "node tools/cli.js list:agents",
+    "validate": "node tools/cli.js validate",
+    "install:bmad": "node tools/installer/bin/bmad.js install",
+    "format": "prettier --write \"**/*.md\"",
+    "version:patch": "node tools/version-bump.js patch",
+    "version:minor": "node tools/version-bump.js minor",
+    "version:major": "node tools/version-bump.js major",
+    "version:expansion": "node tools/bump-expansion-version.js",
+    "version:expansion:set": "node tools/update-expansion-version.js",
+    "version:all": "node tools/bump-all-versions.js",
+    "version:all:minor": "node tools/bump-all-versions.js minor",
+    "version:all:major": "node tools/bump-all-versions.js major",
+    "version:all:patch": "node tools/bump-all-versions.js patch",
+    "version:expansion:all": "node tools/bump-all-versions.js",
+    "version:expansion:all:minor": "node tools/bump-all-versions.js minor",
+    "version:expansion:all:major": "node tools/bump-all-versions.js major",
+    "version:expansion:all:patch": "node tools/bump-all-versions.js patch",
+    "release": "semantic-release",
+    "release:test": "semantic-release --dry-run --no-ci || echo 'Config test complete - authentication errors are expected locally'",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "@kayvan/markdown-tree-parser": "^1.5.0",
+    "bmad-method": "^4.30.3",
+    "chalk": "^4.1.2",
+    "commander": "^14.0.0",
+    "fs-extra": "^11.3.0",
+    "glob": "^11.0.3",
+    "inquirer": "^8.2.6",
+    "js-yaml": "^4.1.0",
+    "ora": "^5.4.1"
+  },
+  "keywords": [
+    "ai-agents",
+    "development-workflow", 
+    "project-management",
+    "flutter",
+    "mobile-development",
+    "clean-architecture",
+    "cubit",
+    "bloc",
+    "dart",
+    "greenfield",
+    "brownfield",
+    "cursor",
+    "claude-code",
+    "windsurf",
+    "agile",
+    "ai",
+    "orchestrator",
+    "development",
+    "methodology",
+    "agents",
+    "bmad"
+  ],
+  "author": "Brian (BMad) Madison",
+  "license": "MIT",
+  "repository": {
+    "type": "git", 
+    "url": "git+https://github.com/Viktor-Hermann/APPIQ-METHOD.git"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.1",
+    "prettier": "^3.5.3",
+    "semantic-release": "^22.0.0",
+    "yaml-lint": "^1.7.0"
+  },
+  "lint-staged": {
+    "**/*.md": [
+      "prettier --write"
+    ]
+  }
+}

package/README.md

@@ -1,105 +1,139 @@
-# 📱 APPIQ SOLUTION: Flutter Mobile Development Extension
+# BMad-Method: Universal AI Agent Framework
 
-[![Version](https://img.shields.io/npm/v/appiq-solution?color=blue&label=version)](https://www.npmjs.com/package/appiq-solution)
+[![Version](https://img.shields.io/npm/v/bmad-method?color=blue&label=version)](https://www.npmjs.com/package/bmad-method)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
 
-**Eine spezialisierte Erweiterung der BMAD Method für Flutter Mobile App Entwicklung**
+Foundations in Agentic Agile Driven Development, known as the Breakthrough Method of Agile AI-Driven Development, yet so much more. Transform any domain with specialized AI expertise: software development, entertainment, creative writing, business strategy to personal wellness just to name a few.
 
-APPIQ SOLUTION erweitert die bewährte BMAD Method um **erstklassige Flutter-Unterstützung** mit Clean Architecture, Cubit patterns, BLoC state management, dependency injection und modernen Mobile Development Best Practices.
+**[Subscribe to BMadCode on YouTube](https://www.youtube.com/@BMadCode?sub_confirmation=1)**
 
-## 🚀 Installation
+**[Join our Discord Community](https://discord.gg/gk8jAdXWmj)** - A growing community for AI enthusiasts! Get help, share ideas, explore AI agents & frameworks, collaborate on tech projects, enjoy hobbies, and help each other succeed. Whether you're stuck on BMad, building your own agents, or just want to chat about the latest in AI - we're here for you! **Some mobile and VPN may have issue joining the discord, this is a discord issue - if the invite does not work, try from your own internet or another network, or non-VPN.**
 
-**Einfach und schnell:**
+⭐ **If you find this project helpful or useful, please give it a star in the upper right hand corner!** It helps others discover BMad-Method and you will be notified of updates!
+
+## Overview
+
+**BMad Method's Two Key Innovations:**
+
+**1. Agentic Planning:** Dedicated agents (Analyst, PM, Architect) collaborate with you to create detailed, consistent PRDs and Architecture documents. Through advanced prompt engineering and human-in-the-loop refinement, these planning agents produce comprehensive specifications that go far beyond generic AI task generation.
+
+**2. Context-Engineered Development:** The Scrum Master agent then transforms these detailed plans into hyper-detailed development stories that contain everything the Dev agent needs - full context, implementation details, and architectural guidance embedded directly in story files.
+
+This two-phase approach eliminates both **planning inconsistency** and **context loss** - the biggest problems in AI-assisted development. Your Dev agent opens a story file with complete understanding of what to build, how to build it, and why.
+
+**📖 [See the complete workflow in the User Guide](bmad-core/user-guide.md)** - Planning phase, development cycle, and all agent roles
+
+## Quick Navigation
+
+### Understanding the BMad Workflow
+
+**Before diving in, review these critical workflow diagrams that explain how BMad works:**
+
+1. **[Planning Workflow (Web UI)](bmad-core/user-guide.md#the-planning-workflow-web-ui)** - How to create PRD and Architecture documents
+2. **[Core Development Cycle (IDE)](bmad-core/user-guide.md#the-core-development-cycle-ide)** - How SM, Dev, and QA agents collaborate through story files
+
+> ⚠️ **These diagrams explain 90% of BMad Method Agentic Agile flow confusion** - Understanding the PRD+Architecture creation and the SM/Dev/QA workflow and how agents pass notes through story files is essential - and also explains why this is NOT taskmaster or just a simple task runner!
+
+### What would you like to do?
+
+- **[Install and Build software with Full Stack Agile AI Team](#quick-start)** → Quick Start Instruction
+- **[Learn how to use BMad](bmad-core/user-guide.md)** → Complete user guide and walkthrough
+- **[See available AI agents](#available-agents)** → Specialized roles for your team
+- **[Explore non-technical uses](#-beyond-software-development---expansion-packs)** → Creative writing, business, wellness, education
+- **[Create my own AI agents](#creating-your-own-expansion-pack)** → Build agents for your domain
+- **[Browse ready-made expansion packs](expansion-packs/)** → Game dev, DevOps, infrastructure and get inspired with ideas and examples
+- **[Understand the architecture](docs/core-architecture.md)** → Technical deep dive
+- **[Join the community](https://discord.gg/gk8jAdXWmj)** → Get help and share ideas
+
+## Important: Keep Your BMad Installation Updated
+
+**Stay up-to-date effortlessly!** If you already have BMad-Method installed in your project, simply run:
 
 ```bash
-npx appiq-solution install
+npx bmad-method install
+# OR
+git pull
+npm run install:bmad
 ```
 
-**Der Smart Installer konfiguriert:**
-- ✅ **Multi-IDE Support**: Cursor, Claude Code, Windsurf, VS Code + Cline, und mehr
-- ✅ **Auto-detect Tech Stack**: Flutter, React, Vue, Next.js, Angular, Fullstack, API-only
-- ✅ **Smart MCP Integration**: Agents wissen welche MCP Server sie nutzen können (keine Auto-Config)
-- ✅ **Planning Workflow**: Projektidee → Plan-Generierung → Freigabe → Entwicklung
-- ✅ **Full BMAD Flow**: Document sharding, Agent orchestration, Entwicklungszyklus
-- ✅ **🎯 Advanced Flutter Support**: Dart MCP Server integration, Clean Architecture, Cubit patterns, BLoC state management, dependency injection mit GetIt, proper testing strategies
-- ✅ **Modern Web**: shadcn/ui, v0.dev, Tailwind CSS integration
-- ✅ **Security First**: Keine API Keys werden gespeichert oder automatisch konfiguriert
-
-### 🎯 **Verfügbare MCP Server**
-
-Deine Agents kennen diese MCP Server (du konfigurierst sie manuell in deiner IDE):
-
-- **🧠 Sequential Thinking**: Complex problem solving
-- **🌐 Puppeteer**: Browser automation and testing  
-- **🔗 Claude Continuity**: Enhanced thread continuity
-- **💾 Extended Memory**: Enhanced AI memory capabilities
-- **✨ 21st.dev Magic**: UI builder like v0 in your IDE
-- **📱 Dart MCP**: Flutter/Dart development (auto-detected for Flutter projects)
-- **🔥 Firebase**: Auth, Firestore, Functions integration
-- **⚡ Supabase**: Database, auth, storage
-- **📚 Context7**: Up-to-date library documentation
-- **💳 Stripe**: Payment integration
-
-**In deiner IDE (Cursor, Claude, etc.):**
-```
-@smart-launcher
+This will:
+
+- ✅ Automatically detect your existing v4 installation
+- ✅ Update only the files that have changed and add new files
+- ✅ Create `.bak` backup files for any custom modifications you've made
+- ✅ Preserve your project-specific configurations
+
+This makes it easy to benefit from the latest improvements, bug fixes, and new agents without losing your customizations!
+
+## Quick Start
+
+### One Command for Everything (IDE Installation)
+
+**Just run one of these commands:**
+
+```bash
+npx bmad-method install
+# OR if you already have BMad installed:
+git pull
+npm run install:bmad
 ```
 
-## 📱 Flutter Features
+This single command handles:
+
+- **New installations** - Sets up BMad in your project
+- **Upgrades** - Updates existing installations automatically
+- **Expansion packs** - Installs any expansion packs you've added to package.json
 
-- **🏗️ Clean Architecture**: Domain-driven Design, saubere Layer-Trennung
-- **🔄 State Management**: Cubit patterns, BLoC integration
-- **🛠️ Best Practices**: GetIt dependency injection, null safety
-- **🎨 Material 3**: Moderne UI components, theming
-- **🧪 Testing**: Unit-, Widget- und Integration-Tests
-- **📦 Package Management**: Kuratierte Package-Empfehlungen
+> **That's it!** Whether you're installing for the first time, upgrading, or adding expansion packs - these commands do everything.
 
-## 🗂️ Codebase Context Management
+**Prerequisites**: [Node.js](https://nodejs.org) v20+ required
 
-**Automatischer Context Export nach jedem Feature/Milestone:**
+### Fastest Start: Web UI Full Stack Team at your disposal (2 minutes)
+
+1. **Get the bundle**: Save or clone the [full stack team file](dist/teams/team-fullstack.txt) or choose another team
+2. **Create AI agent**: Create a new Gemini Gem or CustomGPT
+3. **Upload & configure**: Upload the file and set instructions: "Your critical operating instructions are attached, do not break character as directed"
+4. **Start Ideating and Planning**: Start chatting! Type `*help` to see available commands or pick an agent like `*analyst` to start right in on creating a brief.
+5. **CRITICAL**: Talk to BMad Orchestrator in the web at ANY TIME (#bmad-orchestrator command) and ask it questions about how this all works!
+6. **When to move to the IDE**: Once you have your PRD, Architecture, optional UX and Briefs - its time to switch over to the IDE to shard your docs, and start implementing the actual code! See the [User guide](bmad-core/user-guide.md) for more details
+
+### Alternative: Clone and Build
 
 ```bash
-# Manuell ausführen
-npx bmad-method flatten
-
-# Mit custom Output (für AI-Agents)
-npx bmad-method flatten --output context/current-codebase.xml
-
-# Automatisch in package.json scripts:
-{
-  "scripts": {
-    "flatten": "npx bmad-method flatten --output context/milestone-$(date +%Y%m%d).xml",
-    "posttest": "npm run flatten",
-    "postbuild": "npm run flatten"
-  }
-}
+git clone https://github.com/bmadcode/bmad-method.git
+npm run install:bmad # build and install all to a destination folder
 ```
 
-**Wo wird es gespeichert:**
-- **Standard**: `flattened-codebase.xml` im aktuellen Verzeichnis
-- **Custom**: Beliebiger Pfad mit `--output` Parameter
-- **Empfehlung**: `context/` Ordner für bessere Organisation
+## 🌟 Beyond Software Development - Expansion Packs
 
-**Nutzen für Flutter-Entwicklung:**
-- ✅ AI Agents haben immer aktuellen Codebase-Context
-- ✅ Perfekt für Code Reviews und Architektur-Diskussionen
-- ✅ Einfacher Knowledge Transfer zwischen Team-Mitgliedern
+BMad's natural language framework works in ANY domain. Expansion packs provide specialized AI agents for creative writing, business strategy, health & wellness, education, and more. Also expansion packs can expand the core BMad-Method with specific functionality that is not generic for all cases. [See the Expansion Packs Guide](docs/expansion-packs.md) and learn to create your own!
 
-## 📚 Dokumentation
+## Documentation & Resources
 
-- 📖 **[User Guide](bmad-core/user-guide.md)** - Komplette Anleitung zur Flutter-Entwicklung mit AI Agents
-- 📱 **[Flutter Expansion Pack](expansion-packs/bmad-flutter-mobile-dev/)** - Spezialisierte Flutter Agents und Templates
+### Essential Guides
+
+- 📖 **[User Guide](bmad-core/user-guide.md)** - Complete walkthrough from project inception to completion
+- 🏗️ **[Core Architecture](docs/core-architecture.md)** - Technical deep dive and system design
+- 🚀 **[Expansion Packs Guide](docs/expansion-packs.md)** - Extend BMad to any domain beyond software development
 
 ## Support
 
 - 💬 [Discord Community](https://discord.gg/gk8jAdXWmj)
 - 🐛 [Issue Tracker](https://github.com/bmadcode/bmad-method/issues)
 - 💬 [Discussions](https://github.com/bmadcode/bmad-method/discussions)
-- 💖 [![Support the Project via PayPal](https://becomingdeutsch.wordpress.com/wp-content/uploads/2019/08/buy-me-a-coffee-with-paypal.png)](https://www.paypal.com/paypalme/vhermann)
+
+## Contributing
+
+**We're excited about contributions and welcome your ideas, improvements, and expansion packs!** 🎉
+
+📋 **[Read CONTRIBUTING.md](CONTRIBUTING.md)** - Complete guide to contributing, including guidelines, process, and requirements
 
 ## License
 
 MIT License - see [LICENSE](LICENSE) for details.
 
-<sub>Built with ❤️ for Flutter developers and the AI-assisted development community</sub>
+[![Contributors](https://contrib.rocks/image?repo=bmadcode/bmad-method)](https://github.com/bmadcode/bmad-method/graphs/contributors)
+
+<sub>Built with ❤️ for the AI-assisted development community</sub>

package/SuperClaude/.claude/commands/analyze.md

@@ -0,0 +1,36 @@
+@include shared/constants.yml#Process_Symbols
+
+@include shared/command-templates.yml#Command_Header
+
+Multi-dimensional analysis on code, arch, or problem in $ARGUMENTS.
+
+@include shared/command-templates.yml#Universal_Flags
+@see shared/thinking-modes.yml ∀ thinking flags
+@see shared/mcp-flags.yml ∀ MCP controls
+
+Examples:
+- `/user:analyze --code --think` - Code review w/ context
+- `/user:analyze --arch --think-hard` - Deep arch analysis  
+- `/user:analyze --security --ultrathink` - Comprehensive security audit
+
+Analysis modes:
+
+**--code:** Quality review→naming, structure, DRY, complexity | Bugs→null checks, boundaries, types | Security→injection, auth, validation | Perf→O(n²), N+1, memory
+
+**--arch:** System design & patterns | Layer coupling | Scalability bottlenecks | Maintainability assessment | Improvement suggestions
+
+**--profile:** CPU, memory, execution time | Network latency, DB queries | Frontend metrics | Bottleneck identification | Optimization recommendations  
+
+**--security:** OWASP top 10 | Auth & authorization | Data handling & encryption | Attack vector identification
+
+**--perf:** Bottleneck analysis | Algorithm complexity | DB queries & indexes | Caching strategies | Resource utilization
+
+**--watch:** Continuous file monitoring | Real-time quality tracking | Auto re-analysis | Live metrics
+
+**--interactive:** Guided exploration | Step-by-step fixes | Live improvement
+
+@include shared/command-templates.yml#Research_Requirements
+
+@include shared/command-templates.yml#Report_Output
+
+Deliverables: @include shared/constants.yml#Success_Messages

package/SuperClaude/.claude/commands/build.md

@@ -0,0 +1,35 @@
+@include shared/constants.yml#Process_Symbols
+
+@include shared/command-templates.yml#Command_Header
+
+Build project/feature based on req in $ARGUMENTS.
+
+@include shared/command-templates.yml#Universal_Flags
+@see shared/mcp-flags.yml ∀ MCP controls
+
+Examples:
+- `/user:build --react --magic` - React app w/ UI gen
+- `/user:build --api --c7` - API w/ docs
+- `/user:build --react --magic --pup` - Build & test UI
+
+Pre-build: Remove artifacts (dist/, build/, .next/) | Clean temp files & cache | Validate deps | Remove debug
+
+Build modes:
+**--init:** New project w/ stack (React|API|Fullstack|Mobile|CLI) | TS default | Testing setup | Git workflow
+**--feature:** Impl feature→existing patterns | Maintain consistency | Include tests  
+**--tdd:** Write failing tests→minimal code→pass tests→refactor
+
+Templates:
+- **React:** Vite|TS|Router|state mgmt|testing
+- **API:** Express|TS|auth|validation|OpenAPI  
+- **Fullstack:** React+Node.js+Docker
+- **Mobile:** React Native+Expo
+- **CLI:** Commander.js+cfg+testing
+
+**--watch:** Continuous build | Real-time feedback | Incremental | Live reload
+**--interactive:** Step-by-step cfg | Interactive deps | Build customization
+
+@include shared/command-templates.yml#Research_Requirements
+@include shared/execution-lifecycle.yml#Standard_Lifecycle
+
+Deliverables: @include shared/constants.yml#Success_Messages

package/SuperClaude/.claude/commands/cleanup.md

@@ -0,0 +1,46 @@
+@include shared/constants.yml#Process_Symbols
+
+@include shared/command-templates.yml#Universal_Flags
+
+Clean up project artifacts, code & cfg specified in $ARGUMENTS.
+
+--code flag:
+- Remove unused imports & dead code | Clean console.log & debug code
+- Remove commented blocks | Fix style inconsistencies | Remove TODO>30 days
+
+--files flag:
+- Remove build artifacts & temp files | Clean node_modules if corrupted
+- Remove logs & cache dirs | Clean test outputs | Remove OS files (.DS_Store, thumbs.db)
+
+--deps flag:
+- Remove unused deps from package.json | Update vulnerable deps
+- Clean duplicate deps | Optimize dep tree | Check outdated packages
+
+--git flag:
+- Remove untracked files (w/ confirmation) | Clean merged branches
+- Remove large/unwanted files from history | Optimize git (.git/objects cleanup) | Clean stale refs
+
+--cfg flag:
+- Remove deprecated cfg settings | Clean unused env vars
+- Update outdated cfg formats | Validate cfg consistency | Remove duplicate entries
+
+--all flag:
+- Comprehensive cleanup all areas | Generate detailed report
+- Suggest maintenance schedule | Provide perf impact analysis
+
+--dry-run flag:
+- Show what would be cleaned w/o changes | Estimate space savings & perf impact | ID risks before cleanup
+
+--watch flag:
+- Monitor & auto-clean new artifacts | Continuous cleanup during dev | Prevent temp file accumulation | Real-time maintenance
+
+## Integration & Best Practices
+
+@include shared/command-templates.yml#Research_Requirements
+
+@include shared/command-templates.yml#Report_Output
+- Space savings: `.claudedocs/metrics/cleanup-savings-<timestamp>.md`
+- Ensure dirs: `mkdir -p .claudedocs/reports/ .claudedocs/metrics/`
+- Include location: "📄 Cleanup report saved to: [path]"
+
+Deliverables: Cleanup report w/ space saved, perf improvements, maintenance recommendations, safety analysis & cleanup strategy docs.

package/SuperClaude/.claude/commands/deploy.md

@@ -0,0 +1,55 @@
+@include shared/constants.yml#Process_Symbols
+
+@include shared/command-templates.yml#Universal_Flags
+
+Deploy application to env specified in $ARGUMENTS.
+
+Thinking flags (optional):
+- --think→multi-service deployment coordination
+- --think-hard→complex infrastructure & rollback planning
+- --ultrathink→complete deployment architecture & disaster recovery
+
+Examples:
+- `/user:deploy --env staging --think` - Staging w/ coordination analysis
+- `/user:deploy --env prod --think-hard` - Prod w/ comprehensive planning
+- `/user:deploy --rollback --ultrathink` - Critical rollback w/ full impact analysis
+
+Pre-deploy cleanup:
+- Clean previous artifacts | Remove dev-only files (.env.local, debug cfgs)
+- Validate prod cfg (no debug flags, correct URLs) | Clean old versions→free space
+
+--env flag:
+- dev: Deploy→dev env for testing | staging: Deploy→staging for pre-prod validation
+- prod: Deploy→prod w/ all safety checks
+
+--rollback flag:
+- Revert→previous stable deployment | Maintain deployment history→audit trail
+- Verify rollback success w/ health checks
+
+Deployment workflow:
+1. Validate→Check prerequisites & cfg 2. Build→Create artifacts 3. Test→Run smoke tests
+4. Deploy→Execute strategy 5. Verify→Confirm health & functionality
+
+Deployment strategies:
+- Blue-green: Two envs, switch traffic→zero downtime | Canary: Gradual rollout→% users
+- Rolling: Update instances sequentially w/ health checks
+
+Pre-deployment checks:
+- Verify tests pass | Check deployment cfg | Ensure rollback plan exists
+- Validate env vars | Confirm DB migrations completed
+
+Post-deployment:
+- Run health checks & smoke tests | Monitor error rates & perf
+- Check critical user journeys | Verify logging & monitoring | Ready→rollback if issues
+
+## Safety & Best Practices
+
+Safety:
+- Always have rollback plan | Backups before deployment
+- Monitor key metrics during deployment | Gradual rollout→major changes
+
+@include shared/command-templates.yml#Research_Requirements
+
+@include shared/command-templates.yml#Report_Output
+
+@include shared/constants.yml#Success_Messages

package/SuperClaude/.claude/commands/design.md

@@ -0,0 +1,91 @@
+@include shared/constants.yml#Process_Symbols
+
+@include shared/command-templates.yml#Universal_Flags
+
+Design & architect software solutions based on requirements in $ARGUMENTS.
+
+Thinking flags (optional):
+- --think→standard design patterns & component architecture
+- --think-hard→system-wide architecture & scalability planning
+- --ultrathink→complete system redesign or critical architectural decisions
+
+Examples:
+- `/user:design --api --think` - REST API design w/ patterns
+- `/user:design --ddd --think-hard` - Deep domain modeling
+- `/user:design --api --ddd --ultrathink` - Complete system architecture
+
+Design focus w/ flags:
+
+--api flag:
+- Design REST or GraphQL APIs
+- w/ --openapi: Generate OpenAPI 3.0 spec | w/ --graphql: Create GraphQL schema & resolvers
+- Include auth, rate limiting & error handling | Design→scalability & maintainability
+
+--ddd flag:
+- Apply DDD principles | w/ --bounded-context: Define context boundaries & mappings
+- Design entities, value objects & aggregates | Create domain services & events | Impl repository patterns
+
+--prd flag:
+- Create PRD | w/ --template: Use template (feature/api/integration/migration)
+- Include user stories w/ acceptance criteria | Define success metrics & timelines | Document tech requirements
+
+## API Design Mode (--api)
+
+REST API principles:
+- Resource-oriented URLs w/ proper HTTP verbs | Consistent status codes & error formats
+- Versioning strategy (URL/header/accept) | Pagination, filtering & sorting | HATEOAS→discoverability | OpenAPI docs
+
+GraphQL principles:
+- Clear type system w/ schemas | Efficient queries & mutations | Real-time subscriptions where needed
+- DataLoader patterns→N+1 prevention | Field-level auth | Error handling practices
+
+Common API elements:
+- Auth (JWT/OAuth/API keys) | Rate limiting & throttling | Request/response validation
+- Caching strategies | CORS & security headers | Monitoring & logging
+
+## DDD Mode (--ddd)
+
+Building blocks:
+- **Entities**: Objects w/ unique identity | **Value Objects**: Immutable objects by attributes
+- **Aggregates**: Consistency boundaries w/ roots | **Domain Services**: Business logic not in entities
+- **Repositories**: Abstract data access | **Domain Events**: Capture business events
+
+Strategic patterns:
+- Bounded contexts w/ clear boundaries | Context mapping (shared kernel, anti-corruption layer)
+- Ubiquitous language within contexts | Event-driven architecture | CQRS where appropriate
+
+Structure:
+```
+domain/          # Core business logic
+application/     # Use cases & orchestration  
+infrastructure/  # External concerns
+presentation/    # UI/API layer
+```
+
+## PRD Mode (--prd)
+
+Structure:
+1. **Executive Overview**: Problem statement & solution | Expected impact & ROI | Key stakeholders
+2. **Goals & Success Metrics**: Primary objectives (must-have) | Secondary goals (nice-to-have) | KPIs & measurement
+3. **User Stories & Requirements**: User personas & journeys | Functional requirements | Non-functional requirements | Acceptance criteria
+4. **Technical Specs**: Architecture overview | Tech choices | Integration points | Security requirements | Perf targets  
+5. **Timeline & Risks**: Dev phases | Dependencies & blockers | Risk mitigation strategies
+
+## Integration
+
+Combined modes:
+- API+DDD: Design domain-driven APIs | API+PRD: Create API product requirements
+- DDD+PRD: Document domain-driven architecture | All three: Complete system design
+
+Best practices:
+- Start w/ user needs & business goals | Design→change & evolution | Consider non-functional early
+- Document decisions & rationale | Include examples & diagrams | Plan→testing & monitoring
+
+Research requirements:
+- Architecture patterns→C7 & industry practices | API standards→reference OpenAPI/REST/GraphQL specs
+- DDD patterns→verify w/ Evans' book or official DDD | Tech choices→WebSearch recent comparisons & case studies
+- Never design on assumptions - verify patterns | All decisions cite authoritative sources
+
+Deliverables:
+- API: Complete spec, impl guide, docs | DDD: Domain model, bounded contexts, architecture diagrams, code structure
+- PRD: Requirements doc, user stories, success metrics, timeline

package/SuperClaude/.claude/commands/dev-setup.md

@@ -0,0 +1,37 @@
+@include shared/constants.yml#Process_Symbols
+
+@include shared/command-templates.yml#Universal_Flags
+
+Setup comprehensive dev env or CI/CD pipeline based on $ARGUMENTS.
+
+Thinking flags (optional):
+- --think→multi-tool env coordination
+- --think-hard→complex CI/CD pipeline architecture  
+- --ultrathink→enterprise dev infrastructure design
+
+Examples:
+- `/user:dev-setup --install --think` - Tool installation w/ dependency analysis
+- `/user:dev-setup --ci --think-hard` - CI/CD pipeline w/ comprehensive workflow design
+- `/user:dev-setup --monitor --ultrathink` - Complete observability infrastructure
+
+--install flag:
+- Install & cfg dev tools (Node.js, Git, Docker, DBs) | Setup IDE cfgs→consistent dev experience
+- Create npm scripts→common tasks | Cfg pre-commit hooks→code quality | Setup linting & testing frameworks
+
+--ci flag:
+- Cfg CI/CD pipelines (GitHub Actions, GitLab CI, other platforms) | Setup build, test & deployment stages
+- Cfg envs: dev, staging & prod | Add security scanning & dep checking | Setup deployment automation
+
+--monitor flag:
+- Cfg observability tools | Setup logging & monitoring | Add perf tracking
+- Cfg error reporting | Setup alerts→critical issues
+
+## Best Practices & Security
+
+Ensure all cfgs follow security practices & include comprehensive docs.
+
+@include shared/command-templates.yml#Research_Requirements
+
+@include shared/command-templates.yml#Report_Output
+
+@include shared/constants.yml#Success_Messages