<p align="center">
  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:0F172A,50:1E40AF,100:8B5CF6&height=160&section=header&text=DOMYH%20Awesome%20Code&fontSize=36&fontColor=FFFFFF&animation=fadeIn&fontAlignY=35&desc=AI-Powered%20Development%20Assistant&descAlignY=55&descSize=14" width="100%" />
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/@nockdev/awf"><img src="https://img.shields.io/npm/v/@nockdev/awf?style=for-the-badge&logo=npm&logoColor=white&labelColor=CB3837&color=000000" alt="npm" /></a>
  <img src="https://img.shields.io/badge/skills-103-8B5CF6?style=for-the-badge&logo=bookstack&logoColor=white" alt="Skills" />
  <img src="https://img.shields.io/badge/IDEs-26-3B82F6?style=for-the-badge&logo=visualstudiocode&logoColor=white" alt="IDEs" />
  <img src="https://img.shields.io/badge/workflows-44-F59E0B?style=for-the-badge&logo=windowsterminal&logoColor=white" alt="Workflows" />
  <img src="https://img.shields.io/badge/personas-11-EF4444?style=for-the-badge&logo=drama&logoColor=white" alt="Personas" />
  <img src="https://img.shields.io/badge/license-MIT-10B981?style=for-the-badge&logo=opensourceinitiative&logoColor=white" alt="License" />
</p>

<p align="center">
  Plugin for <a href="https://www.npmjs.com/package/@nockdev/cli"><b>@nockdev/cli</b></a> — install once, use across 26 AI IDEs with 103 specialized skills and 16 HSA MCP tools.
</p>

---

## ⚡ Quick Start

```bash
npm install -g @nockdev/cli   # Install CLI
nock setup                    # One-command zero-config setup
```

Or step by step:

```bash
nock awf init                 # Interactive initialization wizard
nock awf install               # Install IDE configurations
```

## 🎯 Commands

| Command                          | Description                          |
| :------------------------------- | :----------------------------------- |
| `nock awf init`                  | Initialize DOMYH in your project     |
| `nock awf install --ide <name>`  | Setup IDE-specific configuration     |
| `nock awf mcp install --ide all` | Configure MCP server for all IDEs    |
| `nock awf list`                  | List available skills and workflows  |
| `nock awf doctor`                | Diagnose IDE configurations          |
| `nock awf info`                  | Show detected stack and project info |
| `nock awf config`                | Manage configuration                 |
| `nock awf update --check`        | Check for CLI updates                |
| `nock awf hsa`                   | HSA context engine management        |

---

## 🧠 Skills (103)

| Category          | Count | Highlights                                                                      |
| :---------------- | :---: | :------------------------------------------------------------------------------ |
| **Languages**     |  28   | Go, Python, TypeScript, JavaScript, Rust, C++, C, C#, Java, PHP, Kotlin, Swift… |
| **Cross-cutting** |  26   | Testing, Database, Tailwind, Electron, Microservices, TDD, Playwright…          |
| **Frameworks**    |   9   | React, Vue, Angular, Svelte, Next.js, Nuxt, Flutter, React Native, Streamlit    |
| **AI/ML**         |   9   | AI Agents, ML Pipelines, Prompt Engineering, RAG, Vector Search, Gemini…        |
| **Governance**    |   9   | Drift Prevention, Session Governance, Context Integrity, Progressive Escalation…|
| **DevOps**        |   7   | Docker, Kubernetes, AWS, Azure, GCP, CI/CD, Terraform                           |
| **Core**          |   9   | Security, API Design, Error Handling, Logging, Observability, Auth, Graph…      |
| **Tooling**       |   6   | CLI Dev, API Protocols, MCP, Browser Agent, IDE Extension, HSA Toolkit          |

### 3-Tier Progressive Loading

| Tier | File          | Size          | When             |
| :--: | :------------ | :------------ | :--------------- |
|  T1  | `META.yaml`   | ~100 tokens   | Always available |
|  T2  | `SKILL.md`    | ~1,500 tokens | On-demand        |
|  T3  | `ADVANCED.md` | ~4,000 tokens | Deep dive only   |

