anchi-toolkit 1.2.0 → 1.2.2

package/dist/commands/design.md

@@ -0,0 +1,177 @@
+---
+description: ⚡⚡⚡ Design UI components or domain models
+argument-hint: [what to design]
+---
+
+# /design - Unified Design Command
+
+**What:** Design UI components, pages, or domain models.
+
+## Usage
+```
+/design "Login page"                    # UI design (default)
+/design "User entity" --domain          # Domain design (DDD)
+/design "Dashboard" --screenshot        # Design from screenshot
+/design "Product card" --library        # Choose component library
+```
+
+---
+
+## 💰 Model Selection
+
+| Mode | Recommended Model | Cost |
+|------|-------------------|------|
+| UI Design | Sonnet 4.5 | 💛 Medium |
+| Domain Design (DDD) | Opus 4.5 | 🔴 High |
+| From screenshot | GPT-5.1 Codex Max | 💛 Medium |
+| Library setup | GPT-5.1 Codex Mini | 💚 Low |
+
+---
+
+## Modes
+
+| Flag | Mode | Description |
+|------|------|-------------|
+| (default) | UI | Component/page design |
+| `--domain` | DDD | Domain-driven design |
+| `--screenshot` | Clone | Design from image |
+| `--library` | Setup | Choose UI library |
+
+---
+
+## UI Design Output
+
+```
+🎨 /design "Login page"
+
+═══════════ UI SPECIFICATION ═══════════
+
+📐 Layout:
+  • Center aligned
+  • Max-width: 400px
+  • Glassmorphism card
+
+🎨 Style:
+  • Dark gradient background
+  • Purple/blue accent
+  • Smooth animations
+
+📦 Components:
+  ├── LoginCard
+  │   ├── Logo
+  │   ├── Title
+  │   ├── EmailInput
+  │   ├── PasswordInput
+  │   ├── RememberMe
+  │   ├── LoginButton
+  │   └── SocialButtons
+  └── BackgroundEffect
+
+✨ Interactions:
+  • Input focus glow
+  • Button hover effect
+  • Loading state
+  • Error shake animation
+
+♿ Accessibility:
+  • ARIA labels
+  • Keyboard navigation
+  • Color contrast AA+
+
+👉 Generate code? (ok/edit)
+```
+
+---
+
+## Domain Design Output
+
+```
+🏛️ /design "User entity" --domain
+
+═══════════ DOMAIN MODEL ═══════════
+
+📦 Entity: User
+├── id: UUID
+├── email: Email (value object)
+├── password: HashedPassword (value object)
+├── profile: UserProfile (entity)
+├── createdAt: DateTime
+└── updatedAt: DateTime
+
+🔧 Behaviors:
+├── register(email, password)
+├── login(email, password)
+├── updateProfile(data)
+├── changePassword(old, new)
+└── deactivate()
+
+📋 Events:
+├── UserRegistered
+├── UserLoggedIn
+├── ProfileUpdated
+└── PasswordChanged
+
+🔗 Aggregates:
+  User ──┬── UserProfile
+         └── UserSettings
+
+👉 Generate code? (ok/edit)
+```
+
+---
+
+## Replaces
+
+```
+/design replaces:
+  • /design:ui
+  • /design:domain
+  • /design:fast
+  • /design:good
+  • /design:describe
+  • /design:screenshot
+  • /design:video
+  • /design:3d
+  • /design:library
+
+Total: 9 commands → 1 command
+```
+
+---
+
+## Agent & Skill Activation
+
+### Mode-Based Agents
+
+| Mode | Primary Agent | Support Agents |
+|------|---------------|----------------|
+| UI (default) | `ui-ux-designer.md` | `design-system-architect.md` |
+| Domain | `ddd-architect.md` | `database-admin.md` |
+| Screenshot | `ui-ux-designer.md` | `copywriter.md` |
+| Library | `design-system-architect.md` | - |
+
+### Auto-Activated Skills
+
+| Mode | Skills |
+|------|--------|
+| UI | `ui-styling/`, `aesthetic/`, `frontend-design/`, `ui-ux-pro-max/` |
+| Domain | `ddd-modular-monolith/`, `databases/`, `backend-development/` |
+| Screenshot | `ui-styling/`, `chrome-devtools/` |
+| Library | `frontend-development/`, `web-frameworks/` |
+| 3D | `threejs/` |
+
+---
+
+##  Dynamic Orchestration
+
+> **AI MUST read orchestration config before execution**
+
+```
+1. READ .cursor/agent-skill-index.yaml
+2. CHECK command_mapping for this command
+3. APPLY skill activation rules
+4. CHECK .cursor/failure-modes.yaml
+5. LOG decision to .ai-audit/
+```
+
+ [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)

