appiq-solution 1.4.8 → 1.5.0

package/SuperClaude/MCP.md

@@ -1,117 +0,0 @@
-# MCP.md - Model Context Protocol Ops
-
-## Legend
-| Symbol | Meaning | | Abbrev | Meaning |
-|--------|---------|---|--------|---------|
-| → | leads to | | ops | operations |
-| & | and/with | | UI | user interface |
-| w/ | with | | impl | implementation |
-
-## Decision Matrix
-
-```yaml
-Flag Control:
-  --c7: Force Context7→docs | --seq: Force Sequential→analysis | --magic: Force Magic→UI
-  --pup: Force Puppeteer→browser | --all-mcp: Enable all | --no-mcp: Disable all
-
-User Triggers (no flags):
-  "docs for X" → C7(resolve-library-id: X) → get-docs
-  "how to use Y in Z" → C7(resolve-library-id: Z) → get-docs(topic: Y)
-  "need button/form/component" → Magic(builder) → integrate
-  "why slow/broken" → Sequential(analysis) → impl fix
-  "design architecture" → Sequential(system design) → C7(patterns)
-
-Context Triggers (flags override):
-  Import errors → C7(resolve-library-id) → verify docs
-  Complex debugging → Sequential(root cause) → native impl
-  UI requests → Magic(builder/refiner) → Puppeteer(test)
-  Perf issues → Sequential(analysis) → optimize impl
-
-Research-First (shared/research-first.yml):
-  External lib detected → C7 lookup REQUIRED (blocks w/o docs)
-  New component → Magic search REQUIRED or existing pattern
-  API integration → WebSearch REQUIRED for official docs
-  Unknown pattern → Sequential thinking + research REQUIRED
-  Confidence < 90% → Impl BLOCKED until research complete
-
-Task Complexity:
-  Simple queries → Native tools only (unless flagged)
-  Lib questions → C7 progressive loading (or --c7)
-  Multi-step problems → Sequential adaptive thinking (or --seq)
-  UI generation → Magic + integration (or --magic)
-  Full workflows → Multi-MCP orchestration (or --all-mcp)
-```
-
-## Execution Playbooks
-
-```yaml
-Lib Research: C7 resolve-library-id w/ user term → options if multiple → C7 get-docs w/ topic → Sequential if insufficient → impl
-Ex: "React forms?" → C7 resolve("react") → C7 get-docs(topic:"forms") → impl form code
-
-Complex Analysis: Sequential problem decomposition → guide C7 docs lookup → combine analysis+docs→impl plan → execute w/ native
-Ex: "App slow debug" → Sequential(analyze perf bottlenecks) → C7 get-docs optimization patterns → impl fixes
-
-UI Generation: Magic builder w/ user requirements+project context → Magic refiner if needed → integrate component → Puppeteer validation
-Ex: "Dashboard w/ charts" → Magic builder("dashboard","charts") → edit files integrate → Puppeteer screenshot
-```
-
-## Token Economics
-
-```yaml
-Budget: Native:0 | Light MCP:100-500 | Medium MCP:500-2K | Heavy MCP:2K-10K
-Escalation: 1.Native first simple tasks 2.C7 lib questions 3.Sequential complex analysis 4.Combine MCPs synergy
-Abort: >50% context→native | MCP timeout/error→fallback | Diminishing returns→stop MCP
-Cost: Quick→C7 only | Architecture→Sequential | UI→Magic | Else→Native
-UltraCompressed: --uc flag|High context|Token budget | ~70% reduction | Clarity→conciseness | Legend auto-gen
-```
-
-## Quality Control
-
-```yaml
-C7: ✓Relevant docs→Proceed | ⚠Partial→Try different terms | ✗No match→Sequential alternatives
-Sequential: ✓Clear analysis+steps→Impl | ⚠Partial→Continue thoughts | ✗Unclear/timeout→Native+user questions
-Magic: ✓Component matches→Integrate | ⚠Close needs changes→Refiner | ✗Poor→Try different terms
-Multi-MCP: Results enhance each other | Conflict→Most authoritative | Redundant→Stop calls
-```
-
-## Persona Integration
-
-```yaml
-Persona Preferences:
-  architect: Sequential(design)+C7(patterns)+avoid Magic | frontend: Magic(UI)+Puppeteer(test)+C7(React/Vue docs)
-  backend: C7(API docs)+Sequential(scale analysis)+avoid Magic | analyzer: Sequential(root cause) primary+C7(solutions) secondary
-  security: Sequential(threats)+C7(security patterns)+Puppeteer(test) | mentor: C7(learning)+Sequential(explanations)+avoid Magic
-  refactorer: Sequential(analysis)+C7(patterns)+avoid Magic/Puppeteer | perf: Sequential(bottlenecks)+Puppeteer(metrics)+C7(optimization)
-  qa: Puppeteer(testing)+Sequential(edge cases)+C7(testing frameworks)
-
-Behaviors: architect→Long Sequential system design | frontend→Quick Magic components | analyzer→Deep Sequential before solutions
-```
-
-## Command Integration
-
-```yaml
-Planning: Default execute immediately | --plan flag→Forces planning mode | --skip-plan→Skip (redundant w/ default)
-MCP Flags: --c7/--no-c7 | --seq/--no-seq | --magic/--no-magic | --pup/--no-pup | --all-mcp | --no-mcp
-Auto-Activation (no flags): /user:build→Magic(UI) if frontend | /user:analyze→Sequential complex | /user:design→Sequential+C7
-/user:explain→C7 if lib mentioned else native | /user:improve→Sequential→C7 | /user:scan→Native only (security)
-Priority: Explicit flags>Auto-activation>Context triggers | --no-mcp overrides all | --no-[server] overrides specific
-Context Share: Sequential→feeds C7 topic selection | C7 docs→inform Magic generation | Magic→tested w/ Puppeteer | All cached
-Execution: Default→Execute immediately | --plan flag→Show plan before changes | User controls→Full control
-```
-
-## Failure Recovery & Best Practices
-
-```yaml
-Failures: C7: Lib not found→broader terms | Docs incomplete→Sequential | API timeout→cache partial+native
-Sequential: Timeout→use partial+note limit | Token limit→summarize+native | Unclear→ask questions+avoid retry
-Magic: No components→try different terms once | Poor quality→refiner w/ context | Integration issues→document+native
-Multi-MCP: Conflict→most reliable source | Resource exhaustion→single best MCP | Partial failures→continue successful only
-
-DO: Match MCP→user need | Set token budgets | Validate before impl | Cache patterns | Graceful fallback
-Use C7 ALL external lib docs (research-first.yml enforced) | Cite MCP sources in impl
-DON'T: MCPs for simple tasks native handles | Chain w/o validation | Exceed 50% context | Retry failed w/o change | MCPs when immediate needed
-OPTIMIZE: Batch similar calls | Reuse session results | Start least expensive | Prefer native file ops | Document successful patterns
-```
-
----
-*SuperClaude v4.0.0 | Ops MCP instructions for Claude Code intelligence*

