heimdall-agent 1.1.0 → 1.4.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 +101 -31
- package/README.pt-BR.md +124 -40
- package/agents/code-sentinel.md +7 -1
- package/agents/frontend-designer.md +6 -1
- package/agents/modernizer.md +8 -3
- package/agents/orchestrator.md +22 -8
- package/agents/reviewer.md +3 -1
- package/config/agents.json +177 -5
- package/config/mcp.json +1 -1
- package/config/mcp.resolved.json +74 -0
- package/config/mcp.template.json +85 -0
- package/config/models.json +70 -0
- package/config/profiles.json +4 -3
- package/config/skills.json +321 -93
- package/docs/SKILLS.md +158 -75
- package/docs/designs/old/2026-11-16 upstream-skill-sync-and-provenance-links.md +60 -0
- 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 +7 -4
- package/hooks/heimdall-hook.cjs +16 -1
- package/hooks/hooks.json +11 -0
- package/lib/catalog-sync.cjs +8 -3
- package/lib/model-context.cjs +50 -1
- package/lib/model-router.cjs +294 -0
- 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 +8 -13
- package/playbooks/06-model-registry-matrix.md +27 -19
- package/readme.html +1006 -0
- package/setup.mjs +317 -206
- 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/communication-doctrine/SKILL.md +2 -2
- 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 +77 -0
- package/skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
- package/skills/improve-codebase-architecture/SKILL.md +71 -0
- package/skills/mcp-cleanup/SKILL.md +61 -0
- package/skills/mcp-sync/SKILL.md +58 -0
- package/skills/modern-web-guidance/SKILL.md +90 -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/ruminate/SKILL.md +140 -0
- package/skills/subagent-driven-development/SKILL.md +7 -4
- package/skills/taste-skill/SKILL.md +367 -534
- package/skills/to-spec/SKILL.md +75 -0
- package/skills/to-tickets/SKILL.md +105 -0
- package/skills/upstream-skill-sync/SKILL.md +46 -0
- package/skills/wayfinder/SKILL.md +128 -0
- package/skills/writing-plans/SKILL.md +1 -1
package/README.md
CHANGED
|
@@ -4,13 +4,13 @@
|
|
|
4
4
|
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" alt="License: MIT" /></a>
|
|
5
5
|
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18.0.0-339933.svg?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 18" /></a>
|
|
6
6
|
<a href="#10-predefined-agent-personas"><img src="https://img.shields.io/badge/agents-10%20predefined-orange.svg?style=flat-square" alt="Agents: 10 Predefined" /></a>
|
|
7
|
-
<a href="#skill-inventory-
|
|
7
|
+
<a href="#skill-inventory-69-modules-across-30-toolkits"><img src="https://img.shields.io/badge/skills-30%20toolkits%20%2869%20modules%29-blueviolet.svg?style=flat-square" alt="Skills: 30 Toolkits (69 Modules)" /></a>
|
|
8
8
|
<a href="#supported-tools--runtimes"><img src="https://img.shields.io/badge/runtimes-Antigravity%20%7C%20Claude%20%7C%20Codex%20%7C%20Hermes%20%7C%20OpenClaw-black.svg?style=flat-square" alt="Runtimes" /></a>
|
|
9
9
|
</p>
|
|
10
10
|
|
|
11
11
|
🌐 **Language / Idioma:** **English** | [Português (Brasil)](README.pt-BR.md)
|
|
12
12
|
|
|
13
|
-
Heimdall is a portable bootstrap toolkit and quality sentinel for multi-agent software engineering. It enforces planning gates before code generation, prevents AI slop, isolates module boundaries, and synchronizes **10 specialized agent personas** and **
|
|
13
|
+
Heimdall is a portable bootstrap toolkit and quality sentinel for multi-agent software engineering. It enforces planning gates before code generation, prevents AI slop, isolates module boundaries, and synchronizes **10 specialized agent personas** and **69 modular skills** across **Google Antigravity**, **Claude Code**, **OpenAI Codex CLI**, **Hermes Agent**, **OpenClaw**, **OpenDesign**, and **Claude Desktop**.
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
@@ -31,10 +31,10 @@ Heimdall is a portable bootstrap toolkit and quality sentinel for multi-agent so
|
|
|
31
31
|
<a id="1-what-is-heimdall"></a>
|
|
32
32
|
## 1. What is Heimdall?
|
|
33
33
|
|
|
34
|
-
**Heimdall** is an environment bootstrapper and multi-agent coordination layer for AI coding tools.
|
|
34
|
+
**Heimdall** is an environment bootstrapper and multi-agent coordination layer for AI coding tools. More than a skill aggregator, it installs a complete, opinionated **way of working and coding**—combining structured communication, empirical verification, surgical code restraint, and runtime safety hooks into a deterministic, verified engineering environment.
|
|
35
35
|
|
|
36
36
|
Instead of manually maintaining scattered custom instructions, system prompts, and configuration files across different AI clients, Heimdall provides a single source of truth:
|
|
37
|
-
* **Modular Skills**:
|
|
37
|
+
* **Modular Skills**: 69 task-activated capabilities (such as database design, security audits, design token enforcement, progressive disclosure, and debugging) that load on demand instead of wasting prompt tokens.
|
|
38
38
|
* **Specialized Agent Personas**: 10 predefined roles with isolated context windows (`orchestrator`, `tester`, `frontend-designer`, `mobile-designer`, `reviewer`, `security-auditor`, `database-architect`, `code-sentinel`, `modernizer`, `cloud-engineer`).
|
|
39
39
|
* **Universal Doctrine**: Central rules (`AGENTS.md`) synchronized across all harnesses, enforcing planning gates, test-driven development (TDD), and minimal surgical code edits.
|
|
40
40
|
|
|
@@ -56,16 +56,44 @@ Heimdall transforms unconstrained AI coding assistants into disciplined, multi-a
|
|
|
56
56
|
5. **Adversarial Peer Review**: Dispatches context-blinded reviewers to inspect git diffs for edge cases, silent regressions, and unhandled failure branches.
|
|
57
57
|
6. **Intercepts Dangerous Operations**: Evaluates shell commands and file mutations via lifecycle hooks to block destructive root wiping and force-pushes to protected branches.
|
|
58
58
|
|
|
59
|
+
### The Heimdall Way of Working (Beyond a Skill Aggregator)
|
|
60
|
+
|
|
61
|
+
Skills alone do not build reliable software—**engineering discipline does**. Heimdall bakes an end-to-end operating methodology directly into every session:
|
|
62
|
+
|
|
63
|
+
1. **BLUF Communication Architecture (Bottom Line Up Front)** (`communication-doctrine`):
|
|
64
|
+
- Eliminates AI throat-clearing and buried conclusions. Every status report, implementation plan, code review verdict, and subagent handoff opens with the decision, verdict, and blast radius in the **first 1–2 sentences**.
|
|
65
|
+
- Standardized BLUF headers (`Subagent BLUF`, `Review Verdict`, `Plan BLUF`) let coordinators and human engineers parse outcomes in seconds.
|
|
66
|
+
2. **ASD-STE100 Simplified Technical English**:
|
|
67
|
+
- Procedural steps use **active imperative verbs first** (`Create`, `Modify`, `Assert`, `Verify`, `Run`), strict sentence limits (**≤ 20 words per step**), and explicit object naming (no ambiguous pronouns like *"it"* or *"this"*).
|
|
68
|
+
- Enforces a **Zero-Vagueness Lexicon** that bans subjective qualifiers (*"ensure"*, *"properly"*, *"appropriately"*, *"gracefully"*, *"as needed"*, *"robustly"*, *"etc."*)—replacing them with exact, testable conditions.
|
|
69
|
+
3. **Poteto (`pstack` / `brainmaxxing`) & High-Rigor Craftsmanship**:
|
|
70
|
+
- **`pstack-discipline`** (from Lauren Tan / `@poteto`): Enforces *"Prove It Works"* (empirical proof before claiming done), *"Fix Root Causes"* (no symptom-masking guards), *"Test Behavior, Not Implementation"*, *"Subtract Before You Add"*, and *"Sequence Work into Verifiable Units"*.
|
|
71
|
+
- **`ruminate`** (inspired by `poteto/brainmaxxing`): Mines historical Claude and Gemini session transcripts for user corrections, repeated instructions, skill trigger failures, and doctrine drift—turning past friction into permanent memory files and skill amendments.
|
|
72
|
+
- Paired with **`thermo`** ("Code Judo" maintainability audits), **`karpathy-guidelines`** (minimal surgical edits), **`clean-code`** (`ub-mode`), **`ponytail`** (Dietrich Gebert's Decision Ladder), and **`modern-web-guidance`** (`GoogleChrome/modern-web-guidance`).
|
|
73
|
+
4. **Self-Healing Sessions & Context Continuity (`ruminate` + `handoff` + Context Sentinel)**:
|
|
74
|
+
- Heimdall learns from its own history: rules in `handoff` (auto-handoff on coherence degradation) and `writing-plans` (spec-coverage completeness gate) were extracted directly from **187 historical sessions via `/ruminate`**.
|
|
75
|
+
- During active sessions, the **Context Sentinel** ([`hooks/heimdall-hook.cjs`](hooks/heimdall-hook.cjs)) tracks turns and estimated token usage against the active model's window (warning at 75% or 40 turns) so `handoff` can persist clean state before context rot sets in.
|
|
76
|
+
5. **Dynamic Cross-Family Model Routing (`lib/model-router.cjs` + `heimdall sync-models`)**:
|
|
77
|
+
- Personas use `model: inherit` with zero vendor lock-in. `heimdall sync-models` and [`lib/model-router.cjs`](lib/model-router.cjs) dynamically classify model capabilities, map personas to capability tiers (`deep_reasoning`, `surgical_restraint`, `adversarial_diff_eval`), and select **cross-family reviewers** (e.g., Gemini audited by Claude, Codex, GLM, Hunyuan, or MiMo).
|
|
78
|
+
6. **Token, Ceremony & Diff Restraint (`progressive-disclosure` + `caveman` + `ponytail`)**:
|
|
79
|
+
- `progressive-disclosure` loads skills on demand to cut prompt overhead, `caveman` strips conversational ceremony, and `ponytail` (*Lazy Senior Dev Mode*, `lite` / `full` / `ultra`) enforces the smallest complete diff and a concise reply a busy engineer understands in one read.
|
|
80
|
+
7. **Matt Pocock Real Engineering Pipeline ([`mattpocock/skills`](https://github.com/mattpocock/skills)) & Karpathy 4 Pillars (`karpathy-guidelines`)**:
|
|
81
|
+
- **Pre-code → Architecture → Tickets**: `grill-me` (Design Tree Frontier) → `wayfinder` (settled vs. frontier vs. fog) → `domain-modeling` (`GLOSSARY.md` & ADRs) → `to-spec` (invariants) → `to-tickets` (tracer-bullet tickets) → `codebase-design` / `improve-codebase-architecture` (deep modules) → `handoff`.
|
|
82
|
+
- **Karpathy 4 Pillars**: *Think Before Coding* (surface assumptions), *Simplicity First* (no speculative helpers), *Surgical Changes* (touch only task lines), and *Goal-Driven Execution* (verifiable pass criteria first), backed by the 800-line `PreToolUse (Write)` hook.
|
|
83
|
+
8. **Controlled Upstream Skill Sync (`upstream-skill-sync`)**:
|
|
84
|
+
- Classifies every skill in `config/skills.json` as `mirror`, `adapted`, or `native` and triages upstream changes into **Tier 1 (Safe 1:1)**, **Tier 2 (Selective Merge)**, or **Tier 3 (Reject)** after `snyk-agent-scan` security checks.
|
|
85
|
+
|
|
59
86
|
### Comparison: Vanilla AI Coding vs. Heimdall
|
|
60
87
|
|
|
61
88
|
| Area | Vanilla AI Coding | With Heimdall |
|
|
62
89
|
| :--- | :--- | :--- |
|
|
63
90
|
| **Initial Prompt** | AI immediately generates 300 lines of unverified code. | **Interactive Gate**: AI pauses, interrogates edge cases, and presents 2 architectural options. |
|
|
64
|
-
| **
|
|
65
|
-
| **Code
|
|
66
|
-
| **
|
|
67
|
-
| **
|
|
68
|
-
| **
|
|
91
|
+
| **Communication** | Verbose prose, buried verdicts, and vague *"ensure it works properly"* steps. | **BLUF + ASD-STE100**: Verdict in lines 1–2; imperative, ≤20-word testable steps. |
|
|
92
|
+
| **Code Review** | AI rubber-stamps its own code with conversational praise. | **Context-Blinded Review**: Stateless Goldfish reviewer inspects diffs without conversational bias. |
|
|
93
|
+
| **Code Restraint** | Bloated wrappers, defensive boilerplate, speculative options. | **Karpathy & `pstack` Discipline**: Subtract before adding, fix root causes, surgical edits only. |
|
|
94
|
+
| **Verification** | AI claims "done!" without testing or relies on shallow checks. | **TDD & Playwright**: Failing test first; empirical proof via tests and browser DOM assertions. |
|
|
95
|
+
| **Safety** | AI can launch hanging dev servers, run `rm -rf`, or force push `main`. | **Lifecycle Hooks**: Blocks dev servers, destructive commands, secrets, and force pushes at runtime and Git level. |
|
|
96
|
+
| **Configuration** | Scattered, drifting prompt files across multiple tools. | **Single Source of Truth**: Linked via native junctions/symlinks in 1 second; self-audited via `ruminate`. |
|
|
69
97
|
|
|
70
98
|
[↑ Back to top](#table-of-contents)
|
|
71
99
|
|
|
@@ -82,7 +110,7 @@ When Heimdall bootstraps, it establishes live junctions (Windows) or symlinks (P
|
|
|
82
110
|
|
|
83
111
|
| Source in Heimdall | Deployed Location | Purpose |
|
|
84
112
|
| :--- | :--- | :--- |
|
|
85
|
-
| `skills/` | `~/.<tool>/skills/` |
|
|
113
|
+
| `skills/` | `~/.<tool>/skills/` | 69 domain toolkits loaded progressively on demand. |
|
|
86
114
|
| `agents/` | `~/.<tool>/agents/` | 10 specialized agent persona definitions. |
|
|
87
115
|
| `hooks/` | `~/.claude/hooks/` | Event-driven lifecycle hooks for Claude Code CLI. |
|
|
88
116
|
| `hooks/git/` | `.git/hooks/` (optional) | Universal native Git pre-push hook for all tools. |
|
|
@@ -107,18 +135,20 @@ Heimdall adopts the core division of labor from [`google/elephant-goldfish-model
|
|
|
107
135
|
|
|
108
136
|
### 3. Event-Driven Lifecycle Hooks
|
|
109
137
|
|
|
110
|
-
Heimdall includes zero-dependency runtime hooks ([`hooks/heimdall-hook.cjs`](hooks/heimdall-hook.cjs)) registered in `~/.claude/settings.json`:
|
|
138
|
+
Heimdall includes zero-dependency runtime hooks ([`hooks/heimdall-hook.cjs`](hooks/heimdall-hook.cjs)) declared in [`hooks/hooks.json`](hooks/hooks.json) and registered in `~/.claude/settings.json`:
|
|
111
139
|
|
|
140
|
+
* **`UserPromptSubmit`**:
|
|
141
|
+
- **Communication Doctrine Injection**: Reinforces BLUF (conclusion in first 1–2 sentences) and ASD-STE100 rules (imperative verb first, ≤20 words/step, zero banned qualifiers) on every prompt.
|
|
112
142
|
* **`PreToolUse` (Bash/PowerShell)**:
|
|
113
143
|
- **Blocks Destructive Commands**: Halts operations like `rm -rf /` or `rmdir /s /q C:\` (exit code 2).
|
|
144
|
+
- **Strict Zero Dev-Server Policy**: Blocks hanging dev server commands (`npm run dev`, `vite`, `next dev`, `uvicorn`, `python manage.py runserver`) and enforces non-interactive terminating checks.
|
|
114
145
|
- **Branch-Aware Force Push Protection**: Blocks `git push --force` targeting `main`, `master`, `release`, or `production` (explicitly or while checked out on those branches). Force pushes to feature branches (`feature/*`, `bugfix/*`) are permitted with an advisory.
|
|
115
146
|
- **Blocks Secret Commits**: Halts staging unencrypted `.env`, `id_rsa`, or `*.pem` files.
|
|
147
|
+
- **Context Sentinel**: Tracks session turns and estimated token usage against the active model's context limit, warning at 75% capacity or 40 turns.
|
|
116
148
|
* **`PreToolUse` (Write)**:
|
|
117
|
-
- **Karpathy Restraint Warning**: Emits an advisory if an AI attempts to generate a single file exceeding 800 lines.
|
|
118
|
-
* **`PostToolUse` (Edit/Write)**:
|
|
119
|
-
- **Verification Reminder**: Emits a reminder to run automated tests or browser verification before concluding.
|
|
149
|
+
- **Karpathy Restraint Warning**: Emits an advisory if an AI attempts to generate a single file exceeding 800 lines (exempting HTML/SVG/OpenDesign canvas artifacts) and updates Context Sentinel tracking.
|
|
120
150
|
* **`PreCompact`**:
|
|
121
|
-
- **Compaction State Reminder**:
|
|
151
|
+
- **Compaction State Reset & Reminder**: Clears temporary session tracking state and reminds the agent to persist active tasks, rulings, and pending ledger items to disk before context compression.
|
|
122
152
|
* **Universal Native Git Pre-Push Hook** ([`hooks/git/pre-push`](hooks/git/pre-push)):
|
|
123
153
|
- Shell hook installable into any repository (`.git/hooks/pre-push`) that blocks non-fast-forward pushes to `main`/`master` universally across all AI harnesses and terminal users.
|
|
124
154
|
|
|
@@ -152,10 +182,10 @@ Select a profile tier based on your machine and workflow needs:
|
|
|
152
182
|
|
|
153
183
|
| Profile | Skills | Predefined Agents | Description | Best For |
|
|
154
184
|
| :--- | :---: | :---: | :--- | :--- |
|
|
155
|
-
| **`full`** *(Default)* |
|
|
185
|
+
| **`full`** *(Default)* | 69 | 10 | Complete engineering suite: planning, design, security, database, hygiene. | Everyday development across all tools |
|
|
156
186
|
| **`minimal`** | 16 | 4 | Lean core: `orchestrator`, `tester`, `code-sentinel`, `reviewer`. | Lightweight laptops, smaller context windows |
|
|
157
187
|
| **`security`** | 12 | 4 | AppSec suite: `orchestrator`, `security-auditor`, `tester`, `reviewer`. | Penetration testing & pre-deployment audits |
|
|
158
|
-
| **`design`** |
|
|
188
|
+
| **`design`** | 13 | 4 | Frontend & mobile: `orchestrator`, `frontend-designer`, `mobile-designer`, `code-sentinel`. | UI/UX design and design-system work |
|
|
159
189
|
|
|
160
190
|
To deploy a specific profile:
|
|
161
191
|
```powershell
|
|
@@ -177,6 +207,41 @@ Heimdall automatically discovers and configures installed AI tools:
|
|
|
177
207
|
| **OpenDesign** | `open-design` on PATH / `.opendesign` | Automatic visual canvas mode: bypasses Turn 1 grilling gate, preserves `data-od-*` attributes & applies `taste-skill` + `antislop-ui` |
|
|
178
208
|
| **Claude Desktop** | `%APPDATA%\Claude` | Auto-configures Context7 MCP and playbooks in `claude_desktop_config.json` |
|
|
179
209
|
|
|
210
|
+
### MCP Server Architecture
|
|
211
|
+
|
|
212
|
+
Heimdall manages Model Context Protocol (MCP) servers through a **template-based resolver** that eliminates Windows `npx` process multiplication and keeps configuration consistent across all installed harnesses.
|
|
213
|
+
|
|
214
|
+
#### How It Works
|
|
215
|
+
|
|
216
|
+
1. **Global Package Install**: During setup (`node setup.mjs`), Heimdall automatically installs required MCP packages globally via `npm install -g`:
|
|
217
|
+
- `@upstash/context7-mcp` — up-to-date library documentation queries
|
|
218
|
+
- `chrome-devtools-mcp` — browser automation and performance profiling
|
|
219
|
+
|
|
220
|
+
2. **Template Resolution**: The portable template at `config/mcp.template.json` declares server definitions with `{{PLACEHOLDER}}` tokens and `resolve` hints. The resolver script (`scripts/resolve-mcp.mjs`) detects local paths at runtime and generates `config/mcp.resolved.json` with direct `node.exe` entrypoints.
|
|
221
|
+
|
|
222
|
+
3. **Dynamic Harness Detection**: The resolver syncs to **every installed harness** by checking for config file existence — it does not hardcode a fixed set of targets:
|
|
223
|
+
- Gemini → `~/.gemini/config/mcp_config.json` (JSON)
|
|
224
|
+
- Claude Code → `~/.claude/settings.json` (JSON)
|
|
225
|
+
- Codex CLI → `~/.codex/config.toml` (TOML `[mcp_servers.*]`)
|
|
226
|
+
- Hermes → `%LOCALAPPDATA%\hermes\config.yaml` (YAML `mcp_servers:`)
|
|
227
|
+
- Any future harness added to the resolver is auto-detected on next sync
|
|
228
|
+
|
|
229
|
+
4. **Direct `node.exe` Invocation**: Resolved configs use `C:\Program Files\nodejs\node.exe <entrypoint.js>` instead of `npx`, spawning exactly **1 process per server per session** with zero `cmd.exe` wrappers and zero orphan multiplication on exit.
|
|
230
|
+
|
|
231
|
+
#### Daily MCP Commands
|
|
232
|
+
|
|
233
|
+
```powershell
|
|
234
|
+
# Re-resolve paths and sync to all installed harnesses (after toggling servers or updating packages)
|
|
235
|
+
/mcp-sync
|
|
236
|
+
|
|
237
|
+
# Kill orphaned MCP processes left behind by crashed sessions
|
|
238
|
+
/mcp-cleanup
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
#### Disabling Heavy Servers
|
|
242
|
+
|
|
243
|
+
Edit `config/mcp.template.json` and set `"disabled": true` on any server (e.g., `chrome-devtools`) to prevent it from spawning in new sessions. Run `/mcp-sync` after editing.
|
|
244
|
+
|
|
180
245
|
[↑ Back to top](#table-of-contents)
|
|
181
246
|
|
|
182
247
|
---
|
|
@@ -289,28 +354,28 @@ All personas declare `model: inherit` to run on whichever active model or vendor
|
|
|
289
354
|
|
|
290
355
|
| Persona | Capability Tier | Role & Responsibilities | Bound Skills |
|
|
291
356
|
| :--- | :--- | :--- | :--- |
|
|
292
|
-
| **`orchestrator`** | `deep_reasoning` | Planning gatekeeper (`/grill-me`), requirements interrogation, modular task decomposition, Playwright E2E verification enforcement, and subagent coordination. | `brainstorming`, `writing-plans`, `pstack-discipline`, `subagent-driven-development`, `dispatching-parallel-agents`, `using-git-worktrees`, `writing-skills`, `executing-plans`, `herdr` |
|
|
293
|
-
| **`frontend-designer`** | `high_polish_vision` | Enforces design read, typography hierarchy, token mappings, and anti-slop UI aesthetics for web surfaces. | `taste-skill`, `brandkit`, `minimalist-skill`, `brutalist-skill`, `soft-skill`, `antislop-ui`, `antislop-human`, `stitch-skill`, `image-to-code-skill`, `imagegen-frontend-web`, `redesign-skill` |
|
|
357
|
+
| **`orchestrator`** | `deep_reasoning` | Planning gatekeeper (`/grill-me`), requirements interrogation, modular task decomposition, Playwright E2E verification enforcement, and subagent coordination. | `grill-me`, `brainstorming`, `writing-plans`, `to-spec`, `to-tickets`, `wayfinder`, `domain-modeling`, `handoff`, `pstack-discipline`, `subagent-driven-development`, `dispatching-parallel-agents`, `using-git-worktrees`, `writing-skills`, `executing-plans`, `herdr`, `upstream-skill-sync` |
|
|
358
|
+
| **`frontend-designer`** | `high_polish_vision` | Enforces design read, typography hierarchy, token mappings, and anti-slop UI aesthetics for web surfaces. | `taste-skill`, `brandkit`, `minimalist-skill`, `brutalist-skill`, `soft-skill`, `antislop-ui`, `antislop-human`, `stitch-skill`, `image-to-code-skill`, `imagegen-frontend-web`, `redesign-skill`, `modern-web-guidance` |
|
|
294
359
|
| **`mobile-designer`** | `responsive_flex_safety` | Mobile viewport safety (320px–430px), 48px touch targets, zero-clipping overflow flex containers, and responsive assets. | `antislop-layoutmobile`, `antislop-human`, `antislop-ui`, `imagegen-frontend-mobile`, `taste-skill` |
|
|
295
360
|
| **`tester`** | `fast_verification` | Enforces strict Test-Driven Development (TDD) and browser verification (Playwright). Rejects pseudo-verification (`curl`, `grep`, `tsc`). | `test-driven-development`, `verification-before-completion`, `systematic-debugging`, `executing-plans` |
|
|
296
361
|
| **`security-auditor`** | `deep_assurance_audit` | Dynamic differential HTTP probing across auth levels, OWASP Top 10 defenses, and Trail of Bits insecure defaults detection. | `strix-security`, `security-audit-sweep`, `owasp-security`, `cloudflare-security-audit`, `snyk-agent-scan`, `trailofbits-audit-context`, `trailofbits-insecure-defaults`, `trailofbits-triage-brocards` |
|
|
297
362
|
| **`database-architect`** | `schema_migration_safety` | Governs non-destructive migrations, normalization, query plan audits (`EXPLAIN ANALYZE`), and connection pooling (Postgres/Supabase, SQLite, MySQL). | `postgres-best-practices`, `systematic-debugging`, `karpathy-guidelines` |
|
|
298
|
-
| **`code-sentinel`** | `surgical_restraint` | Karpathy simplicity: writes minimal surgical code, strips boilerplate comments, purges defensive dead code, and
|
|
299
|
-
| **`reviewer`** | `adversarial_diff_eval` | Performs adversarial diff analysis,
|
|
300
|
-
| **`modernizer`** | `legacy_migration_safety` | Executes legacy codebase transformations, runtime upgrades, and Strangler Fig migrations guarded by Golden Master characterization tests. | `test-driven-development`, `verification-before-completion`, `systematic-debugging`, `karpathy-guidelines`, `project-hygiene`, `output-skill` |
|
|
363
|
+
| **`code-sentinel`** | `surgical_restraint` | Karpathy simplicity: writes minimal surgical code, strips boilerplate comments, purges defensive dead code, enforces deep modules, and applies anti-slop standards. | `communication-doctrine`, `karpathy-guidelines`, `clean-code`, `codebase-design`, `ponytail`, `antislop`, `antislop-code`, `antislop-copywriting`, `antislop-human`, `finishing-a-development-branch` |
|
|
364
|
+
| **`reviewer`** | `adversarial_diff_eval` | Performs adversarial diff analysis, audits module depth and leaky abstractions, catches silent regressions, executes thermo maintainability reviews, and coordinates cross-model validation reviews. | `communication-doctrine`, `thermo`, `codebase-design`, `requesting-code-review`, `receiving-code-review`, `claude-collaborator`, `gemini-collaborator`, `codex-collaborator`, `using-superpowers`, `diagnosing-superpowers`, `output-skill` |
|
|
365
|
+
| **`modernizer`** | `legacy_migration_safety` | Executes legacy codebase transformations, runtime upgrades, dependency uncoupling, and Strangler Fig migrations guarded by Golden Master characterization tests. | `test-driven-development`, `verification-before-completion`, `systematic-debugging`, `improve-codebase-architecture`, `codebase-design`, `karpathy-guidelines`, `project-hygiene`, `output-skill`, `modern-web-guidance`, `upstream-skill-sync` |
|
|
301
366
|
| **`cloud-engineer`** | `infra_container_safety` | Governs containerization (Docker, Compose), Kubernetes manifests, Infrastructure as Code (Terraform), reverse proxies (Caddy, Nginx), CI/CD automation, and terminating verification. | `communication-doctrine`, `karpathy-guidelines`, `clean-code`, `systematic-debugging`, `project-hygiene`, `progressive-disclosure` |
|
|
302
367
|
|
|
303
368
|
---
|
|
304
369
|
|
|
305
|
-
<a id="skill-inventory-
|
|
306
|
-
### Skill Inventory (
|
|
370
|
+
<a id="skill-inventory-69-modules-across-30-toolkits"></a>
|
|
371
|
+
### Skill Inventory (69 Modules Across 30 Toolkits)
|
|
307
372
|
|
|
308
|
-
Heimdall organizes capabilities into **
|
|
373
|
+
Heimdall organizes capabilities into **6 Core Multi-Skill Suites (45 modules)** and **24 Standalone Toolkits (24 modules)**:
|
|
309
374
|
|
|
310
|
-
#### Core Multi-Skill Suites (
|
|
375
|
+
#### Core Multi-Skill Suites (6 Suites / 45 Modules)
|
|
311
376
|
|
|
312
377
|
<details open>
|
|
313
|
-
<summary><b>1. Superpowers Engineering Suite (15 modules) —
|
|
378
|
+
<summary><b>1. Superpowers Engineering Suite (15 modules) — <a href="https://github.com/obra/superpowers">obra/superpowers</a></b></summary>
|
|
314
379
|
|
|
315
380
|
- `brainstorming`: Surfaces implicit assumptions and explores alternatives before design lock.
|
|
316
381
|
- `writing-plans`: Structures modular, bite-sized tasks with verifiable completion criteria.
|
|
@@ -331,7 +396,7 @@ Heimdall organizes capabilities into **5 Core Multi-Skill Suites (37 modules)**
|
|
|
331
396
|
</details>
|
|
332
397
|
|
|
333
398
|
<details>
|
|
334
|
-
<summary><b>2. Taste Design & Aesthetic Studio (10 modules)</b></summary>
|
|
399
|
+
<summary><b>2. Taste Design & Aesthetic Studio (10 modules) — <a href="https://github.com/Leonxlnx/taste-skill">Leonxlnx/taste-skill</a></b></summary>
|
|
335
400
|
|
|
336
401
|
- `taste-skill`: Enforces cohesive design reads, purpose-driven typography, and brand-first color logic.
|
|
337
402
|
- `brandkit`: Manages design tokens, invariant brand assets, and multi-palette themes.
|
|
@@ -347,7 +412,7 @@ Heimdall organizes capabilities into **5 Core Multi-Skill Suites (37 modules)**
|
|
|
347
412
|
</details>
|
|
348
413
|
|
|
349
414
|
<details>
|
|
350
|
-
<summary><b>3. Anti-Slop Quality Suite (6 modules) —
|
|
415
|
+
<summary><b>3. Anti-Slop Quality Suite (6 modules) — <a href="https://github.com/miqdadbadjuber/anti-slop">miqdadbadjuber/anti-slop</a></b></summary>
|
|
351
416
|
|
|
352
417
|
- `antislop`: Core guardrail prohibiting generic AI filler, fake buzzwords, and decorative bloat.
|
|
353
418
|
- `antislop-code`: Prohibits redundant comments, defensive dead code, and speculative abstractions.
|
|
@@ -368,7 +433,7 @@ Heimdall organizes capabilities into **5 Core Multi-Skill Suites (37 modules)**
|
|
|
368
433
|
</details>
|
|
369
434
|
|
|
370
435
|
<details>
|
|
371
|
-
<summary><b>5. Trail of Bits High-Assurance AppSec Suite (3 modules) —
|
|
436
|
+
<summary><b>5. Trail of Bits High-Assurance AppSec Suite (3 modules) — <a href="https://github.com/trailofbits/skills">trailofbits/skills</a></b></summary>
|
|
372
437
|
|
|
373
438
|
- `trailofbits-audit-context`: High-assurance code assumption, guarantee, and architectural dependency mapping.
|
|
374
439
|
- `trailofbits-insecure-defaults`: Detection of insecure default configurations, fail-open patterns, and permissive access.
|
|
@@ -376,7 +441,7 @@ Heimdall organizes capabilities into **5 Core Multi-Skill Suites (37 modules)**
|
|
|
376
441
|
|
|
377
442
|
</details>
|
|
378
443
|
|
|
379
|
-
#### Standalone Toolkits (
|
|
444
|
+
#### Standalone Toolkits (24 Curated Toolkits / 24 Modules)
|
|
380
445
|
|
|
381
446
|
<details open>
|
|
382
447
|
<summary><b>Browse Standalone Toolkits</b></summary>
|
|
@@ -400,6 +465,11 @@ Heimdall organizes capabilities into **5 Core Multi-Skill Suites (37 modules)**
|
|
|
400
465
|
- **`progressive-disclosure`**: Anthropic & Google-aligned 3-layer progressive disclosure standard cutting prompt overhead by >80% and preventing subagent sprawl.
|
|
401
466
|
- **`project-hygiene`**: Sweeps workspaces for dead code, unused exports, circular dependencies, and stale build caches.
|
|
402
467
|
- **`output-skill`**: Guarantees unabridged LLM output without ellipses (`...`), incomplete code blocks, or truncation.
|
|
468
|
+
- **`ruminate`**: Mines historical Claude and Gemini session transcripts for correction patterns, repeated preferences, skill trigger failures, doctrine violations, and cross-agent consistency drift. Writes findings as memory files or skill amendments. Inspired by [poteto/brainmaxxing](https://github.com/poteto/brainmaxxing).
|
|
469
|
+
- **`modern-web-guidance`**: Google Chrome's official modern web platform skill pack (`GoogleChrome/modern-web-guidance`). Steers agents toward Baseline-safe native HTML/CSS/JS APIs, Core Web Vitals (LCP/INP/CLS) best practices, and `legacy-scan` frontend modernization.
|
|
470
|
+
- **`mcp-cleanup`**: Kills orphaned MCP server processes left behind by crashed or closed agent sessions.
|
|
471
|
+
- **`mcp-sync`**: Resolves the Heimdall MCP template to local paths and syncs across installed agent harnesses.
|
|
472
|
+
- **`upstream-skill-sync`**: Audits upstream skill repositories in `config/skills.json` and classifies updates into Safe 1:1, Selective Merge, or Reject.
|
|
403
473
|
|
|
404
474
|
</details>
|
|
405
475
|
|
package/README.pt-BR.md
CHANGED
|
@@ -4,13 +4,13 @@
|
|
|
4
4
|
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" alt="License: MIT" /></a>
|
|
5
5
|
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18.0.0-339933.svg?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 18" /></a>
|
|
6
6
|
<a href="#10-personas-de-agentes-predefinidas"><img src="https://img.shields.io/badge/agents-10%20predefinidos-orange.svg?style=flat-square" alt="Agentes: 10 Predefinidos" /></a>
|
|
7
|
-
<a href="#inventario-de-skills-
|
|
7
|
+
<a href="#inventario-de-skills-69-modulos-em-30-toolkits"><img src="https://img.shields.io/badge/skills-30%20toolkits%20%2869%20m%C3%B3dulos%29-blueviolet.svg?style=flat-square" alt="Skills: 30 Toolkits (69 Módulos)" /></a>
|
|
8
8
|
<a href="#ferramentas-e-runtimes-suportados"><img src="https://img.shields.io/badge/runtimes-Antigravity%20%7C%20Claude%20%7C%20Codex%20%7C%20Hermes%20%7C%20OpenClaw-black.svg?style=flat-square" alt="Runtimes" /></a>
|
|
9
9
|
</p>
|
|
10
10
|
|
|
11
11
|
🌐 **Idioma / Language:** [English](README.md) | **Português (Brasil)**
|
|
12
12
|
|
|
13
|
-
O Heimdall é um toolkit portátil de bootstrap e sentinela de qualidade para engenharia de software multi-agente. Ele impõe portões de planejamento antes da geração de código, previne *AI slop* (código e texto genérico de IA), isola fronteiras de módulos e sincroniza **10 personas de agentes especializados** e **
|
|
13
|
+
O Heimdall é um toolkit portátil de bootstrap e sentinela de qualidade para engenharia de software multi-agente. Ele impõe portões de planejamento antes da geração de código, previne *AI slop* (código e texto genérico de IA), isola fronteiras de módulos e sincroniza **10 personas de agentes especializados** e **69 skills modulares** entre **Google Antigravity**, **Claude Code**, **OpenAI Codex CLI**, **Hermes Agent**, **OpenClaw**, **OpenDesign** e **Claude Desktop**.
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
@@ -31,10 +31,10 @@ O Heimdall é um toolkit portátil de bootstrap e sentinela de qualidade para en
|
|
|
31
31
|
<a id="1-o-que-e-o-heimdall"></a>
|
|
32
32
|
## 1. O que é o Heimdall?
|
|
33
33
|
|
|
34
|
-
O **Heimdall** é um bootstrapper de ambiente e camada de coordenação multi-agente para ferramentas de programação com IA.
|
|
34
|
+
O **Heimdall** é um bootstrapper de ambiente e camada de coordenação multi-agente para ferramentas de programação com IA. Mais do que um agregador de skills, ele instala uma **maneira completa e opinativa de trabalhar e programar**—combinando comunicação estruturada, prova empírica, contenção cirúrgica de código e hooks de segurança em tempo de execução para construir um ambiente de engenharia determinístico e verificado.
|
|
35
35
|
|
|
36
36
|
Em vez de manter manualmente instruções customizadas, prompts de sistema e arquivos de configuração espalhados em diferentes clientes de IA, o Heimdall fornece uma fonte única da verdade (*Single Source of Truth*):
|
|
37
|
-
* **Skills Modulares**:
|
|
37
|
+
* **Skills Modulares**: 69 capacidades ativadas sob demanda por tarefa (como modelagem de banco de dados, auditoria de segurança, aplicação de design tokens, divulgação progressiva e depuração sistemática) que carregam apenas quando necessário, economizando tokens de contexto.
|
|
38
38
|
* **Personas de Agentes Especializados**: 10 papéis predefinidos com janelas de contexto isoladas (`orchestrator`, `tester`, `frontend-designer`, `mobile-designer`, `reviewer`, `security-auditor`, `database-architect`, `code-sentinel`, `modernizer`, `cloud-engineer`).
|
|
39
39
|
* **Doutrina Universal**: Regras centrais (`AGENTS.md`) sincronizadas em todas as ferramentas, exigindo portões de planejamento, desenvolvimento orientado a testes (TDD) e edições cirúrgicas mínimas.
|
|
40
40
|
|
|
@@ -56,16 +56,44 @@ O Heimdall transforma assistentes de código comuns em equipes de engenharia mul
|
|
|
56
56
|
5. **Revisão de Código Adversarial**: Despacha revisores sem viés de contexto conversacional para inspecionar `git diffs` em busca de casos de borda, regressões silenciosas e falhas não tratadas.
|
|
57
57
|
6. **Intercepta Operações Perigosas**: Avalia comandos shell e mutações de arquivos por meio de hooks de ciclo de vida para bloquear exclusões destrutivas na raiz e *force-pushes* em branches protegidas.
|
|
58
58
|
|
|
59
|
+
### A Forma de Trabalhar do Heimdall (Além de um Agregador de Skills)
|
|
60
|
+
|
|
61
|
+
Skills isoladas não constroem software confiável—**disciplina de engenharia constrói**. O Heimdall incorpora uma metodologia operacional completa em cada sessão:
|
|
62
|
+
|
|
63
|
+
1. **Arquitetura de Comunicação BLUF (*Bottom Line Up Front*)** (`communication-doctrine`):
|
|
64
|
+
- Elimina rodeios e conclusões escondidas no final da resposta. Todo relatório de status, plano de implementação, veredito de revisão e handoff entre subagentes abre com a decisão, o veredito e o raio de impacto (*blast radius*) nas **primeiras 1–2 frases**.
|
|
65
|
+
- Cabeçalhos padronizados (`Subagent BLUF`, `Review Verdict`, `Plan BLUF`) permitem que coordenadores e engenheiros humanos leiam o resultado em segundos.
|
|
66
|
+
2. **Inglês Técnico Simplificado ASD-STE100**:
|
|
67
|
+
- Passos procedimentais começam com **verbos imperativos ativos** (`Create`, `Modify`, `Assert`, `Verify`, `Run`), respeitam limites rígidos de tamanho (**≤ 20 palavras por passo**) e nomeiam objetos explicitamente (sem pronomes ambíguos como *"it"* ou *"this"*).
|
|
68
|
+
- Impõe um **Léxico de Zero Ambiguidade** que proíbe qualificadores vagos (*"ensure"*, *"properly"*, *"appropriately"*, *"gracefully"*, *"as needed"*, *"robustly"*, *"etc."*), substituindo-os por condições exatas e testáveis.
|
|
69
|
+
3. **Poteto (`pstack` / `brainmaxxing`) e Artesania de Alto Rigor**:
|
|
70
|
+
- **`pstack-discipline`** (de Lauren Tan / `@poteto`): Impõe *"Prove Que Funciona"* (prova empírica antes de declarar concluído), *"Corrija Causas-Raiz"* (sem guardas que mascaram sintomas), *"Teste Comportamento, Não Implementação"*, *"Subtraia Antes de Adicionar"* e *"Sequencie o Trabalho em Unidades Verificáveis"*.
|
|
71
|
+
- **`ruminate`** (inspirado em `poteto/brainmaxxing`): Minera transcrições históricas de sessões Claude e Gemini em busca de correções do usuário, instruções repetidas, falhas de ativação de skills e desvios de doutrina—transformando atrito passado em arquivos de memória permanentes e emendas de skills.
|
|
72
|
+
- Combinado com **`thermo`** (auditorias de manutenibilidade "Code Judo"), **`karpathy-guidelines`** (edições cirúrgicas mínimas), **`clean-code`** (`ub-mode`), **`ponytail`** (Escada de Decisão de Dietrich Gebert) e **`modern-web-guidance`** (`GoogleChrome/modern-web-guidance`).
|
|
73
|
+
4. **Sessões Auto-Evolutivas e Continuidade de Contexto (`ruminate` + `handoff` + Sentinela de Contexto)**:
|
|
74
|
+
- O Heimdall aprende com o próprio histórico: regras no `handoff` (handoff automático ao detectar queda de coerência) e no `writing-plans` (portão de completude de especificação) foram extraídas diretamente de **187 sessões históricas via `/ruminate`**.
|
|
75
|
+
- Durante sessões ativas, o **Sentinela de Contexto** ([`hooks/heimdall-hook.cjs`](hooks/heimdall-hook.cjs)) monitora turnos e uso estimado de tokens contra a janela do modelo ativo (alertando em 75% ou 40 turnos) para que o `handoff` persista o estado limpo antes da degradação do contexto.
|
|
76
|
+
5. **Roteamento Dinâmico Multi-Família de Modelos (`lib/model-router.cjs` + `heimdall sync-models`)**:
|
|
77
|
+
- As personas usam `model: inherit` sem aprisionamento a fornecedor. O `heimdall sync-models` e [`lib/model-router.cjs`](lib/model-router.cjs) classificam capacidades dinamicamente, mapeiam personas para níveis de capacidade (`deep_reasoning`, `surgical_restraint`, `adversarial_diff_eval`) e escolhem **revisores de famílias distintas** (ex.: Gemini auditado por Claude, Codex, GLM, Hunyuan ou MiMo).
|
|
78
|
+
6. **Contenção de Tokens, Cerimônia e Diffs (`progressive-disclosure` + `caveman` + `ponytail`)**:
|
|
79
|
+
- `progressive-disclosure` carrega skills sob demanda para reduzir o custo de prompt, `caveman` remove cerimônia conversacional e `ponytail` (*Modo Dev Sênior Preguiçoso*, `lite` / `full` / `ultra`) garante o menor diff completo e uma resposta direta que um engenheiro ocupado entende em uma leitura.
|
|
80
|
+
7. **Pipeline Matt Pocock ([`mattpocock/skills`](https://github.com/mattpocock/skills)) e os 4 Pilares de Karpathy (`karpathy-guidelines`)**:
|
|
81
|
+
- **Pré-código → Arquitetura → Tickets**: `grill-me` (Árvore de Decisão) → `wayfinder` (resolvido vs. fronteira vs. névoa) → `domain-modeling` (`GLOSSARY.md` e ADRs) → `to-spec` (invariantes) → `to-tickets` (tickets tracer-bullet) → `codebase-design` / `improve-codebase-architecture` (módulos profundos) → `handoff`.
|
|
82
|
+
- **4 Pilares de Karpathy**: *Pensar Antes de Programar* (expor premissas), *Simplicidade Primeiro* (sem helpers especulativos), *Edições Cirúrgicas* (alterar apenas linhas da tarefa) e *Execução Orientada a Metas* (critérios verificáveis antes de editar), reforçados pelo hook `PreToolUse (Write)` de 800 linhas.
|
|
83
|
+
8. **Sincronização Controlada de Skills Upstream (`upstream-skill-sync`)**:
|
|
84
|
+
- Classifica cada skill em `config/skills.json` como `mirror`, `adapted` ou `native` e separa atualizações em **Nível 1 (Seguro 1:1)**, **Nível 2 (Merge Seletivo)** ou **Nível 3 (Rejeitar)** após checagem `snyk-agent-scan`.
|
|
85
|
+
|
|
59
86
|
### Comparação: IA Padrão vs. Com Heimdall
|
|
60
87
|
|
|
61
88
|
| Área | IA Padrão (Vanilla) | Com Heimdall |
|
|
62
89
|
| :--- | :--- | :--- |
|
|
63
90
|
| **Prompt Inicial** | A IA gera imediatamente 300 linhas de código não verificado. | **Portão Interativo**: A IA pausa, questiona casos de borda e apresenta 2 opções arquiteturais. |
|
|
64
|
-
| **
|
|
65
|
-
| **
|
|
66
|
-
| **
|
|
67
|
-
| **
|
|
68
|
-
| **
|
|
91
|
+
| **Comunicação** | Prosa prolixa, vereditos escondidos e passos vagos (*"garanta que funcione bem"*). | **BLUF + ASD-STE100**: Veredito nas linhas 1–2; passos imperativos e testáveis com ≤20 palavras. |
|
|
92
|
+
| **Revisão de Código** | A IA aprova o próprio código com elogios superficiais. | **Revisão Cega ao Contexto**: Revisor Goldfish independente analisa o diff sem viés da conversa. |
|
|
93
|
+
| **Contenção de Código** | Wrappers inchados, código defensivo desnecessário, opções especulativas. | **Disciplina Karpathy & `pstack`**: Subtraia antes de adicionar, corrija causas-raiz, apenas edições cirúrgicas. |
|
|
94
|
+
| **Verificação** | A IA diz "pronto!" sem testar ou usa checagens superficiais. | **TDD & Playwright**: Teste falhando primeiro; prova empírica via testes e asserções de DOM no navegador. |
|
|
95
|
+
| **Segurança Operacional** | A IA pode abrir dev servers travados, rodar `rm -rf` ou dar force push na `main`. | **Hooks de Ciclo de Vida**: Bloqueia dev servers, comandos destrutivos, segredos e force pushes em runtime e no Git. |
|
|
96
|
+
| **Configuração** | Arquivos de prompt espalhados e desatualizados entre várias ferramentas. | **Fonte Única da Verdade**: Vinculada via junctions/symlinks nativos em 1 segundo; autoauditada via `ruminate`. |
|
|
69
97
|
|
|
70
98
|
[↑ Voltar ao topo](#indice)
|
|
71
99
|
|
|
@@ -82,43 +110,45 @@ Durante o bootstrap, o Heimdall cria *junctions* (Windows) ou *symlinks* (POSIX)
|
|
|
82
110
|
|
|
83
111
|
| Origem no Heimdall | Local Implantado | Finalidade |
|
|
84
112
|
| :--- | :--- | :--- |
|
|
85
|
-
| `skills/` | `~/.<ferramenta>/skills/` |
|
|
113
|
+
| `skills/` | `~/.<ferramenta>/skills/` | 69 toolkits de domínio carregados progressivamente sob demanda. |
|
|
86
114
|
| `agents/` | `~/.<ferramenta>/agents/` | 10 definições de personas de agentes especializados. |
|
|
87
115
|
| `hooks/` | `~/.claude/hooks/` | Hooks de ciclo de vida orientados a eventos para o Claude Code CLI. |
|
|
88
116
|
| `hooks/git/` | `.git/hooks/` (opcional) | Hook Git `pre-push` nativo universal para todas as ferramentas. |
|
|
89
117
|
| `doctrine/AGENTS.md` | `~/.claude/CLAUDE.md`<br>`~/.gemini/GEMINI.md`<br>`~/.codex/AGENTS.md`<br>`~/.hermes/AGENTS.md` | Doutrina universal entre agentes e restrições operacionais. |
|
|
90
118
|
| `playbooks/` | `~/.<ferramenta>/playbooks/` | Playbooks operacionais (portão de perguntas, TDD, revisões, planos, backlog & fluxo CR). |
|
|
91
119
|
| `commands/` | `~/.claude/commands/` | Comandos slash (`/orchestrator`, `/orchestrate`, `/plan`, `/grill-me`). |
|
|
92
|
-
| `tools/` | Diretório no `PATH` |
|
|
120
|
+
| `tools/` | Diretório no `PATH` | Executável da CLI `heimdall` e utilitários de inicialização de ambiente. |
|
|
93
121
|
| `docs/designs/` | Raiz do workspace | Localização canônica de planos (`YYYY-MM-DD <nome>.md`); planos verificados vão para `old/`. |
|
|
94
122
|
| `docs/backlog.md` | Raiz do workspace | Ledger canônico de backlog do produto e Change Requests. |
|
|
95
123
|
|
|
96
|
-
### 2.
|
|
124
|
+
### 2. Separação de Contexto: Padrão Elephant-Goldfish (Google EGM)
|
|
97
125
|
|
|
98
126
|
O Heimdall adota a divisão central de trabalho do [`google/elephant-goldfish-model`](https://github.com/google/elephant-goldfish-model):
|
|
99
127
|
|
|
100
|
-
* **O Elefante (
|
|
101
|
-
* **O
|
|
102
|
-
* **
|
|
103
|
-
- **
|
|
104
|
-
- **
|
|
105
|
-
- **
|
|
106
|
-
* **Execução Multi-Modelo Adaptativa**: No Herdr (`HERDR_ENV=1`), o Heimdall
|
|
128
|
+
* **O Elefante (Orquestrador / Memória Longa)**: A sessão principal e a persona [`orchestrator`](#10-personas-de-agentes-predefinidas) preservam a memória contínua, as decisões consolidadas da arquitetura e o contexto de longo prazo.
|
|
129
|
+
* **O Goldfish (Revisores e Testadores com Contexto Cego)**: Subagentes acionados para revisão (`reviewer`) e testes (`tester`) recebem exclusivamente o `git diff` e os critérios de aceitação, sem acesso a justificativas ou debates anteriores. Essa amnésia intencional elimina o viés de confirmação e elogios vazios.
|
|
130
|
+
* **Governança Gradual em 3 Níveis**:
|
|
131
|
+
- **Nível 1 (Correções Rápidas / Bugfix < 50 linhas)**: Sem burocracia. Edição cirúrgica mínima orientada por testes automatizados.
|
|
132
|
+
- **Nível 2 (Funcionalidades Delimitadas)**: Alinhamento ágil de arquitetura com verificação rápida de viabilidade e prontidão.
|
|
133
|
+
- **Nível 3 (Arquitetura e Alto Impacto)**: Especificação formal persistida em disco (`docs/designs/<feature>.md`), revisão em 4 etapas (Visão Geral, Compreensão, Crítica e Prontidão) e ciclo de convergência com até 5 rodadas.
|
|
134
|
+
* **Execução Multi-Modelo Adaptativa**: No ambiente Herdr (`HERDR_ENV=1`), o Heimdall distribui revisões entre modelos distintos (por exemplo, código gerado pelo Gemini sendo auditado pelo Claude ou Codex) em subpainéis nativos; fora do Herdr, recorre a subagentes isolados no mesmo modelo.
|
|
107
135
|
|
|
108
136
|
### 3. Hooks de Ciclo de Vida Orientados a Eventos
|
|
109
137
|
|
|
110
|
-
O Heimdall inclui hooks de execução sem dependências externas ([`hooks/heimdall-hook.cjs`](hooks/heimdall-hook.cjs)) registrados em `~/.claude/settings.json`:
|
|
138
|
+
O Heimdall inclui hooks de execução sem dependências externas ([`hooks/heimdall-hook.cjs`](hooks/heimdall-hook.cjs)) declarados em [`hooks/hooks.json`](hooks/hooks.json) e registrados em `~/.claude/settings.json`:
|
|
111
139
|
|
|
140
|
+
* **`UserPromptSubmit`**:
|
|
141
|
+
- **Injeção da Doutrina de Comunicação**: Reforça BLUF (conclusão nas primeiras 1–2 frases) e regras ASD-STE100 (verbo imperativo primeiro, ≤20 palavras/passo, zero qualificadores proibidos) a cada prompt.
|
|
112
142
|
* **`PreToolUse` (Bash/PowerShell)**:
|
|
113
143
|
- **Bloqueia Comandos Destrutivos**: Interrompe operações como `rm -rf /` ou `rmdir /s /q C:\` (exit code 2).
|
|
144
|
+
- **Política Estrita de Zero Dev-Server**: Bloqueia comandos de dev server (`npm run dev`, `vite`, `next dev`, `uvicorn`, `python manage.py runserver`) e exige verificações terminantes não interativas.
|
|
114
145
|
- **Proteção de Force Push Sensível à Branch**: Bloqueia `git push --force` direcionado a `main`, `master`, `release` ou `production` (explicitamente ou quando posicionado nessas branches). Force pushes em branches de trabalho (`feature/*`, `bugfix/*`) são permitidos com aviso.
|
|
115
146
|
- **Bloqueia Commits de Segredos**: Impede o stage de arquivos `.env`, `id_rsa` ou `*.pem` não criptografados.
|
|
147
|
+
- **Sentinela de Contexto (*Context Sentinel*)**: Rastreia turnos da sessão e estimativa de tokens contra o limite do modelo ativo, emitindo alerta em 75% da capacidade ou 40 turnos.
|
|
116
148
|
* **`PreToolUse` (Write)**:
|
|
117
|
-
- **Aviso de Contenção Karpathy**: Emite alerta caso a IA tente gerar um único arquivo com mais de 800 linhas.
|
|
118
|
-
* **`PostToolUse` (Edit/Write)**:
|
|
119
|
-
- **Lembrete de Verificação**: Lembra o agente de rodar suítes de teste automatizadas ou verificação no navegador antes de concluir.
|
|
149
|
+
- **Aviso de Contenção Karpathy**: Emite alerta caso a IA tente gerar um único arquivo com mais de 800 linhas (isentando artefatos HTML/SVG/canvas OpenDesign) e atualiza o rastreamento do Sentinela de Contexto.
|
|
120
150
|
* **`PreCompact`**:
|
|
121
|
-
- **
|
|
151
|
+
- **Reset e Lembrete Pré-Compactação**: Limpa o estado temporário da sessão e lembra o agente de salvar tarefas ativas, decisões e itens pendentes em disco antes da compressão de contexto.
|
|
122
152
|
* **Hook Git Pre-Push Nativo Universal** ([`hooks/git/pre-push`](hooks/git/pre-push)):
|
|
123
153
|
- Hook shell instalável em qualquer repositório (`.git/hooks/pre-push`) que bloqueia pushes non-fast-forward para `main`/`master` em todas as ferramentas de IA e terminais.
|
|
124
154
|
|
|
@@ -152,10 +182,10 @@ Escolha o perfil de acordo com sua máquina e fluxo de trabalho:
|
|
|
152
182
|
|
|
153
183
|
| Perfil | Skills | Agentes Predefinidos | Descrição | Ideal Para |
|
|
154
184
|
| :--- | :---: | :---: | :--- | :--- |
|
|
155
|
-
| **`full`** *(Padrão)* |
|
|
185
|
+
| **`full`** *(Padrão)* | 69 | 10 | Suíte completa de engenharia: planejamento, design, segurança, banco de dados e higiene. | Desenvolvimento diário em todas as ferramentas |
|
|
156
186
|
| **`minimal`** | 16 | 4 | Núcleo enxuto: `orchestrator`, `tester`, `code-sentinel`, `reviewer`. | Notebooks leves, janelas de contexto menores |
|
|
157
187
|
| **`security`** | 12 | 4 | Suíte AppSec: `orchestrator`, `security-auditor`, `tester`, `reviewer`. | Pentest e auditorias pré-deploy |
|
|
158
|
-
| **`design`** |
|
|
188
|
+
| **`design`** | 13 | 4 | Frontend e mobile: `orchestrator`, `frontend-designer`, `mobile-designer`, `code-sentinel`. | Design de UI/UX e design systems |
|
|
159
189
|
|
|
160
190
|
Para implantar um perfil específico:
|
|
161
191
|
```powershell
|
|
@@ -177,6 +207,41 @@ O Heimdall detecta e configura automaticamente as ferramentas de IA instaladas:
|
|
|
177
207
|
| **OpenDesign** | `open-design` no PATH / `.opendesign` | Modo automático de canvas visual: dispensa portões de perguntas no turno 1, preserva atributos `data-od-*` e aplica `taste-skill` + `antislop-ui` |
|
|
178
208
|
| **Claude Desktop** | `%APPDATA%\Claude` | Configura automaticamente o MCP Context7 e playbooks no `claude_desktop_config.json` |
|
|
179
209
|
|
|
210
|
+
### Arquitetura de servidores MCP
|
|
211
|
+
|
|
212
|
+
O Heimdall gerencia servidores Model Context Protocol (MCP) por meio de um resolvedor baseado em templates que elimina a multiplicação de processos do `npx` no Windows e mantém a configuração consistente em todos os harnesses instalados.
|
|
213
|
+
|
|
214
|
+
#### Como funciona
|
|
215
|
+
|
|
216
|
+
1. **Instalação global de pacotes**: durante a instalação (`node setup.mjs`), o Heimdall instala automaticamente os pacotes MCP necessários via `npm install -g`:
|
|
217
|
+
* `@upstash/context7-mcp` para consultas atualizadas de documentação de bibliotecas
|
|
218
|
+
* `chrome-devtools-mcp` para automação de navegador e profiling de performance
|
|
219
|
+
|
|
220
|
+
2. **Resolução de templates**: o template portátil em `config/mcp.template.json` declara definições de servidores com tokens `{{PLACEHOLDER}}` e hints de resolução. O script resolvedor (`scripts/resolve-mcp.mjs`) detecta caminhos locais em tempo de execução e gera `config/mcp.resolved.json` com entrypoints diretos via `node.exe`.
|
|
221
|
+
|
|
222
|
+
3. **Detecção dinâmica de harnesses**: o resolvedor sincroniza com cada harness instalado verificando a existência do arquivo de configuração. Ele não usa uma lista fixa de alvos:
|
|
223
|
+
* Gemini escreve em `~/.gemini/config/mcp_config.json` (JSON)
|
|
224
|
+
* Claude Code escreve em `~/.claude/settings.json` (JSON)
|
|
225
|
+
* Codex CLI escreve em `~/.codex/config.toml` (TOML `[mcp_servers.*]`)
|
|
226
|
+
* Hermes escreve em `%LOCALAPPDATA%\hermes\config.yaml` (YAML `mcp_servers:`)
|
|
227
|
+
* Qualquer harness futuro adicionado ao resolvedor é detectado automaticamente na próxima sincronização
|
|
228
|
+
|
|
229
|
+
4. **Invocação direta via `node.exe`**: as configurações resolvidas usam `C:\Program Files\nodejs\node.exe <entrypoint.js>` em vez de `npx`, criando exatamente 1 processo por servidor por sessão, sem wrappers `cmd.exe` e sem multiplicação de órfãos ao fechar a sessão.
|
|
230
|
+
|
|
231
|
+
#### Comandos diários de MCP
|
|
232
|
+
|
|
233
|
+
```powershell
|
|
234
|
+
# Re-resolve caminhos e sincroniza com todos os harnesses instalados (após ativar/desativar servidores ou atualizar pacotes)
|
|
235
|
+
/mcp-sync
|
|
236
|
+
|
|
237
|
+
# Mata processos MCP órfãos deixados por sessões que travaram
|
|
238
|
+
/mcp-cleanup
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
#### Desativar servidores pesados
|
|
242
|
+
|
|
243
|
+
Edite `config/mcp.template.json` e defina `"disabled": true` no servidor desejado (por exemplo, `chrome-devtools`) para impedir que ele seja iniciado em novas sessões. Execute `/mcp-sync` após editar.
|
|
244
|
+
|
|
180
245
|
[↑ Voltar ao topo](#indice)
|
|
181
246
|
|
|
182
247
|
---
|
|
@@ -288,28 +353,28 @@ Todas as personas declaram `model: inherit` para rodar em qualquer modelo ou pro
|
|
|
288
353
|
|
|
289
354
|
| Persona | Nível de Capacidade | Papel e Responsabilidades | Skills Vinculadas |
|
|
290
355
|
| :--- | :--- | :--- | :--- |
|
|
291
|
-
| **`orchestrator`** | `deep_reasoning` | Guardião do planejamento (`/grill-me`), questionamento de requisitos, decomposição modular de tarefas, exigência de verificação Playwright E2E e coordenação de subagentes. | `brainstorming`, `writing-plans`, `pstack-discipline`, `subagent-driven-development`, `dispatching-parallel-agents`, `using-git-worktrees`, `writing-skills`, `executing-plans`, `herdr` |
|
|
292
|
-
| **`frontend-designer`** | `high_polish_vision` | Define leitura de design, hierarquia tipográfica, mapeamento de tokens e estética de UI anti-slop para web. | `taste-skill`, `brandkit`, `minimalist-skill`, `brutalist-skill`, `soft-skill`, `antislop-ui`, `antislop-human`, `stitch-skill`, `image-to-code-skill`, `imagegen-frontend-web`, `redesign-skill` |
|
|
356
|
+
| **`orchestrator`** | `deep_reasoning` | Guardião do planejamento (`/grill-me`), questionamento de requisitos, decomposição modular de tarefas, exigência de verificação Playwright E2E e coordenação de subagentes. | `grill-me`, `brainstorming`, `writing-plans`, `to-spec`, `to-tickets`, `wayfinder`, `domain-modeling`, `handoff`, `pstack-discipline`, `subagent-driven-development`, `dispatching-parallel-agents`, `using-git-worktrees`, `writing-skills`, `executing-plans`, `herdr`, `upstream-skill-sync` |
|
|
357
|
+
| **`frontend-designer`** | `high_polish_vision` | Define leitura de design, hierarquia tipográfica, mapeamento de tokens e estética de UI anti-slop para web. | `taste-skill`, `brandkit`, `minimalist-skill`, `brutalist-skill`, `soft-skill`, `antislop-ui`, `antislop-human`, `stitch-skill`, `image-to-code-skill`, `imagegen-frontend-web`, `redesign-skill`, `modern-web-guidance` |
|
|
293
358
|
| **`mobile-designer`** | `responsive_flex_safety` | Segurança de viewport mobile (320px–430px), alvos de toque de 48px, containers flex sem corte de overflow e assets responsivos. | `antislop-layoutmobile`, `antislop-human`, `antislop-ui`, `imagegen-frontend-mobile`, `taste-skill` |
|
|
294
359
|
| **`tester`** | `fast_verification` | Impõe TDD estrito e verificação real em navegador (Playwright). Rejeita pseudo-verificação (`curl`, `grep`, `tsc`). | `test-driven-development`, `verification-before-completion`, `systematic-debugging`, `executing-plans` |
|
|
295
360
|
| **`security-auditor`** | `deep_assurance_audit` | Sondagem HTTP diferencial dinâmica entre níveis de autenticação, defesas OWASP Top 10 e detecção de padrões inseguros da Trail of Bits. | `strix-security`, `security-audit-sweep`, `owasp-security`, `cloudflare-security-audit`, `snyk-agent-scan`, `trailofbits-audit-context`, `trailofbits-insecure-defaults`, `trailofbits-triage-brocards` |
|
|
296
361
|
| **`database-architect`** | `schema_migration_safety` | Governa migrações não destrutivas, normalização, auditoria de planos de query (`EXPLAIN ANALYZE`) e pool de conexões (Postgres/Supabase, SQLite, MySQL). | `postgres-best-practices`, `systematic-debugging`, `karpathy-guidelines` |
|
|
297
|
-
| **`code-sentinel`** | `surgical_restraint` | Simplicidade Karpathy: escreve código cirúrgico mínimo, remove comentários redundantes, elimina código morto defensivo e aplica padrões anti-slop. | `karpathy-guidelines`, `clean-code`, `ponytail`, `antislop`, `antislop-code`, `antislop-copywriting`, `antislop-human`, `finishing-a-development-branch` |
|
|
298
|
-
| **`reviewer`** | `adversarial_diff_eval` | Realiza análise adversarial de diffs,
|
|
299
|
-
| **`modernizer`** | `legacy_migration_safety` | Executa transformações de código legado, upgrades de runtime e migrações Strangler Fig protegidas por testes de caracterização Golden Master. | `test-driven-development`, `verification-before-completion`, `systematic-debugging`, `karpathy-guidelines`, `project-hygiene`, `output-skill` |
|
|
362
|
+
| **`code-sentinel`** | `surgical_restraint` | Simplicidade Karpathy: escreve código cirúrgico mínimo, remove comentários redundantes, elimina código morto defensivo, exige módulos profundos e aplica padrões anti-slop. | `communication-doctrine`, `karpathy-guidelines`, `clean-code`, `codebase-design`, `ponytail`, `antislop`, `antislop-code`, `antislop-copywriting`, `antislop-human`, `finishing-a-development-branch` |
|
|
363
|
+
| **`reviewer`** | `adversarial_diff_eval` | Realiza análise adversarial de diffs, audita profundidade de módulos e abstrações rasas, captura regressões silenciosas, executa auditorias thermo e coordena revisões cruzadas entre modelos. | `communication-doctrine`, `thermo`, `codebase-design`, `requesting-code-review`, `receiving-code-review`, `claude-collaborator`, `gemini-collaborator`, `codex-collaborator`, `using-superpowers`, `diagnosing-superpowers`, `output-skill` |
|
|
364
|
+
| **`modernizer`** | `legacy_migration_safety` | Executa transformações de código legado, upgrades de runtime, desacoplamento de dependências e migrações Strangler Fig protegidas por testes de caracterização Golden Master. | `test-driven-development`, `verification-before-completion`, `systematic-debugging`, `improve-codebase-architecture`, `codebase-design`, `karpathy-guidelines`, `project-hygiene`, `output-skill`, `modern-web-guidance`, `upstream-skill-sync` |
|
|
300
365
|
| **`cloud-engineer`** | `infra_container_safety` | Governa conteinerização (Docker, Compose), manifestos Kubernetes, Infraestrutura como Código (Terraform), proxies reversos (Caddy, Nginx), CI/CD e verificação terminante. | `communication-doctrine`, `karpathy-guidelines`, `clean-code`, `systematic-debugging`, `project-hygiene`, `progressive-disclosure` |
|
|
301
366
|
|
|
302
367
|
---
|
|
303
368
|
|
|
304
|
-
<a id="inventario-de-skills-
|
|
305
|
-
### Inventário de Skills (
|
|
369
|
+
<a id="inventario-de-skills-69-modulos-em-30-toolkits"></a>
|
|
370
|
+
### Inventário de Skills (69 Módulos em 30 Toolkits)
|
|
306
371
|
|
|
307
|
-
O Heimdall organiza as capacidades em **
|
|
372
|
+
O Heimdall organiza as capacidades em **6 Suítes Multi-Skill Principais (45 módulos)** e **24 Toolkits Independentes (24 módulos)**:
|
|
308
373
|
|
|
309
|
-
#### Suítes Multi-Skill Principais (
|
|
374
|
+
#### Suítes Multi-Skill Principais (6 Suítes / 45 Módulos)
|
|
310
375
|
|
|
311
376
|
<details open>
|
|
312
|
-
<summary><b>1. Suíte de Engenharia Superpowers (15 módulos) —
|
|
377
|
+
<summary><b>1. Suíte de Engenharia Superpowers (15 módulos) — <a href="https://github.com/obra/superpowers">obra/superpowers</a></b></summary>
|
|
313
378
|
|
|
314
379
|
- `brainstorming`: Expõe premissas implícitas e explora alternativas antes de travar o design.
|
|
315
380
|
- `writing-plans`: Estrutura tarefas modulares e objetivas com critérios verificáveis de conclusão.
|
|
@@ -330,7 +395,7 @@ O Heimdall organiza as capacidades em **5 Suítes Multi-Skill Principais (37 mó
|
|
|
330
395
|
</details>
|
|
331
396
|
|
|
332
397
|
<details>
|
|
333
|
-
<summary><b>2. Estúdio de Design e Estética Taste (10 módulos)</b></summary>
|
|
398
|
+
<summary><b>2. Estúdio de Design e Estética Taste (10 módulos) — <a href="https://github.com/Leonxlnx/taste-skill">Leonxlnx/taste-skill</a></b></summary>
|
|
334
399
|
|
|
335
400
|
- `taste-skill`: Impõe leitura coesa de design, tipografia intencional e lógica de cores orientada à marca.
|
|
336
401
|
- `brandkit`: Gerencia design tokens, ativos invariantes de marca e temas multi-paleta.
|
|
@@ -346,7 +411,7 @@ O Heimdall organiza as capacidades em **5 Suítes Multi-Skill Principais (37 mó
|
|
|
346
411
|
</details>
|
|
347
412
|
|
|
348
413
|
<details>
|
|
349
|
-
<summary><b>3. Suíte de Qualidade Anti-Slop (6 módulos) —
|
|
414
|
+
<summary><b>3. Suíte de Qualidade Anti-Slop (6 módulos) — <a href="https://github.com/miqdadbadjuber/anti-slop">miqdadbadjuber/anti-slop</a></b></summary>
|
|
350
415
|
|
|
351
416
|
- `antislop`: Guardrail central que proíbe enrolação genérica de IA, chavões vazios e excessos decorativos.
|
|
352
417
|
- `antislop-code`: Proíbe comentários redundantes, código morto defensivo e abstrações especulativas.
|
|
@@ -367,7 +432,7 @@ O Heimdall organiza as capacidades em **5 Suítes Multi-Skill Principais (37 mó
|
|
|
367
432
|
</details>
|
|
368
433
|
|
|
369
434
|
<details>
|
|
370
|
-
<summary><b>5. Suíte AppSec de Alta Confiabilidade Trail of Bits (3 módulos) —
|
|
435
|
+
<summary><b>5. Suíte AppSec de Alta Confiabilidade Trail of Bits (3 módulos) — <a href="https://github.com/trailofbits/skills">trailofbits/skills</a></b></summary>
|
|
371
436
|
|
|
372
437
|
- `trailofbits-audit-context`: Mapeamento de premissas, garantias de código e dependências arquiteturais críticas.
|
|
373
438
|
- `trailofbits-insecure-defaults`: Detecção de configurações padrão inseguras, padrões *fail-open* e permissões excessivas.
|
|
@@ -375,7 +440,21 @@ O Heimdall organiza as capacidades em **5 Suítes Multi-Skill Principais (37 mó
|
|
|
375
440
|
|
|
376
441
|
</details>
|
|
377
442
|
|
|
378
|
-
|
|
443
|
+
<details>
|
|
444
|
+
<summary><b>6. Suíte de Engenharia Real Matt Pocock (8 módulos) — <a href="https://github.com/mattpocock/skills">mattpocock/skills</a></b></summary>
|
|
445
|
+
|
|
446
|
+
- `codebase-design`: Modela módulos profundos — interfaces enxutas que encapsulam alta complexidade interna —, aplica o teste de deleção e elimina camadas superficiais de abstração.
|
|
447
|
+
- `domain-modeling`: Modela a linguagem ubíqua da aplicação, estrutura glossários de termos de negócio e formaliza Registros de Decisão Arquitetural (ADRs) para evitar divergências conceituais.
|
|
448
|
+
- `improve-codebase-architecture`: Mapeia o acoplamento entre os módulos da base de código, identifica dependências circulares e gera diagnósticos em matriz de dependência.
|
|
449
|
+
- `to-spec`: Transforma requisitos e consensos de alinhamento em especificações técnicas detalhadas, com regras invariantes, jornadas de usuário e matrizes de erro.
|
|
450
|
+
- `to-tickets`: Desdobra especificações em tarefas atômicas e ordenadas por dependência, prontas para execução estruturada por subagentes.
|
|
451
|
+
- `wayfinder`: Rastrea a fronteira de execução em bases de código amplas, separando o que já foi decidido, as tarefas ativas da rodada e as áreas ainda sob análise.
|
|
452
|
+
- `grill-me`: Entrevistas técnicas estruturadas pela fronteira de decisões, com investigação autônoma no repositório e formato de aprovação ágil por recomendação explícita (*Yes-to-Approve*).
|
|
453
|
+
- `handoff`: Condensa o contexto da sessão em documentos estruturados por ponteiros salvos no diretório temporário (`$env:TEMP`), com contratos explícitos de skills recomendadas para o próximo agente.
|
|
454
|
+
|
|
455
|
+
</details>
|
|
456
|
+
|
|
457
|
+
#### Toolkits Independentes (24 Toolkits Curados / 24 Módulos)
|
|
379
458
|
|
|
380
459
|
<details open>
|
|
381
460
|
<summary><b>Explorar Toolkits Independentes</b></summary>
|
|
@@ -399,6 +478,11 @@ O Heimdall organiza as capacidades em **5 Suítes Multi-Skill Principais (37 mó
|
|
|
399
478
|
- **`progressive-disclosure`**: Padrão de divulgação progressiva em 3 camadas alinhado à Anthropic e Google, cortando o uso de tokens de prompt em >80% e prevenindo a proliferação desordenada de subagentes.
|
|
400
479
|
- **`project-hygiene`**: Varre repositórios em busca de código morto, exports não utilizados, dependências circulares e caches de build obsoletos.
|
|
401
480
|
- **`output-skill`**: Garante saídas completas do modelo sem reticências (`...`), blocos de código truncados ou omissões.
|
|
481
|
+
- **`ruminate`**: Minera transcrições históricas de sessões Claude e Gemini em busca de padrões de correção, preferências repetidas, falhas de ativação de skills, violações de doutrina e desvios de consistência entre agentes. Escreve descobertas como arquivos de memória ou emendas de skills. Inspirado em [poteto/brainmaxxing](https://github.com/poteto/brainmaxxing).
|
|
482
|
+
- **`modern-web-guidance`**: Pacote oficial de skills de plataforma web moderna do Google Chrome (`GoogleChrome/modern-web-guidance`). Orienta agentes a usar APIs nativas HTML/CSS/JS compatíveis com Baseline, boas práticas de Core Web Vitals (LCP/INP/CLS) e modernização frontend via `legacy-scan`.
|
|
483
|
+
- **`mcp-cleanup`**: Encerra processos órfãos de servidores MCP deixados por sessões encerradas ou travadas.
|
|
484
|
+
- **`mcp-sync`**: Resolve o template MCP do Heimdall para caminhos locais e sincroniza com os harnesses instalados.
|
|
485
|
+
- **`upstream-skill-sync`**: Audita repositórios upstream em `config/skills.json` e classifica atualizações em Seguro 1:1, Merge Seletivo ou Rejeitar.
|
|
402
486
|
|
|
403
487
|
</details>
|
|
404
488
|
|