package/dist/commands/do.md

@@ -0,0 +1,403 @@
+---
+description: ⚡⚡⚡⚡⚡ THE UNIVERSAL COMMAND - Plan, Code, Fix all in one
+argument-hint: [what you want to do]
+---
+
+# /do - Universal Command
+
+**What:** One command for everything. AI automatically decides the best approach.
+
+## Usage
+
+```
+/do "Add user login with Google OAuth"
+/do "Fix the checkout bug"
+/do "Refactor the API layer"
+```
+
+---
+
+## 💰 Model Selection (Cost Optimization)
+
+| Task Type                       | Recommended Model  | Cost      | When           |
+| ------------------------------- | ------------------ | --------- | -------------- |
+| **Simple** (typo, rename)       | GPT-5.1 Codex Mini | 💚 Low    | Quick fixes    |
+| **Medium** (feature, fix)       | Sonnet 4.5         | 💛 Medium | Standard dev   |
+| **Complex** (architecture)      | Opus 4.5           | 🔴 High   | Deep reasoning |
+| **Large codebase** (>200 files) | Gemini 3 Flash     | 💚 Low    | Big context    |
+
+### Auto-Detection Logic
+
+```
+/do "fix typo"              → GPT-5.1 Codex Mini (cheap)
+/do "add login page"        → Sonnet 4.5 (standard)
+/do "refactor architecture" → Opus 4.5 (complex)
+/do --fast "quick change"   → GPT-5.1 Codex Mini (speed)
+/do --careful "payment"     → Opus 4.5 (accuracy)
+```
+
+---
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 🎯 /do - SMART ROUTING                                      │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  INPUT: "Add user login with Google OAuth"                  │
+│           ↓                                                 │
+│  AI ANALYSIS:                                               │
+│  ├── Is it a BUG? → Fix mode                               │
+│  ├── Is it NEW FEATURE? → Plan + Implement                 │
+│  ├── Is it SIMPLE? → Direct implement                      │
+│  └── Is it COMPLEX? → Multi-phase with reviews             │
+│           ↓                                                 │
+│  AUTO WORKFLOW:                                             │
+│  [1] Active Memory Load (Context-Aware)                    │
+│  [2] Scout codebase (/scout)                               │
+│  [3] Plan (Parallel Workstreams if needed)                 │
+│  [4] Interactive Check (if --interactive)                  │
+│  [5] Implement                                             │
+│  [6] Fix errors (Interactive Probing)                      │
+│  [7] Save context (/memory:save)                           │
+│  [8] Post-Mortem (if failure)                              │
+│           ↓                                                 │
+│  ✅ DONE!                                                   │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Flags (Optional)
+
+| Flag            | Effect                                               |
+| --------------- | ---------------------------------------------------- |
+| `--fast`        | Skip reviews, quick implementation                   |
+| `--careful`     | Extra validation, more reviews                       |
+| `--plan-only`   | Just create plan, don't implement                    |
+| `--no-commit`   | Don't auto-commit                                    |
+| `--parallel`    | Run phases in parallel                               |
+| `--interactive` | Pause for user input key steps ([C]ontinue/[M]odify) |
+
+**Examples:**
+
+```
+/do "quick fix typo" --fast
+/do "payment integration" --careful
+/do "complex refactor" --plan-only
+```
+
+---
+
+## Detection Keywords
+
+AI detects mode from your description:
+
+| Keywords                           | Mode             |
+| ---------------------------------- | ---------------- |
+| fix, bug, error, broken, issue     | 🔧 Fix Mode      |
+| add, create, new, implement, build | ✨ Feature Mode  |
+| refactor, optimize, improve, clean | ♻️ Refactor Mode |
+| update, change, modify             | 📝 Update Mode   |
+
+---
+
+## Output Format (Professional Reporting)
+
+By default, use **Selective Transparency**. Show key roles and decisions, but hide verbose technical steps.
+
+### ✅ Success Case
+
+```
+🎯 Goal: Implement Google OAuth
+🤖 Orchestration:
+  • Agent: `Fullstack Dev` (+ `Security Auditor` for auth check)
+  • Risk: 🛡️ High (Auth modification) - Approved via policy.
+📝 Execution:
+  • Created `src/services/auth.service.ts`
+  • Updated `src/pages/login.tsx`
+✅ Result: Authentication flow implemented and verified.
+```
+
+### ⚠️ Risk/Approval Case
+
+```
+🎯 Task: Delete user database table
+⚠️ RISK: Critical (Data Loss)
+❓ Approval Required: This will wipe production data.
+👉 [Y]es / [N]o ?
+```
+
+### ❌ Failure Case
+
+```
+🎯 Task: Fix login bug
+❌ Failed: Could not resolve dependency `better-auth`.
+🔍 Analysis: Package version mismatch.
+💡 Suggestion: Run `npm install better-auth@latest`
+```
+
+---
+
+## Modes
+
+### 🔧 Fix Mode
+
+```
+/do "Fix the login button not working"
+
+[AUTO] Analyze error
+[AUTO] Find root cause
+[AUTO] Apply fix
+[AUTO] Verify fix
+```
+
+### ✨ Feature Mode
+
+```
+/do "Add user dashboard"
+
+[AUTO] Plan feature
+[AUTO] Generate structure
+[AUTO] Implement
+[AUTO] Add tests (if --careful)
+```
+
+### ♻️ Refactor Mode
+
+```
+/do "Refactor API error handling"
+
+[AUTO] Analyze current code
+[AUTO] Plan refactor
+[AUTO] Apply changes
+[AUTO] Verify functionality
+```
+
+---
+
+## Preset Integration
+
+| Preset       | Default Behavior         |
+| ------------ | ------------------------ |
+| Rapid        | --fast (skip reviews)    |
+| Professional | Standard + tests         |
+| Enterprise   | --careful (full reviews) |
+
+---
+
+## Agent & Skill Activation
+
+### Agents (Auto-Selected Based on Task)
+
+| Task Type     | Primary Agent            | Support Agents                     |
+| ------------- | ------------------------ | ---------------------------------- |
+| **Feature**   | `fullstack-developer.md` | `planner.md`, `brainstormer.md`    |
+| **Fix/Debug** | `debugger.md`            | `code-reviewer.md`                 |
+| **Refactor**  | `code-reviewer.md`       | `fullstack-developer.md`           |
+| **UI Work**   | `ui-ux-designer.md`      | `design-system-architect.md`       |
+| **API Work**  | `fullstack-developer.md` | `database-admin.md`                |
+| **Complex**   | `planner.md`             | `researcher.md`, `brainstormer.md` |
+
+### Skills (Auto-Activated Based on Tech Detection)
+
+| Detected Tech | Skills Activated                                |
+| ------------- | ----------------------------------------------- |
+| React/Next.js | `frontend-development/`, `web-frameworks/`      |
+| Node/Express  | `backend-development/`, `web-frameworks/`       |
+| Prisma/DB     | `databases/`, `backend-development/`            |
+| Tailwind      | `ui-styling/`, `aesthetic/`                     |
+| TypeScript    | `frontend-development/`, `backend-development/` |
+| DDD Pattern   | `ddd-modular-monolith/`                         |
+| Testing       | `debugging/`, `code-review/`                    |
+| AI/ML         | `ai-multimodal/`, `claude-code/`                |
+| Mobile        | `mobile-development/`                           |
+| 3D/Three.js   | `threejs/`                                      |
+
+### Auto-Activation Logic
+
+```
+/do "Add user login"
+
+[AUTO-DETECT]
+├── Task: Feature (add keyword)
+├── Tech: Next.js + Prisma detected in project
+│
+[ACTIVATE]
+├── Agents: fullstack-developer, planner
+├── Skills:
+│   ├── frontend-development/
+│   ├── backend-development/
+│   ├── databases/
+│   ├── web-frameworks/
+│   └── better-auth/ (login detected)
+```
+
+### Mode-Specific Activation
+
+| Flag          | Additional Agents               | Additional Skills            |
+| ------------- | ------------------------------- | ---------------------------- |
+| `--careful`   | `code-reviewer.md`, `tester.md` | `code-review/`, `debugging/` |
+| `--fast`      | (minimal)                       | (minimal)                    |
+| `--plan-only` | `planner.md`, `researcher.md`   | `planning/`, `research/`     |
+
+---
+
+## Replaces These Commands
+
+```
+/do replaces:
+  • /plan, /plan:fast, /plan:hard, /plan:auto, /plan:ci, /plan:cro, /plan:parallel, /plan:two
+  • /cook, /cook:auto, /cook:auto:fast, /cook:auto:parallel
+  • /fix, /fix:fast, /fix:hard, /fix:types, /fix:ui, /fix:ci, /fix:test, /fix:logs, /fix:parallel
+  • /auto:rapid, /auto:pro, /auto:enterprise
+  • /code, /code:no-test, /code:parallel
+  • /debug
+
+Total: 40+ commands → 1 command
+```
+
+---
+
+## Configuration
+
+```yaml
+do:
+  default_mode: auto # auto, fast, careful
+  auto_commit: false
+  auto_test: true
+  show_plan: true
+  preset_aware: true
+  auto_activate_skills: true
+  auto_detect_agents: true
+```
+
+---
+
+---
+
+## 🚀 Advanced Capabilities (New)
+
+### 🧠 Active Memory
+
+Instead of loading full context, AI now uses **Context-Aware Retrieval**:
+
+- **/do matches keywords** → Queries `context.json` specifically for related decisions.
+- **Reduces noise** → Faster processing, higher accuracy.
+
+### 🔄 Self-Correction Loop
+
+If a task fails repeatedly (>2 times):
+
+1. **Post-Mortem Chain** activates.
+2. AI analyzes root cause.
+3. Updates `failure-modes.yaml` with a new rule.
+4. Future tasks will AVOID this same mistake.
+
+### 🕵️ Interactive Debugging
+
+Debugger agent now has **Probing** capability:
+
+1. Inject `console.log` probes.
+2. Run test to capture dynamic state.
+3. Analyze output.
+4. Remove probes and apply fix.
+
+---
+
+## 🔄 Dynamic Orchestration (RUNTIME REQUIRED)
+
+> **AI MUST execute this logic BEFORE implementation**
+
+### Step 1: Load Config
+
+```
+READ: .cursor/agent-skill-index.yaml
+READ: .cursor/orchestration.yaml
+READ: .cursor/failure-modes.yaml
+```
+
+### Step 2: Analyze Request
+
+```
+EXTRACT keywords from user description
+IDENTIFY affected file patterns
+DETERMINE complexity (simple/medium/complex)
+```
+
+### Step 3: Dynamic Agent Selection
+
+```
+CHECK command_mapping./do:
+  - default: fullstack-developer
+  - conditionals:
+    - IF "bug OR fix" → debugger
+    - IF "design OR ui" → ui-ux-designer
+    - IF "plan" → planner
+
+CHECK agent.boundaries for escalation needs
+CHECK skill.requires_security_review flags
+```
+
+### Step 4: Dynamic Skill Activation
+
+```
+FOR EACH skill IN skills:
+  IF skill.activation.keyword MATCHES request → ACTIVATE
+  IF skill.activation.file_pattern MATCHES files → ACTIVATE
+  IF skill.activation.package IN package.json → ACTIVATE
+```
+
+### Step 5: Check Failure Modes
+
+```
+IF confidence < 0.5 → ASK user
+IF security_concern → ESCALATE to security-auditor
+IF architecture_violation → STOP and report
+IF outside_expertise → ESCALATE to appropriate agent
+```
+
+### Step 6: Determine Risk Level
+
+```
+SCAN keywords against orchestration.yaml risk_levels:
+  - low: ["typo", "rename"] → quick_fix chain
+  - medium: ["feature", "component"] → feature_development chain
+  - high: ["payment", "auth"] → security_chain
+  - critical: ["delete", "production"] → security_chain + backup
+```
+
+### Step 7: Build Execution Chain
+
+```
+SELECT chain from orchestration.yaml based on risk
+APPLY required approvals
+QUEUE agents in order
+```
+
+### Step 8: Log to Audit
+
+```
+WRITE to .ai-audit/YYYY-MM-DD.jsonl:
+{
+  "timestamp": now,
+  "command": "/do",
+  "agents": [selected_agents],
+  "skills": [activated_skills],
+  "risk_level": detected_risk,
+  "chain": selected_chain
+}
+```
+
+### Step 9: Execute
+
+```
+RUN chain with orchestrated agents and skills
+APPLY failure-modes.yaml restraints throughout
+```
+
+---
+
+📖 **Full documentation:** [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)