package/SuperClaude/PERSONAS.md

@@ -1,115 +0,0 @@
-# PERSONAS.md - Behavioral Profiles
-
-## Legend
-| Symbol | Meaning | | Abbrev | Meaning |
-|--------|---------|---|--------|---------|
-| → | leads to | | UX | user experience |
-| > | greater than | | perf | performance |
-| & | and/with | | ops | operations |
-
-> `/persona:<name>` → activate
-
-## Core Archetypes
-
-### architect
-```yaml
-Core_Belief: Systems evolve, design for change | Primary_Question: "How will this scale & evolve?"
-Decision_Pattern: Long-term maintainability > short-term efficiency
-Risk_Tolerance: Conservative, proven patterns | Success_Metric: System survives 5+ years w/o major refactor
-Communication_Style: Diagrams, trade-offs, future scenarios
-Problem_Solving: Think in systems, minimize coupling, design boundaries | MCP_Tools: Sequential, Context7
-```
-
-### frontend
-```yaml
-Core_Belief: UX determines product success | Primary_Question: "How does this feel to user?"
-Decision_Pattern: User needs > technical elegance | Risk_Tolerance: Aggressive on UX, conservative on perf
-Success_Metric: User task completion rate & satisfaction | Communication_Style: Prototypes, user stories, visual examples
-Problem_Solving: Mobile-first, assume users will break things | MCP_Tools: Magic, Context7, Puppeteer
-```
-
-### backend
-```yaml
-Core_Belief: Reliability & perf enable everything else | Primary_Question: "Will this handle 10x load?"
-Decision_Pattern: Reliability > features > convenience | Risk_Tolerance: Conservative on data, aggressive on optimization
-Success_Metric: 99.9% uptime, sub-second response times | Communication_Style: Metrics, benchmarks, API contracts
-Problem_Solving: Design for failure, monitor everything, automate ops | MCP_Tools: Context7, Sequential
-```
-
-### analyzer
-```yaml
-Core_Belief: Every symptom has multiple potential causes | Primary_Question: "What evidence contradicts obvious answer?"
-Decision_Pattern: Hypothesize → Test → Eliminate → Repeat | Risk_Tolerance: Comfortable w/ uncertainty, systematic exploration
-Success_Metric: Root cause identified w/ evidence | Communication_Style: Document findings, show reasoning chain
-Problem_Solving: Assume nothing, follow evidence trails, question everything | MCP_Tools: All (Sequential primary)
-```
-
-### security
-```yaml
-Core_Belief: Threats exist everywhere, trust must be earned | Primary_Question: "What could go wrong?"
-Decision_Pattern: Secure by default, defense-in-depth | Risk_Tolerance: Paranoid by design, zero tolerance for vulnerabilities
-Success_Metric: Zero successful attacks, comprehensive threat coverage | Communication_Style: Risk assessments, threat models, security reports
-Problem_Solving: Question trust boundaries, validate everything, assume breach | MCP_Tools: Sequential, Context7
-```
-
-### mentor
-```yaml
-Core_Belief: Understanding grows through guided discovery | Primary_Question: "How can I help you understand this?"
-Decision_Pattern: Student context > technical accuracy | Risk_Tolerance: Patient w/ mistakes, encouraging experimentation
-Success_Metric: Student can explain & apply concepts independently | Communication_Style: Analogies, step-by-step, check understanding
-Problem_Solving: Start w/ student's level, build confidence, adapt style | MCP_Tools: Context7, Sequential
-```
-
-### refactorer
-```yaml
-Core_Belief: Code quality debt compounds exponentially | Primary_Question: "How can this be simpler & cleaner?"
-Decision_Pattern: Code health > feature velocity | Risk_Tolerance: Aggressive on cleanup, conservative on behavior changes
-Success_Metric: Reduced complexity, improved maintainability | Communication_Style: Before/after comparisons, metrics, incremental steps
-Problem_Solving: Eliminate duplication, clarify intent, reduce coupling | MCP_Tools: Sequential, Context7
-```
-
-### performance
-```yaml
-Core_Belief: Speed is a feature, slowness kills adoption | Primary_Question: "Where is the bottleneck?"
-Decision_Pattern: Measure first, optimize critical path | Risk_Tolerance: Aggressive on optimization, data-driven decisions
-Success_Metric: Measurable speed improvements, user-perceived perf | Communication_Style: Benchmarks, profiles, perf budgets
-Problem_Solving: Profile first, fix hotspots, continuous monitoring | MCP_Tools: Puppeteer, Sequential
-```
-
-### qa
-```yaml
-Core_Belief: Quality cannot be tested in, must be built in | Primary_Question: "How could this break?"
-Decision_Pattern: Quality gates > delivery speed | Risk_Tolerance: Aggressive on edge cases, systematic about coverage
-Success_Metric: Defect escape rate, test coverage effectiveness | Communication_Style: Test scenarios, risk matrices, quality metrics
-Problem_Solving: Think like adversarial user, automate verification | MCP_Tools: Puppeteer, Context7
-```
-
-
-## Collaboration
-
-```yaml
-Sequential: Design Review: architect→security→perf→qa | Feature Build: architect→frontend/backend→qa→security
-Analysis: analyzer→refactorer→perf→qa | Parallel: Full Stack: frontend & backend & security
-Quality Focus: qa & refactorer & perf | Teaching: mentor & analyzer
-Handoff: Share findings→Checkpoint→Cumulative→Document
-```
-
-## Activation Patterns
-
-```yaml
-Files: *.tsx|*.jsx→frontend | *.test.*→qa | *refactor*→refactorer
-Keywords: optimize→perf | secure|auth→security | refactor→refactorer
-Context: Errors→analyzer | Perf issues→perf | Architecture→architect | Learning→mentor | Bug reports→qa | Code review→refactorer
-```
-
-## Command Specialization
-
-```yaml
-security → /user:scan --security | qa → /user:test,/user:scan --validate
-perf → /user:analyze --profile,/user:improve --perf | analyzer → /user:analyze,/user:troubleshoot,/user:explain
-architect → /user:design --api --ddd,/user:estimate | frontend → /user:build --react,/user:explain | backend → /user:build --api
-refactorer → /user:improve --quality,/user:cleanup --code | mentor → /user:explain --depth,/user:document
-```
-
----
-*SuperClaude v4.0.0 | 9 cognitive archetypes | Seq=Sequential C7=Context7 Mag=Magic Pup=Puppeteer*

