heimdall-agent 1.1.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -13
- package/README.pt-BR.md +36 -22
- package/agents/code-sentinel.md +7 -1
- package/agents/modernizer.md +4 -2
- package/agents/orchestrator.md +20 -7
- package/agents/reviewer.md +2 -0
- package/config/agents.json +11 -1
- package/config/mcp.json +1 -1
- package/config/profiles.json +1 -1
- package/config/skills.json +762 -683
- package/docs/SKILLS.md +96 -74
- package/docs/runs/skill-audit/2026-11-12-compare-report.json +1028 -0
- package/docs/runs/skill-audit/2026-11-12-upstream-audit.json +275 -0
- package/doctrine/AGENTS.md +4 -1
- package/lib/catalog-sync.cjs +8 -3
- package/package.json +1 -1
- package/playbooks/01-interactive-grilling-gate.md +14 -10
- package/playbooks/03-adversarial-code-review.md +12 -4
- package/playbooks/05-canonical-plan-template.md +3 -1
- package/setup.mjs +2 -2
- package/skills/antislop-copywriting/SKILL.md +36 -1
- package/skills/brainstorming/SKILL.md +60 -38
- package/skills/codebase-design/DEEPENING.md +37 -0
- package/skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
- package/skills/codebase-design/SKILL.md +114 -0
- package/skills/domain-modeling/ADR-FORMAT.md +47 -0
- package/skills/domain-modeling/GLOSSARY-FORMAT.md +60 -0
- package/skills/domain-modeling/SKILL.md +74 -0
- package/skills/executing-plans/SKILL.md +6 -4
- package/skills/grill-me/SKILL.md +65 -0
- package/skills/handoff/SKILL.md +64 -0
- package/skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
- package/skills/improve-codebase-architecture/SKILL.md +71 -0
- package/skills/owasp-security/reference/config-and-supply-chain.md +346 -344
- package/skills/owasp-security/reference/languages.md +378 -372
- package/skills/owasp-security/reference/owasp-report.md +1144 -1140
- package/skills/owasp-security/reference/review-checklist.md +134 -132
- package/skills/subagent-driven-development/SKILL.md +7 -4
- package/skills/to-spec/SKILL.md +75 -0
- package/skills/to-tickets/SKILL.md +105 -0
- package/skills/wayfinder/SKILL.md +128 -0
package/docs/SKILLS.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Heimdall Canonical Skills & Suites Directory
|
|
2
2
|
|
|
3
|
-
This directory serves as the comprehensive reference manual for Heimdall's **
|
|
3
|
+
This directory serves as the comprehensive reference manual for Heimdall's **25 Primary Toolkits & Suites (64 modular capabilities)**.
|
|
4
4
|
|
|
5
5
|
> **Architecture & Execution**: Each skill module is an isolated directory containing a YAML-frontmattered `SKILL.md`. AI agent harnesses (Google Antigravity, Claude Code, OpenAI Codex CLI) parse frontmatter on startup and dynamically activate instructions via progressive disclosure.
|
|
6
6
|
|
|
@@ -24,6 +24,7 @@ heimdall update-skill all
|
|
|
24
24
|
- [📦 Anti-Slop Quality & Token Efficiency Suite (6 modules)](#antislop)
|
|
25
25
|
- [📦 Tri-Directional Cross-Model Bridges (3 modules)](#cross-model-bridges)
|
|
26
26
|
- [📦 Trail of Bits High-Assurance AppSec Suite (3 modules)](#trailofbits-appsec)
|
|
27
|
+
- [📦 Matt Pocock Real Engineering Suite (8 modules)](#mattpocock-suite)
|
|
27
28
|
|
|
28
29
|
### Standalone Power Toolkits
|
|
29
30
|
- [⚡ Ponytail Code Restraint](#ponytail)
|
|
@@ -38,12 +39,12 @@ heimdall update-skill all
|
|
|
38
39
|
- [⚡ Project & Workspace Hygiene Sentinel](#project-hygiene)
|
|
39
40
|
- [⚡ Structured Analysis & Output Formatting](#output-skill)
|
|
40
41
|
- [⚡ Caveman Chat Token Brevity Protocol](#caveman)
|
|
41
|
-
- [⚡ Clean Code & ub-mode Quality Sentinel](#clean-code)
|
|
42
|
-
- [⚡ Communication Doctrine (BLUF & STE)](#communication-doctrine)
|
|
43
|
-
- [⚡ STRIDE Threat Modeling & Attack Surface Sentinel](#threat-modeling)
|
|
44
|
-
- [⚡ MCP Server & Tool Engineering Standards](#mcp-engineering)
|
|
45
|
-
- [⚡ Herdr Coding Agent Multiplexer & Orchestrator](#herdr)
|
|
46
|
-
- [⚡ Thermo Architectural & Maintainability Audit](#thermo)
|
|
42
|
+
- [⚡ Clean Code & ub-mode Quality Sentinel](#clean-code)
|
|
43
|
+
- [⚡ Communication Doctrine (BLUF & STE)](#communication-doctrine)
|
|
44
|
+
- [⚡ STRIDE Threat Modeling & Attack Surface Sentinel](#threat-modeling)
|
|
45
|
+
- [⚡ MCP Server & Tool Engineering Standards](#mcp-engineering)
|
|
46
|
+
- [⚡ Herdr Coding Agent Multiplexer & Orchestrator](#herdr)
|
|
47
|
+
- [⚡ Thermo Architectural & Maintainability Audit](#thermo)
|
|
47
48
|
- [⚡ PStack Engineering Discipline](#pstack-discipline)
|
|
48
49
|
|
|
49
50
|
---
|
|
@@ -154,6 +155,27 @@ heimdall update-skill all
|
|
|
154
155
|
|
|
155
156
|
## Standalone Power Toolkits
|
|
156
157
|
|
|
158
|
+
<a id="mattpocock-suite"></a>
|
|
159
|
+
### 📦 Matt Pocock Real Engineering Suite (8 modules)
|
|
160
|
+
|
|
161
|
+
- **Upstream Source**: [https://github.com/mattpocock/skills](https://github.com/mattpocock/skills)
|
|
162
|
+
- **Suite Type**: Multi-Skill Suite
|
|
163
|
+
|
|
164
|
+
#### Included Modules:
|
|
165
|
+
|
|
166
|
+
* **`codebase-design`**: Design deep modules (small interfaces hiding large implementations), apply the deletion test, and enforce legitimate seams based on John Ousterhout's *Philosophy of Software Design*. ([Contract File](../skills/codebase-design/SKILL.md))
|
|
167
|
+
* **`domain-modeling`**: Extract ubiquitous language, domain models, and record Architecture Decision Records (ADRs) to eliminate terminology drift and document architectural choices. ([Contract File](../skills/domain-modeling/SKILL.md))
|
|
168
|
+
* **`improve-codebase-architecture`**: Audit codebase structure, detect circular dependencies, evaluate module coupling, and generate dependency matrix reports. ([Contract File](../skills/improve-codebase-architecture/SKILL.md))
|
|
169
|
+
* **`to-spec`**: Formalize requirements and interview outcomes into precise specifications with invariants, error matrices, and user journeys. ([Contract File](../skills/to-spec/SKILL.md))
|
|
170
|
+
* **`to-tickets`**: Decompose formal specifications into atomic, dependency-ordered task tickets formatted for subagent task queues. ([Contract File](../skills/to-tickets/SKILL.md))
|
|
171
|
+
* **`wayfinder`**: Map problem frontiers across large codebases, separating settled decisions from active frontier tickets and unexplored fog. ([Contract File](../skills/wayfinder/SKILL.md))
|
|
172
|
+
* **`grill-me`**: Relentless interview protocol using the Design Tree Frontier, autonomous fact-finding, and Yes-to-Approve recommendation format before implementation begins. ([Contract File](../skills/grill-me/SKILL.md))
|
|
173
|
+
* **`handoff`**: Compact session context into pointer-first handoff documents saved to $env:TEMP with mandatory Suggested Skills contracts to eliminate context drift and skill blindness. ([Contract File](../skills/handoff/SKILL.md))
|
|
174
|
+
|
|
175
|
+
[↑ Back to top](#toc)
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
157
179
|
<a id="ponytail"></a>
|
|
158
180
|
### ⚡ Ponytail Code Restraint
|
|
159
181
|
|
|
@@ -305,74 +327,74 @@ heimdall update-skill all
|
|
|
305
327
|
- **Aliases**: `/clean-code`, `/ub-mode`
|
|
306
328
|
- **Description**: Enforces Uncle Bob's Clean Code discipline, TDD cycles, laziness protocol, and mathematical quality gates (CRAP < 10, DRY similarity < 0.8, mutant-killing test design).
|
|
307
329
|
- **Upstream Source**: [https://github.com/unclebob/ub-mode](https://github.com/unclebob/ub-mode)
|
|
308
|
-
- **Contract File**: [`skills/clean-code/SKILL.md`](../skills/clean-code/SKILL.md)
|
|
309
|
-
|
|
310
|
-
[↑ Back to top](#toc)
|
|
311
|
-
|
|
312
|
-
---
|
|
313
|
-
|
|
314
|
-
<a id="communication-doctrine"></a>
|
|
315
|
-
### ⚡ Communication Doctrine (BLUF & Simplified Technical English)
|
|
316
|
-
|
|
317
|
-
- **Module Name**: `communication-doctrine`
|
|
318
|
-
- **Description**: Enforces zero-latency Bottom Line Up Front (BLUF) headers on subagent handoffs, code reviews, and plans, alongside Simplified Technical English (STE) imperative syntax that eliminates ambiguous qualifiers.
|
|
330
|
+
- **Contract File**: [`skills/clean-code/SKILL.md`](../skills/clean-code/SKILL.md)
|
|
331
|
+
|
|
332
|
+
[↑ Back to top](#toc)
|
|
333
|
+
|
|
334
|
+
---
|
|
335
|
+
|
|
336
|
+
<a id="communication-doctrine"></a>
|
|
337
|
+
### ⚡ Communication Doctrine (BLUF & Simplified Technical English)
|
|
338
|
+
|
|
339
|
+
- **Module Name**: `communication-doctrine`
|
|
340
|
+
- **Description**: Enforces zero-latency Bottom Line Up Front (BLUF) headers on subagent handoffs, code reviews, and plans, alongside Simplified Technical English (STE) imperative syntax that eliminates ambiguous qualifiers.
|
|
319
341
|
- **Contract File**: [`skills/communication-doctrine/SKILL.md`](../skills/communication-doctrine/SKILL.md)
|
|
320
342
|
|
|
321
343
|
[↑ Back to top](#toc)
|
|
322
344
|
|
|
323
|
-
---
|
|
324
|
-
|
|
325
|
-
<a id="threat-modeling"></a>
|
|
326
|
-
### ⚡ STRIDE Threat Modeling & Attack Surface Sentinel
|
|
327
|
-
|
|
328
|
-
- **Module Name**: `threat-modeling`
|
|
329
|
-
- **Description**: Systematic STRIDE threat modeling, trust boundary mapping, and mitigation verification for architecture, API, and cloud infrastructure changes.
|
|
330
|
-
- **Contract File**: [`skills/threat-modeling/SKILL.md`](../skills/threat-modeling/SKILL.md)
|
|
331
|
-
|
|
332
|
-
[↑ Back to top](#toc)
|
|
333
|
-
|
|
334
|
-
---
|
|
335
|
-
|
|
336
|
-
<a id="mcp-engineering"></a>
|
|
337
|
-
### ⚡ MCP Server & Tool Engineering Standards
|
|
338
|
-
|
|
339
|
-
- **Module Name**: `mcp-engineering`
|
|
340
|
-
- **Description**: Standards, JSON-RPC 2.0 protocol compliance, schema validation, and stdio/SSE transport discipline for authoring Model Context Protocol (MCP) servers and tools.
|
|
341
|
-
- **Contract File**: [`skills/mcp-engineering/SKILL.md`](../skills/mcp-engineering/SKILL.md)
|
|
342
|
-
|
|
343
|
-
[↑ Back to top](#toc)
|
|
344
|
-
|
|
345
|
-
---
|
|
346
|
-
|
|
347
|
-
<a id="herdr"></a>
|
|
348
|
-
### ⚡ Herdr Coding Agent Multiplexer & Orchestrator
|
|
349
|
-
|
|
350
|
-
- **Module Name**: `herdr`
|
|
351
|
-
- **Description**: Control Herdr, a terminal workspace manager for coding agents. Inspect or control panes, tabs, workspaces, commands, or coordinate with peer agents (claude, codex, gemini/agy, etc.) in persistent terminal sessions.
|
|
352
|
-
- **Contract File**: [`skills/herdr/SKILL.md`](../skills/herdr/SKILL.md)
|
|
353
|
-
|
|
354
|
-
[↑ Back to top](#toc)
|
|
355
|
-
|
|
356
|
-
---
|
|
357
|
-
|
|
358
|
-
<a id="thermo"></a>
|
|
359
|
-
### ⚡ Thermo Architectural & Maintainability Audit
|
|
360
|
-
|
|
361
|
-
- **Module Name**: `thermo`
|
|
362
|
-
- **Description**: Unusually strict architectural and maintainability review focusing on "Code Judo" structural simplification, spaghetti conditional elimination, and modularity health.
|
|
363
|
-
- **Contract File**: [`skills/thermo/SKILL.md`](../skills/thermo/SKILL.md)
|
|
364
|
-
|
|
365
|
-
[↑ Back to top](#toc)
|
|
366
|
-
|
|
367
|
-
---
|
|
368
|
-
|
|
369
|
-
<a id="pstack-discipline"></a>
|
|
370
|
-
### ⚡ PStack Engineering Discipline
|
|
371
|
-
|
|
372
|
-
- **Module Name**: `pstack-discipline`
|
|
373
|
-
- **Description**: High-rigor engineering discipline from the pstack / poteto framework: "Prove It Works", "Fix Root Causes", "Test Behavior, Not Implementation", and "Subtract Before You Add".
|
|
374
|
-
- **Contract File**: [`skills/pstack-discipline/SKILL.md`](../skills/pstack-discipline/SKILL.md)
|
|
375
|
-
|
|
376
|
-
[↑ Back to top](#toc)
|
|
377
|
-
|
|
378
|
-
---
|
|
345
|
+
---
|
|
346
|
+
|
|
347
|
+
<a id="threat-modeling"></a>
|
|
348
|
+
### ⚡ STRIDE Threat Modeling & Attack Surface Sentinel
|
|
349
|
+
|
|
350
|
+
- **Module Name**: `threat-modeling`
|
|
351
|
+
- **Description**: Systematic STRIDE threat modeling, trust boundary mapping, and mitigation verification for architecture, API, and cloud infrastructure changes.
|
|
352
|
+
- **Contract File**: [`skills/threat-modeling/SKILL.md`](../skills/threat-modeling/SKILL.md)
|
|
353
|
+
|
|
354
|
+
[↑ Back to top](#toc)
|
|
355
|
+
|
|
356
|
+
---
|
|
357
|
+
|
|
358
|
+
<a id="mcp-engineering"></a>
|
|
359
|
+
### ⚡ MCP Server & Tool Engineering Standards
|
|
360
|
+
|
|
361
|
+
- **Module Name**: `mcp-engineering`
|
|
362
|
+
- **Description**: Standards, JSON-RPC 2.0 protocol compliance, schema validation, and stdio/SSE transport discipline for authoring Model Context Protocol (MCP) servers and tools.
|
|
363
|
+
- **Contract File**: [`skills/mcp-engineering/SKILL.md`](../skills/mcp-engineering/SKILL.md)
|
|
364
|
+
|
|
365
|
+
[↑ Back to top](#toc)
|
|
366
|
+
|
|
367
|
+
---
|
|
368
|
+
|
|
369
|
+
<a id="herdr"></a>
|
|
370
|
+
### ⚡ Herdr Coding Agent Multiplexer & Orchestrator
|
|
371
|
+
|
|
372
|
+
- **Module Name**: `herdr`
|
|
373
|
+
- **Description**: Control Herdr, a terminal workspace manager for coding agents. Inspect or control panes, tabs, workspaces, commands, or coordinate with peer agents (claude, codex, gemini/agy, etc.) in persistent terminal sessions.
|
|
374
|
+
- **Contract File**: [`skills/herdr/SKILL.md`](../skills/herdr/SKILL.md)
|
|
375
|
+
|
|
376
|
+
[↑ Back to top](#toc)
|
|
377
|
+
|
|
378
|
+
---
|
|
379
|
+
|
|
380
|
+
<a id="thermo"></a>
|
|
381
|
+
### ⚡ Thermo Architectural & Maintainability Audit
|
|
382
|
+
|
|
383
|
+
- **Module Name**: `thermo`
|
|
384
|
+
- **Description**: Unusually strict architectural and maintainability review focusing on "Code Judo" structural simplification, spaghetti conditional elimination, and modularity health.
|
|
385
|
+
- **Contract File**: [`skills/thermo/SKILL.md`](../skills/thermo/SKILL.md)
|
|
386
|
+
|
|
387
|
+
[↑ Back to top](#toc)
|
|
388
|
+
|
|
389
|
+
---
|
|
390
|
+
|
|
391
|
+
<a id="pstack-discipline"></a>
|
|
392
|
+
### ⚡ PStack Engineering Discipline
|
|
393
|
+
|
|
394
|
+
- **Module Name**: `pstack-discipline`
|
|
395
|
+
- **Description**: High-rigor engineering discipline from the pstack / poteto framework: "Prove It Works", "Fix Root Causes", "Test Behavior, Not Implementation", and "Subtract Before You Add".
|
|
396
|
+
- **Contract File**: [`skills/pstack-discipline/SKILL.md`](../skills/pstack-discipline/SKILL.md)
|
|
397
|
+
|
|
398
|
+
[↑ Back to top](#toc)
|
|
399
|
+
|
|
400
|
+
---
|