package/dist/commands/docs.md

@@ -0,0 +1,101 @@
+---
+description: ⚡⚡ Generate and update documentation
+argument-hint: [optional: what to document]
+---
+
+# /docs - Documentation Manager
+
+**What:** Generate, update, and manage documentation.
+
+## Usage
+```
+/docs                          # Update all docs
+/docs "API"                    # Document API
+/docs --init                   # Initialize docs structure
+/docs --changelog              # Generate changelog
+```
+
+---
+
+## 💰 Model Selection
+
+| Action | Recommended Model | Cost |
+|--------|-------------------|------|
+| Update docs | GPT-5.1 Codex Mini | 💚 Low |
+| Generate changelog | GPT-5.1 Codex Mini | 💚 Low |
+| API docs | Sonnet 4.5 | 💛 Medium |
+
+---
+
+## Output
+
+```
+📚 /docs
+
+═══════════ DOCUMENTATION ═══════════
+
+📊 Status:
+  ✅ README.md - Up to date
+  ⚠️ API.md - Outdated (3 new endpoints)
+  ❌ CHANGELOG.md - Missing
+
+📝 Updates needed:
+  1. Add: POST /api/users docs
+  2. Add: GET /api/products docs  
+  3. Update: Authentication section
+  4. Generate: CHANGELOG.md
+
+👉 Apply updates? (ok/select)
+```
+
+---
+
+## Flags
+
+| Flag | Action |
+|------|--------|
+| `--init` | Initialize docs structure |
+| `--changelog` | Generate CHANGELOG |
+| `--api` | Focus on API docs |
+| `--readme` | Update README only |
+
+---
+
+## Replaces
+
+```
+/docs replaces:
+  • /docs:init
+  • /docs:update
+  • /docs:summarize
+  • /changelog
+```
+
+---
+
+## Agent & Skill Activation
+
+**Primary Agents:**
+- `.cursor/agents/docs-manager.md` - Documentation structure
+- `.cursor/agents/copywriter.md` - Writing quality
+
+**Skills:**
+- `document-skills/` - Documentation patterns
+- `frontend-development/` - Code docs
+
+
+---
+
+##  Dynamic Orchestration
+
+> **AI MUST read orchestration config before execution**
+
+```
+1. READ .cursor/agent-skill-index.yaml
+2. CHECK command_mapping for this command
+3. APPLY skill activation rules
+4. CHECK .cursor/failure-modes.yaml
+5. LOG decision to .ai-audit/
+```
+
+ [docs/ORCHESTRATION_RUNTIME.md](../docs/ORCHESTRATION_RUNTIME.md)