package/SuperClaude/README.md

@@ -1,249 +0,0 @@
-# Meet SuperClaude – The Missing Power-Up for Claude Code
-
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-4.0.0-blue.svg)](https://github.com/NomenAK/SuperClaude)
-[![GitHub issues](https://img.shields.io/github/issues/NomenAK/SuperClaude)](https://github.com/NomenAK/SuperClaude/issues)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/NomenAK/SuperClaude/blob/master/CONTRIBUTING.md)
-
-**A lightweight framework that transforms generic Claude Code into your specialized development partner – no external tools, no complex setup, just pure configuration magic.**
-
-## 🎯 The Problem
-
-Claude Code is powerful, but let's be honest – it's generic. You find yourself:
-- Losing context mid-debugging session
-- Repeating the same instructions every project
-- Wishing it understood YOUR coding style
-- Watching tokens vanish on verbose responses
-
-## ✨ Enter SuperClaude
-
-Think of it as a brain upgrade for Claude Code. Drop it in once, and suddenly Claude:
-- **Remembers everything** with Git-based checkpoints
-- **Thinks like you want** with 9 specialized personas
-- **Works 70% more efficiently** with token optimization
-- **Never guesses** – always finds the official docs first
-
-## 🚀 Zero-Friction Install
-
-```bash
-git clone https://github.com/NomenAK/SuperClaude.git
-cd SuperClaude
-./install.sh                           # Default: ~/.claude/
-# OR
-./install.sh --dir /opt/claude          # Custom location
-./install.sh --dir ./project-claude    # Project-specific
-```
-
-That's it. No databases, no services, no dependencies. Installs to `~/.claude/` by default or any directory you choose. The installer even backs up your existing config automatically!
-
-## 💡 Why You'll Love It
-
-### 🔄 **Never Lose Context Again**
-Git-integrated checkpoint system lets you jump back to any point in your conversation. Debugging a nasty bug at 3am? Create a checkpoint. Need to try a different approach? Roll back and branch off.
-
-### 📚 **Smart Documentation That Evolves**
-Your docs write themselves using our token-optimized templates. Project docs go in `/docs`, while Claude's working notes live in `/.claudedocs`. Everything stays organized, nothing gets lost.
-
-### 🎭 **9 Instant Personas**
-Switch Claude's entire mindset with one command:
-
-```bash
-/persona:architect    # Big-picture system design mode
-/persona:frontend     # Pixel-perfect UI obsession mode
-/persona:security     # Paranoid threat-modeling mode
-/persona:analyzer     # Sherlock Holmes debugging mode
-```
-
-Each persona thinks differently, asks different questions, and solves problems their own way.
-
-### ⚡ **18 Power Commands**
-Real shortcuts for real work:
-
-```bash
-/user:build --react        # Spin up a React app with YOUR standards
-/user:troubleshoot --prod  # Production fire? This knows what to do
-/user:analyze --security   # Full security audit in seconds
-/user:git --checkpoint     # Save your progress before that risky refactor
-```
-
-### 🧠 **Actually Intelligent Integration**
-- **Context7** finds library docs instantly (no more "I think this is how it works")
-- **Sequential** thinking for complex problems (watch it reason step-by-step)
-- **Magic** generates UI components that actually match your style
-- **Puppeteer** tests everything in a real browser
-
-### 🚄 **70% More Efficient**
-Our UltraCompressed mode strips unnecessary tokens without losing clarity. More context, longer conversations, bigger projects – same token budget.
-
-## 🎮 Quick Start Examples
-
-### The "New Project" Flow
-```bash
-/persona:architect
-/user:design --api --ddd     # Domain-driven design from the start
-/user:estimate --detailed    # Know what you're getting into
-/persona:backend
-/user:build --api --tdd      # Build it right the first time
-```
-
-### The "Something's Broken" Flow
-```bash
-/persona:analyzer
-/user:troubleshoot --investigate --prod
-/user:analyze --profile      # Find the real bottleneck
-/persona:performance
-/user:improve --performance --threshold 90%
-```
-
-### The "Make It Pretty" Flow
-```bash
-/persona:frontend
-/user:build --react --magic  # AI-generated components
-/user:test --e2e --pup       # See it work in a real browser
-/user:improve --quality      # Polish until it shines
-```
-
-## 🔧 How It Actually Works
-
-SuperClaude is pure configuration – no code, no external dependencies. It works by:
-
-1. **Loading specialized instructions** when Claude Code starts
-2. **Activating different rulesets** based on your commands
-3. **Switching cognitive modes** through personas
-4. **Optimizing token usage** automatically
-
-The framework includes:
-- **CLAUDE.md** – Core configuration and behaviors
-- **RULES.md** – Engineering standards and practices
-- **PERSONAS.md** – 9 specialized thinking modes
-- **MCP.md** – Smart tool orchestration
-- **18 Commands** – Ready-made workflows
-- **26 Shared Resources** – Battle-tested patterns
-
-## 🎨 Pick Your Fighter (Persona)
-
-| Persona | Superpower | Activate When You Need... |
-|---------|------------|---------------------------|
-| **architect** | Sees the big picture | System design that scales |
-| **frontend** | UX perfectionist | Interfaces users love |
-| **backend** | Performance obsessed | APIs that never fail |
-| **security** | Professional paranoid | Code that's bulletproof |
-| **analyzer** | Root cause detective | To solve the unsolvable |
-| **qa** | Bug hunter supreme | Testing that catches everything |
-| **performance** | Speed demon | Every millisecond to count |
-| **refactorer** | Code beautifier | To simplify the complex |
-| **mentor** | Patient teacher | To understand, not just copy |
-
-## 🛠️ Advanced Features
-
-### Thinking Modes
-Control how deep Claude analyzes:
-```bash
-"think about X"              # Standard analysis
-"think hard about Y"         # Architecture-level depth
-"ultrathink Z"               # When you need EVERYTHING considered
-```
-
-### Smart Tool Control
-```bash
---c7           # Force documentation lookup
---seq          # Force step-by-step reasoning
---magic        # Force UI component generation
---no-mcp       # Use only native tools
---all-mcp      # Kitchen sink mode
-```
-
-### Evidence-Based Everything
-No more "this is better" without proof. SuperClaude enforces:
-- Metrics for performance claims
-- Documentation for library usage
-- Test results for quality assertions
-- Security scans for safety claims
-
-## 🤝 Community-Driven Development
-
-SuperClaude is MIT-licensed and built by developers, for developers. We welcome:
-- New personas for specialized workflows
-- Commands that solve your daily pain points
-- Patterns that make Claude Code smarter
-- Ideas that push the boundaries
-
-Check out our [Contributing Guide](CONTRIBUTING.md) and join the conversation!
-
-## 📊 What Makes It Different?
-
-| Feature | Without SuperClaude | With SuperClaude |
-|---------|-------------------|------------------|
-| **Context** | Lost after errors | Git checkpoints preserve everything |
-| **Personas** | Generic responses | Specialized thinking modes |
-| **Tokens** | Verbose outputs | 70% reduction, same information |
-| **Docs** | "I think this works" | Always finds official sources |
-| **Workflows** | Repeat instructions | One command, complete flow |
-| **Quality** | Hope for the best | Evidence-based standards |
-
-## 🔮 Coming Soon
-
-- VS Code extension for deeper integration
-- Persona marketplace for community contributions
-- Team sync for shared configurations
-- Analytics dashboard (privacy-first)
-
-## 💬 Real Developer Stories
-
-> "I was debugging a production issue at 2am. Created a checkpoint, tried three different approaches, rolled back to the one that worked. Saved my sanity." – *Backend Dev*
-
-> "The frontend persona just *gets* UX. It asks questions I didn't even think of." – *Full-Stack Dev*
-
-> "70% token reduction means I can keep entire codebases in context. Game changer." – *Tech Lead*
-
-## 🎯 Is SuperClaude For You?
-
-Perfect if you:
-- ✅ Want consistent AI assistance across projects
-- ✅ Value evidence over opinions
-- ✅ Need specialized thinking modes
-- ✅ Care about token efficiency
-- ✅ Like tools that just work
-
-Skip if you:
-- ❌ Prefer completely manual control
-- ❌ Don't use Claude Code regularly
-- ❌ Happy with generic AI responses
-
-## 🚦 Get Started in 2 Minutes
-
-1. **Install**
-   ```bash
-   git clone https://github.com/NomenAK/SuperClaude.git && cd SuperClaude && ./install.sh
-   # Or custom location: ./install.sh --dir /your/path
-   ```
-
-2. **Test Drive**
-   ```bash
-   /user:analyze --code        # See what it finds
-   /persona:architect          # Try a new mindset
-   ```
-
-3. **Go Deeper**
-   - Explore commands: `/user:load`
-   - Read the guides: `~/.claude/commands/`
-   - Join the community: [Discussions](https://github.com/NomenAK/SuperClaude/discussions)
-
-## 🛟 Need Help?
-
-- **Installation issues?** Run `./install.sh` again – it's idempotent. Use `./install.sh --help` for options
-- **Commands not working?** Check `ls ~/.claude/commands/`
-- **Want to contribute?** See [CONTRIBUTING.md](CONTRIBUTING.md)
-- **Found a bug?** [Open an issue](https://github.com/NomenAK/SuperClaude/issues)
-
-## 🎉 Join the Revolution
-
-SuperClaude isn't just a tool – it's a movement to make AI assistance actually useful for real developers. Every persona added, every command refined, every pattern shared makes Claude Code better for everyone.
-
-**What would make YOUR workflow better? Let's build it together.**
-
----
-
-*SuperClaude v4.0.0 – Because generic AI assistance isn't good enough anymore.*
-
-[⭐ Star us on GitHub](https://github.com/NomenAK/SuperClaude) | [💬 Join the Discussion](https://github.com/NomenAK/SuperClaude/discussions) | [🐛 Report an Issue](https://github.com/NomenAK/SuperClaude/issues)