<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-93-8B5CF6?style=for-the-badge&logo=bookstack&logoColor=white" alt="Skills" />
  <img src="https://img.shields.io/badge/IDEs-23-3B82F6?style=for-the-badge&logo=visualstudiocode&logoColor=white" alt="IDEs" />
  <img src="https://img.shields.io/badge/workflows-41-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 23 AI IDEs with 93 specialized skills and 20 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 (93)

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

### 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 (23)

| 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 (20 Tools)

Intelligent context engine with BM25 search, Merkle tree change detection, and web dashboard.

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

| Tool                     | Description                            |
| :----------------------- | :------------------------------------- |
| `hsa_get_context`        | Retrieve optimized context for LLM     |
| `hsa_detect_stack`       | Detect project tech stack              |
| `hsa_get_agent_config`   | Load commands, personas, rules, skills |
| `hsa_check_changes`      | Check file changes via Merkle diff     |
| `hsa_prefetch`           | Prefetch context for predicted queries |
| `hsa_status`             | Engine health and cache stats          |
| `hsa_search_skills`      | BM25 search across skill patterns      |
| `hsa_get_snapshot`       | Project structure snapshot             |
| `hsa_get_repo_map`       | Repository structure map               |
| `hsa_export`             | Export context as portable format      |
| `hsa_detect_environment` | Detect runtime environment             |
| `hsa_prepare_handoff`    | Prepare context for agent handoff      |
| `hsa_filter_tools`       | Filter available tools by context      |
| `hsa_trace_flow`         | Trace code execution & call chains     |
| `hsa_feedback`           | Provide relevance feedback for ranking |
| `hsa_declare_intent`     | Declare session intent & goals         |
| `hsa_track_progress`     | Track work in 3-level hierarchy        |
| `hsa_save_anchor`        | Save immutable facts across sessions   |
| `hsa_check_drift`        | Detect scope drift from declared intent|

**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>