---

## 💻 Supported IDEs (26)

| Tier       | IDEs                                                                                               |
| :--------- | :------------------------------------------------------------------------------------------------- |
| **Tier 0** | Codex                                                                                              |
| **Tier 1** | Cursor, Claude Code, Gemini CLI, Antigravity, VS Code + Copilot, Windsurf                          |
| **Tier 2** | Cline, Continue, Roo Code, JetBrains AI, Amazon Q, Zed, Aider, CodeRabbit, Cody, Tabnine, OpenCode |
| **Tier 3** | Amp, Augment, Kiro, Void, Trae, PearAI, Qodo                                                      |

---

## 🎭 Personas (11)

| Persona         | Role                        | Trigger       |
| :-------------- | :-------------------------- | :------------ |
| 🔧 Developer    | Full-stack implementation   | `/code`       |
| 🏗️ Architect    | System design & patterns    | `/design`     |
| 🔬 Auditor      | 5-expert audit panel        | `/ap`         |
| 🐛 Debugger     | Root cause analysis         | `/debug`      |
| ✅ Tester       | Testing & coverage          | `/test`       |
| 🚀 DevOps       | Infrastructure & deployment | `/deploy`     |
| 📚 Documenter   | Documentation specialist    | `/doc`        |
| 📋 Planner      | Task decomposition          | `/plan`       |
| 🔍 Researcher   | Investigation & research    | `/find`       |
| 🎭 Orchestrator | Multi-agent coordination    | Complex tasks |
| 🔒 Security     | Security analysis           | `/security`   |

---

## 🔍 HSA MCP Server (15 Tools)

Intelligent context engine with BM25+ search, Merkle tree, Doc Fetcher, LiveCanvas, and web dashboard.

```bash
nock awf mcp install --ide all      # Configure for all IDEs
nock awf hsa start                  # Start HSA server
```

### Core Analysis

| Tool | Actions | Description |
|:-----|:--------|:------------|
| `hsa_search` | `context` `files` `skills` `docs` | Hybrid code search, file glob, skill patterns, external library docs |
| `hsa_explore` | `repo_map` `snapshot` | PageRank-ranked file overview, project structure snapshot |
| `hsa_detect` | `stack` `environment` | Detect tech stack, frameworks, runtimes |
| `hsa_check_changes` | — | Merkle tree diff, re-index BM25/CodeGraph |
| `hsa_trace_flow` | — | Trace code execution flow (up to 5 hops) |
| `hsa_prefetch` | — | Pre-load files/library docs into cache |
| `hsa_feedback` | — | Record file usefulness for ranking |

### Session & Visual

| Tool | Actions | Description |
|:-----|:--------|:------------|
| `hsa_session` | `persist` `track` `anchor` `drift` `intent` | Session governance, progress tracking, drift detection |
| `hsa_get_agent_config` | `bootstrap` `commands` `rules` `skills` `modules` | Load DOMYH agent configuration |
| `hsa_report` | `status` `export` `tasks` | Engine health, cache stats |
| `hsa_delegate` | `prepare` `filter` | Sub-agent delegation |
| `hsa_canvas` | `open` `capture` `diff` `update` `close` | LiveCanvas: screenshots, visual regression, live CSS |
| `hsa_design` | `analyze` `health` `tokens` | Design DNA, WCAG health, W3C DTCG tokens |
| `hsa_guide` | — | HSA optimal workflow guide |

**Web Dashboard** at `http://localhost:13100/dashboard` — real-time monitoring, tool call logs, and cache stats.

---

## 📋 Requirements

- **Node.js** ≥ 18.0.0
- [`@nockdev/cli`](https://www.npmjs.com/package/@nockdev/cli)

## 📄 License

MIT © [**NockDev**](https://github.com/nockasdd)

<p align="center">
  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:8B5CF6,50:1E40AF,100:0F172A&height=100&section=footer" width="100%" />
</p>
