heimdall-agent 1.0.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 +57 -26
- package/README.pt-BR.md +443 -0
- package/agents/cloud-engineer.md +77 -0
- package/agents/code-sentinel.md +71 -34
- package/agents/database-architect.md +31 -25
- package/agents/frontend-designer.md +30 -28
- package/agents/mobile-designer.md +25 -24
- package/agents/modernizer.md +68 -0
- package/agents/orchestrator.md +107 -93
- package/agents/reviewer.md +102 -71
- package/agents/security-auditor.md +27 -27
- package/agents/tester.md +97 -90
- package/commands/grill-me.md +20 -4
- package/commands/orchestrate.md +16 -0
- package/commands/orchestrator.md +16 -0
- package/commands/plan.md +17 -1
- package/config/agents.json +31 -3
- package/config/mcp.json +72 -0
- package/config/models.json +26 -16
- package/config/profiles.json +2 -4
- package/config/skills.json +762 -573
- package/docs/SKILLS.md +393 -275
- package/docs/designs/old/2026-10-31 plan-lifecycle-backlog-and-clean-code-skill.md +87 -0
- package/docs/designs/old/2026-11-02 skill-upstream-audit-and-update.md +105 -0
- package/docs/designs/old/2026-11-05 communication-doctrine-bluf-ste.md +94 -0
- package/docs/designs/old/2026-11-06-cloud-engineer-and-resilience-synthesis.md +67 -0
- package/docs/designs/old/2026-11-06-herdr-native-agent-orchestration.md +45 -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/docs/runs/skill-audit/add_progressive_disclosure.cjs +30 -0
- package/docs/runs/skill-audit/check_heimdall_skills.ps1 +9 -0
- package/docs/runs/skill-audit/compare_classics.ps1 +26 -0
- package/docs/runs/skill-audit/compare_taste.ps1 +12 -0
- package/docs/runs/skill-audit/customization-report.json +380 -0
- package/docs/runs/skill-audit/diff_pending_skills.cjs +94 -0
- package/docs/runs/skill-audit/fetch_and_apply_skill.cjs +58 -0
- package/docs/runs/skill-audit/fetch_and_apply_taste_v2.cjs +65 -0
- package/docs/runs/skill-audit/inspect_pending_skills.cjs +71 -0
- package/docs/runs/skill-audit/inventory.json +308 -0
- package/docs/runs/skill-audit/list_local_taste.ps1 +1 -0
- package/docs/runs/skill-audit/phase5-update-plan.json +595 -0
- package/docs/runs/skill-audit/phase5-update-plan.md +138 -0
- package/docs/runs/skill-audit/probe.ps1 +16 -0
- package/docs/runs/skill-audit/probe_classics_branches.ps1 +3 -0
- package/docs/runs/skill-audit/probe_commits.ps1 +15 -0
- package/docs/runs/skill-audit/probe_repos.ps1 +17 -0
- package/docs/runs/skill-audit/probe_sentry_sec.ps1 +3 -0
- package/docs/runs/skill-audit/probe_sentry_sweep.ps1 +5 -0
- package/docs/runs/skill-audit/probe_snyk.ps1 +3 -0
- package/docs/runs/skill-audit/probe_snyk_recipes.ps1 +5 -0
- package/docs/runs/skill-audit/probe_taste_branches.ps1 +8 -0
- package/docs/runs/skill-audit/probe_taste_v19.ps1 +3 -0
- package/docs/runs/skill-audit/probe_user_repos.ps1 +19 -0
- package/docs/runs/skill-audit/prune_taste_skills.cjs +22 -0
- package/docs/runs/skill-audit/run_phase1_2.cjs +142 -0
- package/docs/runs/skill-audit/run_phase6_verification.cjs +107 -0
- package/docs/runs/skill-audit/show_16_details.ps1 +25 -0
- package/docs/runs/skill-audit/show_20_skills.ps1 +28 -0
- package/docs/runs/skill-audit/show_classics_diff.cjs +37 -0
- package/docs/runs/skill-audit/sync_agent_markdowns.cjs +30 -0
- package/docs/runs/skill-audit/taste-skill-upstream.md +542 -0
- package/docs/runs/skill-audit/update-manifest.md +88 -0
- package/docs/runs/skill-audit/update_config_skills.cjs +52 -0
- package/docs/runs/skill-audit/update_registry_phase7.cjs +83 -0
- package/docs/runs/skill-audit/upstream-status.json +563 -0
- package/docs/runs/skill-audit/verification-results.json +252 -0
- package/doctrine/AGENTS.md +42 -77
- package/hooks/git/pre-commit +11 -0
- package/hooks/heimdall-hook.cjs +81 -2
- package/hooks/herdr-agent-state.ps1 +55 -0
- package/hooks/hooks.json +0 -11
- package/lib/catalog-sync.cjs +167 -0
- package/lib/hermes-context.cjs +57 -0
- package/lib/model-context.cjs +123 -0
- package/lib/path-discovery.cjs +94 -0
- package/package.json +7 -3
- package/playbooks/01-interactive-grilling-gate.md +23 -6
- package/playbooks/02-fast-code-deep-verification.md +3 -2
- package/playbooks/03-adversarial-code-review.md +15 -7
- package/playbooks/05-canonical-plan-template.md +35 -19
- package/playbooks/06-model-registry-matrix.md +24 -13
- package/playbooks/07-legacy-code-modernization.md +74 -0
- package/playbooks/08-backlog-and-change-request-flow.md +122 -0
- package/setup.mjs +592 -172
- package/skills/antislop/SKILL.md +76 -56
- package/skills/antislop/VERSION +1 -0
- package/skills/antislop-copywriting/SKILL.md +407 -372
- package/skills/antislop-human/LICENSE-web-quality-skills +21 -0
- package/skills/antislop-human/SKILL.md +204 -147
- package/skills/antislop-human/contrast-check.py +168 -165
- package/skills/antislop-human/contrast-mcp.py +6 -3
- package/skills/antislop-human/references/A11Y-PATTERNS.md +249 -0
- package/skills/antislop-human/references/WCAG.md +127 -0
- package/skills/antislop-ui/LICENSE-web-quality-skills +21 -0
- package/skills/antislop-ui/SKILL.md +344 -304
- package/skills/antislop-ui/references/CORE-WEB-VITALS.md +181 -0
- package/skills/antislop-ui/references/WEB-BASELINE.md +28 -0
- package/skills/brainstorming/SKILL.md +296 -265
- package/skills/brainstorming/builder-check-prompt.md +23 -0
- package/skills/brainstorming/scripts/frame-template.html +213 -213
- package/skills/brainstorming/scripts/server.cjs +723 -723
- package/skills/brandkit/SKILL.md +798 -798
- package/skills/brutalist-skill/SKILL.md +93 -92
- package/skills/caveman/README.md +68 -0
- package/skills/caveman/SKILL.md +73 -38
- package/skills/claude-collaborator/SKILL.md +24 -44
- package/skills/clean-code/SKILL.md +152 -0
- package/skills/cloudflare-security-audit/AI-AND-LLM.md +83 -83
- package/skills/cloudflare-security-audit/ATTACK-CLASSES.md +130 -130
- package/skills/cloudflare-security-audit/CLIENT-SIDE.md +83 -83
- package/skills/cloudflare-security-audit/CLOUD-AND-DEPLOYMENT.md +86 -86
- package/skills/cloudflare-security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -84
- package/skills/cloudflare-security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -89
- package/skills/cloudflare-security-audit/HUNTING.md +251 -251
- package/skills/cloudflare-security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -101
- package/skills/cloudflare-security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -81
- package/skills/cloudflare-security-audit/RECONNAISSANCE.md +156 -156
- package/skills/cloudflare-security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -78
- package/skills/cloudflare-security-audit/SKILL.md +192 -192
- package/skills/cloudflare-security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -73
- package/skills/cloudflare-security-audit/VALIDATION-AND-REPORTING.md +186 -186
- package/skills/cloudflare-security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -105
- package/skills/cloudflare-security-audit/report-schema.json +461 -461
- package/skills/cloudflare-security-audit/validate-coverage-ledger.cjs +872 -872
- package/skills/cloudflare-security-audit/validate-coverage-ledger.test.cjs +740 -740
- package/skills/cloudflare-security-audit/validate-findings.cjs +773 -773
- package/skills/cloudflare-security-audit/validate-findings.test.cjs +652 -652
- 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/codex-collaborator/SKILL.md +24 -45
- package/skills/communication-doctrine/SKILL.md +89 -0
- package/skills/diagnosing-superpowers/SKILL.md +1 -1
- package/skills/diagnosing-superpowers/references/github-issues.md +3 -3
- package/skills/diagnosing-superpowers/templates/issue.md +23 -4
- 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 -56
- package/skills/executing-plans/scripts/task-done +52 -52
- package/skills/executing-plans/scripts/task-start +28 -28
- package/skills/gemini-collaborator/SKILL.md +24 -56
- package/skills/grill-me/SKILL.md +65 -0
- package/skills/handoff/SKILL.md +64 -0
- package/skills/herdr/SKILL.md +243 -0
- package/skills/image-to-code-skill/SKILL.md +1228 -1228
- package/skills/imagegen-frontend-mobile/SKILL.md +1465 -1465
- package/skills/imagegen-frontend-web/SKILL.md +987 -987
- package/skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
- package/skills/improve-codebase-architecture/SKILL.md +71 -0
- package/skills/karpathy-guidelines/SKILL.md +67 -67
- package/skills/mcp-engineering/SKILL.md +74 -0
- package/skills/minimalist-skill/SKILL.md +87 -85
- package/skills/output-skill/SKILL.md +49 -49
- 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/ponytail/SKILL.md +36 -52
- package/skills/postgres-best-practices/SKILL.md +30 -52
- package/skills/postgres-best-practices/references/backup-restore.md +372 -0
- package/skills/postgres-best-practices/references/bulk-loading.md +315 -0
- package/skills/postgres-best-practices/references/connection-pooling.md +310 -0
- package/skills/postgres-best-practices/references/hot-standby.md +221 -0
- package/skills/postgres-best-practices/references/indexing.md +318 -0
- package/skills/postgres-best-practices/references/logical-replication.md +610 -0
- package/skills/postgres-best-practices/references/major-version-upgrades.md +334 -0
- package/skills/postgres-best-practices/references/performance-diagnostics.md +553 -0
- package/skills/postgres-best-practices/references/query-optimization.md +294 -0
- package/skills/postgres-best-practices/references/query-patterns.md +566 -0
- package/skills/postgres-best-practices/references/schema-design.md +362 -0
- package/skills/postgres-best-practices/references/security-roles.md +489 -0
- package/skills/postgres-best-practices/references/transaction-isolation.md +344 -0
- package/skills/progressive-disclosure/SKILL.md +68 -0
- package/skills/pstack-discipline/SKILL.md +40 -0
- package/skills/receiving-code-review/SKILL.md +2 -23
- package/skills/requesting-code-review/SKILL.md +7 -36
- package/skills/soft-skill/SKILL.md +99 -98
- package/skills/stitch-skill/DESIGN.md +121 -121
- package/skills/stitch-skill/SKILL.md +185 -184
- package/skills/strix-security/SKILL.md +54 -53
- package/skills/subagent-driven-development/SKILL.md +35 -264
- package/skills/subagent-driven-development/references/batching.md +11 -0
- package/skills/subagent-driven-development/references/cannot-verify.md +10 -0
- package/skills/subagent-driven-development/references/final-review.md +47 -0
- package/skills/subagent-driven-development/references/fix-loop.md +77 -0
- package/skills/subagent-driven-development/references/handling-reports.md +15 -0
- package/skills/subagent-driven-development/references/preflight.md +26 -0
- package/skills/subagent-driven-development/references/resuming.md +12 -0
- package/skills/subagent-driven-development/scripts/review-package +53 -53
- package/skills/subagent-driven-development/scripts/sdd-workspace +87 -82
- package/skills/subagent-driven-development/scripts/task-brief +43 -43
- package/skills/systematic-debugging/SKILL.md +283 -306
- package/skills/taste-skill/SKILL.md +542 -1206
- package/skills/taste-skill/references/app-screens.md +1199 -0
- package/skills/taste-skill/references/colour.md +141 -0
- package/skills/taste-skill/references/copy.md +177 -0
- package/skills/taste-skill/references/critique.md +182 -0
- package/skills/taste-skill/references/imagery.md +791 -0
- package/skills/taste-skill/references/layout.md +292 -0
- package/skills/taste-skill/references/motion.md +980 -0
- package/skills/taste-skill/references/research.md +356 -0
- package/skills/taste-skill/references/scenes.md +174 -0
- package/skills/taste-skill/references/tells.md +115 -0
- package/skills/taste-skill/references/type.md +170 -0
- package/skills/test-driven-development/SKILL.md +330 -337
- package/skills/thermo/SKILL.md +67 -0
- package/skills/threat-modeling/SKILL.md +55 -0
- package/skills/to-spec/SKILL.md +75 -0
- package/skills/to-tickets/SKILL.md +105 -0
- package/skills/trailofbits-audit-context/SKILL.md +72 -72
- package/skills/trailofbits-insecure-defaults/commands/audit.md +35 -0
- package/skills/trailofbits-insecure-defaults/references/debug-features.json +13 -13
- package/skills/trailofbits-insecure-defaults/references/debug-features.md +75 -75
- package/skills/trailofbits-insecure-defaults/references/default-credentials.json +12 -12
- package/skills/trailofbits-insecure-defaults/references/default-credentials.md +76 -76
- package/skills/trailofbits-insecure-defaults/references/fail-open-security.json +11 -11
- package/skills/trailofbits-insecure-defaults/references/fail-open-security.md +70 -70
- package/skills/trailofbits-insecure-defaults/references/fallback-secrets.json +11 -11
- package/skills/trailofbits-insecure-defaults/references/fallback-secrets.md +70 -70
- package/skills/trailofbits-insecure-defaults/references/permissive-access.json +13 -13
- package/skills/trailofbits-insecure-defaults/references/permissive-access.md +62 -62
- package/skills/trailofbits-insecure-defaults/references/weak-crypto.json +13 -13
- package/skills/trailofbits-insecure-defaults/references/weak-crypto.md +71 -71
- package/skills/trailofbits-triage-brocards/SKILL.md +208 -208
- package/skills/verification-before-completion/SKILL.md +0 -14
- package/skills/wayfinder/SKILL.md +128 -0
- package/skills/writing-plans/SKILL.md +11 -15
- package/skills/writing-skills/SKILL.md +21 -303
- package/skills/writing-skills/references/CLAUDE_MD_TESTING.md +189 -0
- package/skills/writing-skills/references/anthropic-best-practices.md +1150 -0
- package/skills/writing-skills/references/bulletproofing.md +80 -0
- package/skills/writing-skills/references/discovery.md +201 -0
- package/skills/writing-skills/references/flowcharts.md +37 -0
- package/skills/writing-skills/references/graphviz-conventions.dot +172 -0
- package/skills/writing-skills/references/persuasion-principles.md +187 -0
- package/skills/writing-skills/references/testing-skills-with-subagents.md +384 -0
- package/tools/{claude-bridge.ps1 → archive/claude-bridge.ps1} +10 -7
- package/tools/{codex-bridge.ps1 → archive/codex-bridge.ps1} +1 -1
- package/tools/{gemini-bridge.ps1 → archive/gemini-bridge.ps1} +12 -19
- package/skills/gpt-tasteskill/SKILL.md +0 -74
- package/skills/taste-skill-v1/SKILL.md +0 -226
- /package/tools/{claude-bridge.cmd → archive/claude-bridge.cmd} +0 -0
- /package/tools/{claude-bridge.sh → archive/claude-bridge.sh} +0 -0
- /package/tools/{codex-bridge.cmd → archive/codex-bridge.cmd} +0 -0
- /package/tools/{codex-bridge.sh → archive/codex-bridge.sh} +0 -0
- /package/tools/{codexcli-bridge.cmd → archive/codexcli-bridge.cmd} +0 -0
- /package/tools/{codexcli-bridge.ps1 → archive/codexcli-bridge.ps1} +0 -0
- /package/tools/{gemini-bridge.cmd → archive/gemini-bridge.cmd} +0 -0
- /package/tools/{gemini-bridge.sh → archive/gemini-bridge.sh} +0 -0
package/README.md
CHANGED
|
@@ -3,12 +3,14 @@
|
|
|
3
3
|
<p align="left">
|
|
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
|
-
<a href="#
|
|
7
|
-
<a href="#skill-inventory-
|
|
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-64-modules-across-25-toolkits"><img src="https://img.shields.io/badge/skills-25%20toolkits%20%2864%20modules%29-blueviolet.svg?style=flat-square" alt="Skills: 25 Toolkits (64 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
|
+
|
|
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 **64 modular skills** across **Google Antigravity**, **Claude Code**, **OpenAI Codex CLI**, **Hermes Agent**, **OpenClaw**, **OpenDesign**, and **Claude Desktop**.
|
|
12
14
|
|
|
13
15
|
---
|
|
14
16
|
|
|
@@ -32,8 +34,8 @@ Heimdall is a portable bootstrap toolkit and quality sentinel for multi-agent so
|
|
|
32
34
|
**Heimdall** is an environment bootstrapper and multi-agent coordination layer for AI coding tools.
|
|
33
35
|
|
|
34
36
|
Instead of manually maintaining scattered custom instructions, system prompts, and configuration files across different AI clients, Heimdall provides a single source of truth:
|
|
35
|
-
* **Modular Skills**:
|
|
36
|
-
* **Specialized Agent Personas**:
|
|
37
|
+
* **Modular Skills**: 64 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
|
+
* **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`).
|
|
37
39
|
* **Universal Doctrine**: Central rules (`AGENTS.md`) synchronized across all harnesses, enforcing planning gates, test-driven development (TDD), and minimal surgical code edits.
|
|
38
40
|
|
|
39
41
|
Heimdall runs on **Windows, macOS, and Linux**, using native filesystem junctions and symlinks to keep all AI harnesses synchronized with zero file duplication.
|
|
@@ -80,26 +82,28 @@ When Heimdall bootstraps, it establishes live junctions (Windows) or symlinks (P
|
|
|
80
82
|
|
|
81
83
|
| Source in Heimdall | Deployed Location | Purpose |
|
|
82
84
|
| :--- | :--- | :--- |
|
|
83
|
-
| `skills/` | `~/.<tool>/skills/` |
|
|
84
|
-
| `agents/` | `~/.<tool>/agents/` |
|
|
85
|
+
| `skills/` | `~/.<tool>/skills/` | 64 domain toolkits loaded progressively on demand. |
|
|
86
|
+
| `agents/` | `~/.<tool>/agents/` | 10 specialized agent persona definitions. |
|
|
85
87
|
| `hooks/` | `~/.claude/hooks/` | Event-driven lifecycle hooks for Claude Code CLI. |
|
|
86
88
|
| `hooks/git/` | `.git/hooks/` (optional) | Universal native Git pre-push hook for all tools. |
|
|
87
89
|
| `doctrine/AGENTS.md` | `~/.claude/CLAUDE.md`<br>`~/.gemini/GEMINI.md`<br>`~/.codex/AGENTS.md`<br>`~/.hermes/AGENTS.md` | Universal cross-agent doctrine and operational constraints. |
|
|
88
|
-
| `playbooks/` | `~/.<tool>/playbooks/` | Operational playbooks (grilling gate, TDD, reviews, plans). |
|
|
90
|
+
| `playbooks/` | `~/.<tool>/playbooks/` | Operational playbooks (grilling gate, TDD, reviews, plans, backlog & CR flow). |
|
|
89
91
|
| `commands/` | `~/.claude/commands/` | Slash commands (`/orchestrator`, `/orchestrate`, `/plan`, `/grill-me`). |
|
|
90
92
|
| `tools/` | `PATH` candidate directory | Cross-model bridge scripts (`claude-bridge`, `gemini-bridge`, `codex-bridge`) and `heimdall` CLI. |
|
|
93
|
+
| `docs/designs/` | Workspace root | Canonical plan home (`YYYY-MM-DD <name>.md`); verified plans archived to `old/`. |
|
|
94
|
+
| `docs/backlog.md` | Workspace root | Single-source-of-truth product backlog and Change Request ledger. |
|
|
91
95
|
|
|
92
96
|
### 2. The Google Elephant-Goldfish Model (EGM)
|
|
93
97
|
|
|
94
98
|
Heimdall adopts the core division of labor from [`google/elephant-goldfish-model`](https://github.com/google/elephant-goldfish-model):
|
|
95
99
|
|
|
96
|
-
* **The Elephant (Coordinator)**: The primary session and [`orchestrator`](#
|
|
100
|
+
* **The Elephant (Coordinator)**: The primary session and [`orchestrator`](#10-predefined-agent-personas) persona retain long-term memory, project narrative, and deep contextual history.
|
|
97
101
|
* **The Goldfish (Reviewers & Testers)**: Subagents dispatched for code review (`reviewer`) and bug diagnosis (`tester`) are intentionally blinded to conversational backstory and author debates. They evaluate raw git diffs and acceptance criteria directly, preventing confirmation bias and rubber-stamping.
|
|
98
102
|
* **The 3-Tier Boundary Ladder**:
|
|
99
103
|
- **Tier 1 (Spike / Bugfix < 50 LOC)**: Zero ceremony. Minimal surgical code with a failing test first.
|
|
100
104
|
- **Tier 2 (Bounded Feature)**: Fast in-chat design check with critic and readiness reviews.
|
|
101
105
|
- **Tier 3 (Architectural)**: Spec written to disk (`docs/designs/<feature>.md`), 4-stage review (Zoom Out, Comprehension, Critique, Readiness), and a 5-round convergence ledger.
|
|
102
|
-
* **Adaptive Multi-Model Execution**:
|
|
106
|
+
* **Adaptive Multi-Model Execution**: In Herdr (`HERDR_ENV=1`), Heimdall routes reviews across different models (e.g. Gemini Elephant validated by Claude/Codex) via native Herdr multiplexing; otherwise, it falls back to stateless child subagents on the same model.
|
|
103
107
|
|
|
104
108
|
### 3. Event-Driven Lifecycle Hooks
|
|
105
109
|
|
|
@@ -148,10 +152,10 @@ Select a profile tier based on your machine and workflow needs:
|
|
|
148
152
|
|
|
149
153
|
| Profile | Skills | Predefined Agents | Description | Best For |
|
|
150
154
|
| :--- | :---: | :---: | :--- | :--- |
|
|
151
|
-
| **`full`** *(Default)* |
|
|
155
|
+
| **`full`** *(Default)* | 64 | 10 | Complete engineering suite: planning, design, security, database, hygiene. | Everyday development across all tools |
|
|
152
156
|
| **`minimal`** | 16 | 4 | Lean core: `orchestrator`, `tester`, `code-sentinel`, `reviewer`. | Lightweight laptops, smaller context windows |
|
|
153
157
|
| **`security`** | 12 | 4 | AppSec suite: `orchestrator`, `security-auditor`, `tester`, `reviewer`. | Penetration testing & pre-deployment audits |
|
|
154
|
-
| **`design`** |
|
|
158
|
+
| **`design`** | 12 | 4 | Frontend & mobile: `orchestrator`, `frontend-designer`, `mobile-designer`, `code-sentinel`. | UI/UX design and design-system work |
|
|
155
159
|
|
|
156
160
|
To deploy a specific profile:
|
|
157
161
|
```powershell
|
|
@@ -170,6 +174,7 @@ Heimdall automatically discovers and configures installed AI tools:
|
|
|
170
174
|
| **OpenAI Codex CLI** | `codex` on PATH | Junctions to `~/.codex/skills`, `agents`, and `AGENTS.md` |
|
|
171
175
|
| **Hermes Agent** | `hermes` on PATH / LocalAppData | Junctions to `%LOCALAPPDATA%\hermes\skills` + `external_dirs` in `config.yaml` |
|
|
172
176
|
| **OpenClaw** | `openclaw` on PATH | Junctions to `~/.openclaw/skills` + `AGENTS.md` / `SOUL.md` injection |
|
|
177
|
+
| **OpenDesign** | `open-design` on PATH / `.opendesign` | Automatic visual canvas mode: bypasses Turn 1 grilling gate, preserves `data-od-*` attributes & applies `taste-skill` + `antislop-ui` |
|
|
173
178
|
| **Claude Desktop** | `%APPDATA%\Claude` | Auto-configures Context7 MCP and playbooks in `claude_desktop_config.json` |
|
|
174
179
|
|
|
175
180
|
[↑ Back to top](#table-of-contents)
|
|
@@ -253,6 +258,22 @@ flowchart TD
|
|
|
253
258
|
3. **Subagent Execution (Turn 3+)**: The Orchestrator delegates tasks to isolated subagents with specialized briefs.
|
|
254
259
|
4. **Verification & Review**: Mandates automated test execution, Playwright browser E2E verification, and adversarial Goldfish peer review before merge.
|
|
255
260
|
|
|
261
|
+
---
|
|
262
|
+
|
|
263
|
+
### 3. Backlog Management & Plan Lifecycle (Playbook 08)
|
|
264
|
+
|
|
265
|
+
To preserve codebase stability and prevent architectural drift, Heimdall enforces two distinct tracks:
|
|
266
|
+
|
|
267
|
+
#### A. The Four Engineering Flows
|
|
268
|
+
1. **Bugfixes (Fast-Path Loop)**: Receive report -> assess/plan surgical fix -> implement via TDD (failing test first) -> verify with tests & Playwright -> complete.
|
|
269
|
+
2. **New Features (Backlog Intake)**: New requirements are not coded immediately; they are captured in [`docs/backlog.md`](docs/backlog.md) with context and priority.
|
|
270
|
+
3. **Change Request (CR) Analysis Gate**: Backlog items undergo technical impact, blast radius, and dependency analysis. Upon human approval -> author plan -> implement -> verify -> archive.
|
|
271
|
+
4. **Rejection & Postponement**: Discarded or deferred requests return to the backlog with technical rationales or get deleted.
|
|
272
|
+
|
|
273
|
+
#### B. Plan Storage & Archiving Rules
|
|
274
|
+
* **Authoring**: All implementation plans are written to `docs/designs/YYYY-MM-DD <plan-name>.md`.
|
|
275
|
+
* **Archiving**: Once verified and confirmed working, the plan is moved to `docs/designs/old/YYYY-MM-DD <plan-name>.md`.
|
|
276
|
+
|
|
256
277
|
[↑ Back to top](#table-of-contents)
|
|
257
278
|
|
|
258
279
|
---
|
|
@@ -260,30 +281,33 @@ flowchart TD
|
|
|
260
281
|
<a id="6-full-list-of-skills--agents"></a>
|
|
261
282
|
## 6. Full List of Skills & Agents
|
|
262
283
|
|
|
263
|
-
<a id="
|
|
264
|
-
|
|
284
|
+
<a id="10-predefined-agent-personas"></a>
|
|
285
|
+
<a id="10-predefined-agent-personas"></a>
|
|
286
|
+
### 10 Predefined Agent Personas
|
|
265
287
|
|
|
266
288
|
All personas declare `model: inherit` to run on whichever active model or vendor is configured on your machine without vendor lock-in.
|
|
267
289
|
|
|
268
290
|
| Persona | Capability Tier | Role & Responsibilities | Bound Skills |
|
|
269
291
|
| :--- | :--- | :--- | :--- |
|
|
270
|
-
| **`orchestrator`** | `deep_reasoning` | Planning gatekeeper (`/grill-me`), requirements interrogation, modular task decomposition, Playwright E2E verification enforcement, and subagent coordination. | `brainstorming`, `writing-plans`, `subagent-driven-development`, `dispatching-parallel-agents`, `using-git-worktrees`, `writing-skills`, `executing-plans` |
|
|
271
|
-
| **`frontend-designer`** | `high_polish_vision` | Enforces design read, typography hierarchy, token mappings, and anti-slop UI aesthetics for web surfaces. | `taste-skill`, `
|
|
292
|
+
| **`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` |
|
|
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` |
|
|
272
294
|
| **`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` |
|
|
273
295
|
| **`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` |
|
|
274
296
|
| **`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` |
|
|
275
297
|
| **`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` |
|
|
276
|
-
| **`code-sentinel`** | `surgical_restraint` | Karpathy simplicity: writes minimal surgical code, strips boilerplate comments, purges defensive dead code, and
|
|
277
|
-
| **`reviewer`** | `adversarial_diff_eval` | Performs adversarial diff analysis, catches silent regressions
|
|
298
|
+
| **`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. | `karpathy-guidelines`, `clean-code`, `codebase-design`, `ponytail`, `antislop`, `antislop-code`, `antislop-copywriting`, `antislop-human`, `finishing-a-development-branch` |
|
|
299
|
+
| **`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` |
|
|
300
|
+
| **`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` |
|
|
301
|
+
| **`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` |
|
|
278
302
|
|
|
279
303
|
---
|
|
280
304
|
|
|
281
|
-
<a id="skill-inventory-
|
|
282
|
-
### Skill Inventory (
|
|
305
|
+
<a id="skill-inventory-64-modules-across-25-toolkits"></a>
|
|
306
|
+
### Skill Inventory (64 Modules Across 25 Toolkits)
|
|
283
307
|
|
|
284
|
-
Heimdall organizes capabilities into **
|
|
308
|
+
Heimdall organizes capabilities into **6 Core Multi-Skill Suites (45 modules)** and **19 Standalone Toolkits (19 modules)**:
|
|
285
309
|
|
|
286
|
-
#### Core Multi-Skill Suites (
|
|
310
|
+
#### Core Multi-Skill Suites (6 Suites / 45 Modules)
|
|
287
311
|
|
|
288
312
|
<details open>
|
|
289
313
|
<summary><b>1. Superpowers Engineering Suite (15 modules) — Jesse Vincent / obra</b></summary>
|
|
@@ -307,11 +331,9 @@ Heimdall organizes capabilities into **5 Core Multi-Skill Suites (39 modules)**
|
|
|
307
331
|
</details>
|
|
308
332
|
|
|
309
333
|
<details>
|
|
310
|
-
<summary><b>2. Taste Design & Aesthetic Studio (
|
|
334
|
+
<summary><b>2. Taste Design & Aesthetic Studio (10 modules)</b></summary>
|
|
311
335
|
|
|
312
336
|
- `taste-skill`: Enforces cohesive design reads, purpose-driven typography, and brand-first color logic.
|
|
313
|
-
- `taste-skill-v1`: Baseline visual hierarchy and layout balance heuristics.
|
|
314
|
-
- `gpt-tasteskill`: Aesthetic evaluation and UI critique prompt harness.
|
|
315
337
|
- `brandkit`: Manages design tokens, invariant brand assets, and multi-palette themes.
|
|
316
338
|
- `brutalist-skill`: High-contrast, bold typographic layouts with deliberate structural tension.
|
|
317
339
|
- `minimalist-skill`: Ultra-clean editorial layouts emphasizing typography, space, and restraint.
|
|
@@ -354,11 +376,18 @@ Heimdall organizes capabilities into **5 Core Multi-Skill Suites (39 modules)**
|
|
|
354
376
|
|
|
355
377
|
</details>
|
|
356
378
|
|
|
357
|
-
#### Standalone Toolkits (
|
|
379
|
+
#### Standalone Toolkits (19 Curated Toolkits / 19 Modules)
|
|
358
380
|
|
|
359
381
|
<details open>
|
|
360
382
|
<summary><b>Browse Standalone Toolkits</b></summary>
|
|
361
383
|
|
|
384
|
+
- **`thermo`**: Uncompromising architectural and maintainability review focusing on "Code Judo" structural simplification, spaghetti conditional elimination, and modularity health.
|
|
385
|
+
- **`pstack-discipline`**: High-rigor engineering discipline from the pstack / poteto framework: "Prove It Works", "Fix Root Causes", "Test Behavior, Not Implementation", and "Subtract Before You Add".
|
|
386
|
+
- **`communication-doctrine`**: Bottom Line Up Front (BLUF) and Simplified Technical English (STE) communication doctrine for AI agents, implementation plans, code reviews, and subagent handoffs.
|
|
387
|
+
- **`threat-modeling`**: Systematic STRIDE threat modeling, trust boundary mapping, and mitigation verification for architecture, API, and cloud infrastructure changes.
|
|
388
|
+
- **`mcp-engineering`**: Standards, JSON-RPC 2.0 protocol compliance, schema validation, and stdio/SSE transport discipline for authoring Model Context Protocol (MCP) servers and tools.
|
|
389
|
+
- **`herdr`**: Control Herdr, a terminal workspace manager for coding agents. Inspect or control panes, tabs, workspaces, commands, or coordinate with peer agents in persistent terminal sessions.
|
|
390
|
+
- **`clean-code` (`ub-mode`)**: Robert C. "Uncle Bob" Martin's disciplined Clean Code engineering standard. Enforces TDD cycles, laziness protocol, premise interrogation, boundary discipline, and mathematical complexity gates (CRAP < 10, DRY similarity < 0.8, mutant-killing test design).
|
|
362
391
|
- **`ponytail`**: Pragmatic senior developer discipline. Enforces Dietrich Gebert's Decision Ladder: YAGNI checks, codebase reuse, built-in standard library, native platform features, and zero premature abstractions.
|
|
363
392
|
- **`karpathy-guidelines`**: Andrej Karpathy's simplicity heuristics: write minimal surgical code, reject speculative configurability, surface hidden assumptions, and never touch adjacent working code.
|
|
364
393
|
- **`caveman`**: Julius Brussee's token-reduction protocol slashing conversational ceremony while preserving raw code, shell commands, and structured diffs.
|
|
@@ -368,6 +397,7 @@ Heimdall organizes capabilities into **5 Core Multi-Skill Suites (39 modules)**
|
|
|
368
397
|
- **`cloudflare-security-audit`**: Edge security, WAF configuration, and CORS boundary enforcement.
|
|
369
398
|
- **`snyk-agent-scan`**: Automated scanning of AI skills, MCP configurations, and supply chains for prompt injection and credential leaks.
|
|
370
399
|
- **`postgres-best-practices`**: Supabase-curated architectural guidelines for PostgreSQL schema design, indexing, connection pooling, and RLS policies.
|
|
400
|
+
- **`progressive-disclosure`**: Anthropic & Google-aligned 3-layer progressive disclosure standard cutting prompt overhead by >80% and preventing subagent sprawl.
|
|
371
401
|
- **`project-hygiene`**: Sweeps workspaces for dead code, unused exports, circular dependencies, and stale build caches.
|
|
372
402
|
- **`output-skill`**: Guarantees unabridged LLM output without ellipses (`...`), incomplete code blocks, or truncation.
|
|
373
403
|
|
|
@@ -383,6 +413,7 @@ Heimdall organizes capabilities into **5 Core Multi-Skill Suites (39 modules)**
|
|
|
383
413
|
For multi-device pair programming, mobile monitoring, and project memory, Heimdall integrates with:
|
|
384
414
|
|
|
385
415
|
* **[Herdr (`herdr.dev`)](https://herdr.dev/)**: Terminal-native agent multiplexer written in Rust. Keeps background agent sessions persistent across connection drops and tracks status (`working`, `blocked`, `idle`).
|
|
416
|
+
* **[OpenDesign (`open-design.ai`)](https://open-design.ai/)**: Local-first, open-source AI visual design canvas workspace. Spawns Claude Code, Codex, and Gemini CLI as runtime adapters; Heimdall's visual canvas contract exempts canvas generation from Turn 1 grilling gates while enforcing `taste-skill`, WCAG AAA accessibility, and `data-od-*` DOM layer preservation.
|
|
386
417
|
* **[Moshi (`getmoshi.app`)](https://getmoshi.app/)**: Mobile client (iOS/Android) pairing with your terminal session. Delivers push notifications when an agent hits an interactive planning gate and enables remote approval.
|
|
387
418
|
* **[Graphify (`github.com/Graphify-Labs/graphify`)](https://github.com/Graphify-Labs/graphify)**: Local-first code knowledge graph builder. Uses Tree-sitter AST parsing across 40+ programming languages to build deterministic dependency maps with zero LLM API costs, exporting directly to Obsidian vaults.
|
|
388
419
|
* **[Obsidian (`obsidian.md`)](https://obsidian.md/)**: Local-first Markdown knowledge base. Paired with Graphify-generated vaults (`[[wikilinks]]`), it serves as persistent external memory for AI coding agents, loading immediate architectural context on startup without token-heavy scanning.
|