heimdall-agent 1.1.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -13
- package/README.pt-BR.md +36 -22
- package/agents/code-sentinel.md +7 -1
- package/agents/modernizer.md +4 -2
- package/agents/orchestrator.md +20 -7
- package/agents/reviewer.md +2 -0
- package/config/agents.json +11 -1
- package/config/mcp.json +1 -1
- package/config/profiles.json +1 -1
- package/config/skills.json +762 -683
- package/docs/SKILLS.md +96 -74
- package/docs/runs/skill-audit/2026-11-12-compare-report.json +1028 -0
- package/docs/runs/skill-audit/2026-11-12-upstream-audit.json +275 -0
- package/doctrine/AGENTS.md +4 -1
- package/lib/catalog-sync.cjs +8 -3
- package/package.json +1 -1
- package/playbooks/01-interactive-grilling-gate.md +14 -10
- package/playbooks/03-adversarial-code-review.md +12 -4
- package/playbooks/05-canonical-plan-template.md +3 -1
- package/setup.mjs +2 -2
- package/skills/antislop-copywriting/SKILL.md +36 -1
- package/skills/brainstorming/SKILL.md +60 -38
- package/skills/codebase-design/DEEPENING.md +37 -0
- package/skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
- package/skills/codebase-design/SKILL.md +114 -0
- package/skills/domain-modeling/ADR-FORMAT.md +47 -0
- package/skills/domain-modeling/GLOSSARY-FORMAT.md +60 -0
- package/skills/domain-modeling/SKILL.md +74 -0
- package/skills/executing-plans/SKILL.md +6 -4
- package/skills/grill-me/SKILL.md +65 -0
- package/skills/handoff/SKILL.md +64 -0
- package/skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
- package/skills/improve-codebase-architecture/SKILL.md +71 -0
- package/skills/owasp-security/reference/config-and-supply-chain.md +346 -344
- package/skills/owasp-security/reference/languages.md +378 -372
- package/skills/owasp-security/reference/owasp-report.md +1144 -1140
- package/skills/owasp-security/reference/review-checklist.md +134 -132
- package/skills/subagent-driven-development/SKILL.md +7 -4
- package/skills/to-spec/SKILL.md +75 -0
- package/skills/to-tickets/SKILL.md +105 -0
- package/skills/wayfinder/SKILL.md +128 -0
|
@@ -0,0 +1,275 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"upstream": "https://github.com/miqdadbadjuber/anti-slop",
|
|
4
|
+
"skills": [
|
|
5
|
+
"antislop",
|
|
6
|
+
"antislop-code",
|
|
7
|
+
"antislop-copywriting",
|
|
8
|
+
"antislop-human",
|
|
9
|
+
"antislop-layoutmobile",
|
|
10
|
+
"antislop-ui"
|
|
11
|
+
],
|
|
12
|
+
"current": [
|
|
13
|
+
"941b153"
|
|
14
|
+
],
|
|
15
|
+
"latest": "4520786d3dff09eb295a2c563c7fab50063f00fb",
|
|
16
|
+
"status": "NEEDS_AUDIT",
|
|
17
|
+
"message": "Remote HEAD: 4520786d3d"
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"upstream": "https://github.com/obra/superpowers",
|
|
21
|
+
"skills": [
|
|
22
|
+
"brainstorming",
|
|
23
|
+
"diagnosing-superpowers",
|
|
24
|
+
"dispatching-parallel-agents",
|
|
25
|
+
"executing-plans",
|
|
26
|
+
"finishing-a-development-branch",
|
|
27
|
+
"receiving-code-review",
|
|
28
|
+
"requesting-code-review",
|
|
29
|
+
"subagent-driven-development",
|
|
30
|
+
"systematic-debugging",
|
|
31
|
+
"test-driven-development",
|
|
32
|
+
"using-git-worktrees",
|
|
33
|
+
"using-superpowers",
|
|
34
|
+
"verification-before-completion",
|
|
35
|
+
"writing-plans",
|
|
36
|
+
"writing-skills"
|
|
37
|
+
],
|
|
38
|
+
"current": [
|
|
39
|
+
"2ce8aa1"
|
|
40
|
+
],
|
|
41
|
+
"latest": "22f0b463e7a5e579904dd6211a520321035526f7",
|
|
42
|
+
"status": "NEEDS_AUDIT",
|
|
43
|
+
"message": "Remote HEAD: 22f0b463e7"
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"upstream": "https://github.com/Leonxlnx/taste-skill",
|
|
47
|
+
"skills": [
|
|
48
|
+
"brandkit",
|
|
49
|
+
"image-to-code-skill",
|
|
50
|
+
"imagegen-frontend-mobile",
|
|
51
|
+
"imagegen-frontend-web",
|
|
52
|
+
"output-skill",
|
|
53
|
+
"taste-skill"
|
|
54
|
+
],
|
|
55
|
+
"current": [
|
|
56
|
+
"12af471"
|
|
57
|
+
],
|
|
58
|
+
"latest": "f6b76575f949707b4e3c37cd86cb44b0b98643e8",
|
|
59
|
+
"status": "NEEDS_AUDIT",
|
|
60
|
+
"message": "Remote HEAD: f6b76575f9"
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
"upstream": "https://github.com/Leonxlnx/taste-skill-classics",
|
|
64
|
+
"skills": [
|
|
65
|
+
"brutalist-skill",
|
|
66
|
+
"minimalist-skill",
|
|
67
|
+
"redesign-skill",
|
|
68
|
+
"soft-skill",
|
|
69
|
+
"stitch-skill"
|
|
70
|
+
],
|
|
71
|
+
"current": [
|
|
72
|
+
"5e08c93"
|
|
73
|
+
],
|
|
74
|
+
"latest": "5e08c9383dc4ad7fc0df70e1ac8cfa09ec356305",
|
|
75
|
+
"status": "UP_TO_DATE",
|
|
76
|
+
"message": "Remote HEAD: 5e08c9383d"
|
|
77
|
+
},
|
|
78
|
+
{
|
|
79
|
+
"upstream": "https://github.com/JuliusBrussee/caveman",
|
|
80
|
+
"skills": [
|
|
81
|
+
"caveman"
|
|
82
|
+
],
|
|
83
|
+
"current": [
|
|
84
|
+
"2e068f7"
|
|
85
|
+
],
|
|
86
|
+
"latest": "3dc497a7f858c774d6e15b25e8c6120ef3a0eda8",
|
|
87
|
+
"status": "NEEDS_AUDIT",
|
|
88
|
+
"message": "Remote HEAD: 3dc497a7f8"
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
"upstream": "https://github.com/bepaldes/heimdall-agent",
|
|
92
|
+
"skills": [
|
|
93
|
+
"claude-collaborator",
|
|
94
|
+
"gemini-collaborator",
|
|
95
|
+
"project-hygiene",
|
|
96
|
+
"codex-collaborator",
|
|
97
|
+
"progressive-disclosure",
|
|
98
|
+
"communication-doctrine",
|
|
99
|
+
"threat-modeling",
|
|
100
|
+
"mcp-engineering"
|
|
101
|
+
],
|
|
102
|
+
"current": [
|
|
103
|
+
"v1.0.0"
|
|
104
|
+
],
|
|
105
|
+
"latest": "first-party (local)",
|
|
106
|
+
"status": "UP_TO_DATE",
|
|
107
|
+
"message": "Local first-party skill"
|
|
108
|
+
},
|
|
109
|
+
{
|
|
110
|
+
"upstream": "https://github.com/cloudflare/security-audit-skill",
|
|
111
|
+
"skills": [
|
|
112
|
+
"cloudflare-security-audit"
|
|
113
|
+
],
|
|
114
|
+
"current": [
|
|
115
|
+
"c1c8a8c"
|
|
116
|
+
],
|
|
117
|
+
"latest": "c1c8a8c1471069fb0e188eeaff69b8e8db6564a8",
|
|
118
|
+
"status": "UP_TO_DATE",
|
|
119
|
+
"message": "Remote HEAD: c1c8a8c147"
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"upstream": "https://github.com/multica-ai/andrej-karpathy-skills",
|
|
123
|
+
"skills": [
|
|
124
|
+
"karpathy-guidelines"
|
|
125
|
+
],
|
|
126
|
+
"current": [
|
|
127
|
+
"2c60614"
|
|
128
|
+
],
|
|
129
|
+
"latest": "2c606141936f1eeef17fa3043a72095b4765b9c2",
|
|
130
|
+
"status": "UP_TO_DATE",
|
|
131
|
+
"message": "Remote HEAD: 2c60614193"
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
"upstream": "https://github.com/agamm/claude-code-owasp",
|
|
135
|
+
"skills": [
|
|
136
|
+
"owasp-security"
|
|
137
|
+
],
|
|
138
|
+
"current": [
|
|
139
|
+
"8ac7965"
|
|
140
|
+
],
|
|
141
|
+
"latest": "1ae29cb22518560e3625d77f2ae64f61647d9201",
|
|
142
|
+
"status": "NEEDS_AUDIT",
|
|
143
|
+
"message": "Remote HEAD: 1ae29cb225"
|
|
144
|
+
},
|
|
145
|
+
{
|
|
146
|
+
"upstream": "https://github.com/DietrichGebert/ponytail",
|
|
147
|
+
"skills": [
|
|
148
|
+
"ponytail"
|
|
149
|
+
],
|
|
150
|
+
"current": [
|
|
151
|
+
"96608e0"
|
|
152
|
+
],
|
|
153
|
+
"latest": "96608e078b2d5ea607c5c3b8b5a54d1c1fba6846",
|
|
154
|
+
"status": "UP_TO_DATE",
|
|
155
|
+
"message": "Remote HEAD: 96608e078b"
|
|
156
|
+
},
|
|
157
|
+
{
|
|
158
|
+
"upstream": "https://github.com/neondatabase/postgres-skills",
|
|
159
|
+
"skills": [
|
|
160
|
+
"postgres-best-practices"
|
|
161
|
+
],
|
|
162
|
+
"current": [
|
|
163
|
+
"27fe45e"
|
|
164
|
+
],
|
|
165
|
+
"latest": "27fe45e0f71ea89a6eaf9ea4d2e4068957c81c26",
|
|
166
|
+
"status": "UP_TO_DATE",
|
|
167
|
+
"message": "Remote HEAD: 27fe45e0f7"
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
"upstream": "https://github.com/blencorp/security-sweep",
|
|
171
|
+
"skills": [
|
|
172
|
+
"security-audit-sweep"
|
|
173
|
+
],
|
|
174
|
+
"current": [
|
|
175
|
+
"v1.0.0"
|
|
176
|
+
],
|
|
177
|
+
"latest": "75526136b29d55083ce58bd37cec13eb076c9cb7",
|
|
178
|
+
"status": "NEEDS_AUDIT",
|
|
179
|
+
"message": "Remote HEAD: 75526136b2"
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
"upstream": "https://github.com/snyk/agent-scan",
|
|
183
|
+
"skills": [
|
|
184
|
+
"snyk-agent-scan"
|
|
185
|
+
],
|
|
186
|
+
"current": [
|
|
187
|
+
"a69e1c3"
|
|
188
|
+
],
|
|
189
|
+
"latest": "59def8c624f9d7bef4d49992a4da5e68f83f4e75",
|
|
190
|
+
"status": "NEEDS_AUDIT",
|
|
191
|
+
"message": "Remote HEAD: 59def8c624"
|
|
192
|
+
},
|
|
193
|
+
{
|
|
194
|
+
"upstream": "https://github.com/usestrix/strix",
|
|
195
|
+
"skills": [
|
|
196
|
+
"strix-security"
|
|
197
|
+
],
|
|
198
|
+
"current": [
|
|
199
|
+
"6b7ae2e"
|
|
200
|
+
],
|
|
201
|
+
"latest": "01119158f8f50027591cbae73f37cf0a2fea644d",
|
|
202
|
+
"status": "NEEDS_AUDIT",
|
|
203
|
+
"message": "Remote HEAD: 01119158f8"
|
|
204
|
+
},
|
|
205
|
+
{
|
|
206
|
+
"upstream": "https://github.com/trailofbits/skills",
|
|
207
|
+
"skills": [
|
|
208
|
+
"trailofbits-audit-context",
|
|
209
|
+
"trailofbits-insecure-defaults",
|
|
210
|
+
"trailofbits-triage-brocards"
|
|
211
|
+
],
|
|
212
|
+
"current": [
|
|
213
|
+
"2be6433"
|
|
214
|
+
],
|
|
215
|
+
"latest": "e4dd0bb5b15535f7c5a0834187dffba6ac37e4ff",
|
|
216
|
+
"status": "NEEDS_AUDIT",
|
|
217
|
+
"message": "Remote HEAD: e4dd0bb5b1"
|
|
218
|
+
},
|
|
219
|
+
{
|
|
220
|
+
"upstream": "https://github.com/unclebob/ub-mode",
|
|
221
|
+
"skills": [
|
|
222
|
+
"clean-code"
|
|
223
|
+
],
|
|
224
|
+
"current": [
|
|
225
|
+
"57a8bdd"
|
|
226
|
+
],
|
|
227
|
+
"latest": "3da62bf3fcfd2034de41f30d920d2739e566171f",
|
|
228
|
+
"status": "NEEDS_AUDIT",
|
|
229
|
+
"message": "Remote HEAD: 3da62bf3fc"
|
|
230
|
+
},
|
|
231
|
+
{
|
|
232
|
+
"upstream": "https://herdr.dev",
|
|
233
|
+
"skills": [
|
|
234
|
+
"herdr"
|
|
235
|
+
],
|
|
236
|
+
"current": [
|
|
237
|
+
"v0.1.0"
|
|
238
|
+
],
|
|
239
|
+
"latest": "UNKNOWN",
|
|
240
|
+
"status": "ERROR",
|
|
241
|
+
"message": "fatal: https://herdr.dev/info/refs not valid: is this a git repository?"
|
|
242
|
+
},
|
|
243
|
+
{
|
|
244
|
+
"upstream": "https://github.com/cursor/plugins",
|
|
245
|
+
"skills": [
|
|
246
|
+
"thermo",
|
|
247
|
+
"pstack-discipline"
|
|
248
|
+
],
|
|
249
|
+
"current": [
|
|
250
|
+
"main"
|
|
251
|
+
],
|
|
252
|
+
"latest": "a5539b15a3d56e04992565aafee2b37051329ce3",
|
|
253
|
+
"status": "NEEDS_AUDIT",
|
|
254
|
+
"message": "Remote HEAD: a5539b15a3"
|
|
255
|
+
},
|
|
256
|
+
{
|
|
257
|
+
"upstream": "https://github.com/mattpocock/skills",
|
|
258
|
+
"skills": [
|
|
259
|
+
"codebase-design",
|
|
260
|
+
"domain-modeling",
|
|
261
|
+
"improve-codebase-architecture",
|
|
262
|
+
"to-spec",
|
|
263
|
+
"to-tickets",
|
|
264
|
+
"wayfinder",
|
|
265
|
+
"grill-me",
|
|
266
|
+
"handoff"
|
|
267
|
+
],
|
|
268
|
+
"current": [
|
|
269
|
+
"main"
|
|
270
|
+
],
|
|
271
|
+
"latest": "5863806dd4e15c63174bee4e7515a4256792ecfa",
|
|
272
|
+
"status": "NEEDS_AUDIT",
|
|
273
|
+
"message": "Remote HEAD: 5863806dd4"
|
|
274
|
+
}
|
|
275
|
+
]
|
package/doctrine/AGENTS.md
CHANGED
|
@@ -29,8 +29,11 @@ Universal directives for Google Antigravity, Claude Code, and OpenAI Codex CLI a
|
|
|
29
29
|
<planning_protocol>
|
|
30
30
|
When receiving an EXPLICIT planning or interview command (/plan or /grill-me):
|
|
31
31
|
1. TURN 1 INTERACTIVE GRILLING:
|
|
32
|
-
-
|
|
32
|
+
- Autonomous fact-finding first: inspect the codebase; never ask questions the files answer.
|
|
33
|
+
- Focus strictly on the active decision frontier (unsettled decisions whose prerequisites are met).
|
|
34
|
+
- Ask 2-3 probing questions in the "Yes-to-Approve" format (❓ Question + ➡️ Recommended answer).
|
|
33
35
|
- Propose 2 distinct concrete approaches with explicit architectural trade-offs.
|
|
36
|
+
- For architectural scope, record settled choices in ADRs (`docs/adr/`).
|
|
34
37
|
- Render Scope, Questions, and Alternatives clearly in chat markdown, then pause for user approval.
|
|
35
38
|
2. TURN 2+ MULTI-MODEL PLAN GENERATION:
|
|
36
39
|
- Generate an authoritative plan strictly following `05-canonical-plan-template.md` (resolved via `playbooks/`, `../playbooks/`, or `../heimdall-agent/playbooks/`).
|
package/lib/catalog-sync.cjs
CHANGED
|
@@ -23,7 +23,10 @@ function syncCatalogCounts(rootDir, dryRun = false) {
|
|
|
23
23
|
const catalog = JSON.parse(rawCatalog);
|
|
24
24
|
const skillCount = Object.keys(catalog.skills || {}).length;
|
|
25
25
|
const suiteCount = Object.keys(catalog.suites || {}).length;
|
|
26
|
-
const
|
|
26
|
+
const multiSuites = Object.values(catalog.suites || {}).filter(s => s.type === 'Multi-Skill Suite');
|
|
27
|
+
const multiSuiteCount = multiSuites.length;
|
|
28
|
+
const multiModuleCount = multiSuites.reduce((acc, s) => acc + (s.modules ? s.modules.length : 1), 0);
|
|
29
|
+
const standaloneCount = suiteCount - multiSuiteCount;
|
|
27
30
|
const agentsDir = path.join(rootDir, 'agents');
|
|
28
31
|
const agentCount = fs.existsSync(agentsDir)
|
|
29
32
|
? fs.readdirSync(agentsDir).filter(f => f.endsWith('.md')).length
|
|
@@ -94,7 +97,8 @@ function syncCatalogCounts(rootDir, dryRun = false) {
|
|
|
94
97
|
content = content.replace(/synchronizes \*\*\d+ specialized agent personas\*\*/g, `synchronizes **${agentCount} specialized agent personas**`);
|
|
95
98
|
content = content.replace(/\* \*\*Specialized Agent Personas\*\*:\s*\d+\s*predefined roles/g, `* **Specialized Agent Personas**: ${agentCount} predefined roles`);
|
|
96
99
|
content = content.replace(/(\|\s*`agents\/`\s*\|\s*`~\/\.<tool>\/agents\/`\s*\|\s*)\d+(\s*specialized agent persona)/g, `$1${agentCount}$2`);
|
|
97
|
-
content = content.replace(/(Heimdall organizes capabilities into \*\*
|
|
100
|
+
content = content.replace(/(Heimdall organizes capabilities into \*\*)\d+(\s*Core Multi-Skill Suites \()\d+(\s*modules\)\*\* and \*\*)\d+(\s*Standalone Toolkits \()\d+(\s*modules\)\*\*)/g, `$1${multiSuiteCount}$2${multiModuleCount}$3${standaloneCount}$4${standaloneCount}$5`);
|
|
101
|
+
content = content.replace(/(#### Core Multi-Skill Suites \()\d+(\s*Suites \/ \s*)\d+(\s*Modules\))/g, `$1${multiSuiteCount}$2${multiModuleCount}$3`);
|
|
98
102
|
content = content.replace(/(#### Standalone Toolkits \()\d+(\s*Curated Toolkits \/ \s*)\d+(\s*Modules\))/g, `$1${standaloneCount}$2${standaloneCount}$3`);
|
|
99
103
|
|
|
100
104
|
if (content !== orig) {
|
|
@@ -126,7 +130,8 @@ function syncCatalogCounts(rootDir, dryRun = false) {
|
|
|
126
130
|
content = content.replace(/sincroniza \*\*\d+ personas de agentes especializados\*\*/g, `sincroniza **${agentCount} personas de agentes especializados**`);
|
|
127
131
|
content = content.replace(/\* \*\*Personas de Agentes Especializados\*\*:\s*\d+\s*papéis predefinidos/g, `* **Personas de Agentes Especializados**: ${agentCount} papéis predefinidos`);
|
|
128
132
|
content = content.replace(/(\|\s*`agents\/`\s*\|\s*`~\/\.<ferramenta>\/agents\/`\s*\|\s*)\d+(\s*definições de personas)/g, `$1${agentCount}$2`);
|
|
129
|
-
content = content.replace(/(O Heimdall organiza as capacidades em \*\*
|
|
133
|
+
content = content.replace(/(O Heimdall organiza as capacidades em \*\*)\d+(\s*Suítes Multi-Skill Principais \()\d+(\s*módulos\)\*\* e \*\*)\d+(\s*Toolkits Independentes \()\d+(\s*módulos\)\*\*)/g, `$1${multiSuiteCount}$2${multiModuleCount}$3${standaloneCount}$4${standaloneCount}$5`);
|
|
134
|
+
content = content.replace(/(#### Suítes Multi-Skill Principais \()\d+(\s*Suítes \/ \s*)\d+(\s*Módulos\))/g, `$1${multiSuiteCount}$2${multiModuleCount}$3`);
|
|
130
135
|
content = content.replace(/(#### Toolkits Independentes \()\d+(\s*Toolkits Curados \/ \s*)\d+(\s*Módulos\))/g, `$1${standaloneCount}$2${standaloneCount}$3`);
|
|
131
136
|
|
|
132
137
|
if (content !== orig) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "heimdall-agent",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "Autonomous multi-agent engineering sentinel & bootstrapper. Synchronizes specialized agent personas, curated skills, and universal doctrine across Google Antigravity, Claude Code, OpenAI Codex CLI, Hermes Agent, OpenClaw, and Claude Desktop.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -23,27 +23,31 @@ Before generating any code, creating plans, or taking action on any user request
|
|
|
23
23
|
- **Tier 3: Architectural**: Subsystem addition, schema migration, auth boundary, or multi-component flow. Full Google EGM Pipeline (Artifact-First design spec in `docs/designs/<feature>.md` + 4-stage Goldfish review: Zoom Out, Comprehension, Critic, Readiness).
|
|
24
24
|
- Never assume missing requirements. Uncover implicit user assumptions upfront.
|
|
25
25
|
|
|
26
|
-
2. **The
|
|
27
|
-
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
c) The exact definition of success and acceptance criteria.
|
|
26
|
+
2. **The Design Tree Frontier & Questioning Protocol**:
|
|
27
|
+
- **Autonomous Fact-Finding First**: Inspect files, configs, and existing helpers before asking. Never ask the human questions the repository already answers.
|
|
28
|
+
- **Frontier Rounds**: Ask only questions whose prerequisites are settled now. If Question B depends on Question A's answer, defer Question B to the next round.
|
|
29
|
+
- **The "Yes-to-Approve" Triage Format**: Formulate each question with an explicit recommendation so the user can accept by replying *"yes"* or providing a 1-line tweak.
|
|
31
30
|
|
|
32
31
|
3. **Present 2 Concrete Architectural Alternatives**:
|
|
33
32
|
- Offer Approach A (minimal, lighter, faster) vs. Approach B (robust, extensible).
|
|
34
33
|
- Detail the explicit tradeoffs of each.
|
|
35
34
|
- Declare your professional recommendation with clear reasoning.
|
|
35
|
+
- **ADR Synchronization**: For Tier 3 architectural decisions, record settled choices in `docs/adr/YYYY-MM-DD-<title>.md`.
|
|
36
36
|
|
|
37
37
|
4. **Hard Gate**:
|
|
38
|
-
- MANDATORY VISIBLE OUTPUT (ANTI-PATTERN BAN): NEVER keep the questions or alternatives inside internal thinking/scratchpads. NEVER output a bare "awaiting answers..." blocker message. You MUST render the Scope, Questions, and Alternatives explicitly in user-visible chat markdown using this exact template:
|
|
38
|
+
- MANDATORY VISIBLE OUTPUT (ANTI-PATTERN BAN): NEVER keep the questions or alternatives inside internal thinking/scratchpads. NEVER output a bare "awaiting answers..." blocker message. You MUST render the Scope, Frontier Questions, and Alternatives explicitly in user-visible chat markdown using this exact template:
|
|
39
39
|
```markdown
|
|
40
40
|
### 1. Scope Classification
|
|
41
41
|
- **Scope**: [Spike / Bounded / Architectural]
|
|
42
42
|
|
|
43
|
-
### 2.
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
43
|
+
### 2. Frontier Questions (Yes-to-Approve Format)
|
|
44
|
+
❓ **Q1 - [Decision Title]**: [Context, edge cases, and options]
|
|
45
|
+
➡️ **Recommended**: [Explicit recommendation + rationale]
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
❓ **Q2 - [Decision Title]**: [Context, limits, boundary conditions]
|
|
50
|
+
➡️ **Recommended**: [Explicit recommendation + rationale]
|
|
47
51
|
|
|
48
52
|
### 3. Concrete Alternatives
|
|
49
53
|
- **Alternative 1**: [Description + architectural trade-offs]
|
|
@@ -16,11 +16,19 @@ When reviewing code, pull requests, or git diffs, assume that edge cases and def
|
|
|
16
16
|
- **"No Glazing" Rule**: Eliminate sycophancy. Never use validating adjectives like "brilliant," "great," "smart," "perfect," or "spot-on." Ban apologies ("I apologize"). Lead with what is wrong, missing, or risky.
|
|
17
17
|
- **Plain-English Standard**: Plain, direct, jargon-free technical English. No ungrounded promotional adjectives or buzzwords.
|
|
18
18
|
|
|
19
|
-
## 2.
|
|
20
|
-
- **Tier 1 (
|
|
21
|
-
- **
|
|
19
|
+
## 2. 3-Tier Review & Handoff Policy
|
|
20
|
+
- **Tier 1 (Spikes & Local Fixes < 50 LOC)**:
|
|
21
|
+
- **Zero Review Ceremony**. Author verifies empirically via terminating automated tests (`npm test`, `pytest`).
|
|
22
|
+
- No peer model review or handoff document required.
|
|
23
|
+
- **Tier 2 (Bounded Features & Subsystems)**:
|
|
24
|
+
- **Single Peer Reviewer Gate**. One peer model (e.g. Claude implements -> Gemini reviews; or vice-versa) to prevent self-review blindness. Multiple reviewers are NOT needed.
|
|
25
|
+
- **Lean Handoff**: Feed the reviewer using the `handoff` skill (pointer to spec, target branch, and diff) to strictly maintain Goldfish blinding without leaking conversational bias.
|
|
26
|
+
- Single-pass adversarial critique targeting edge cases, security, and anti-slop code hygiene.
|
|
27
|
+
- **Tier 3 (Architectural, Auth, Schema Migrations & High-Stakes)**:
|
|
28
|
+
- **Multi-Model Consensus & Full Handoff**. Seeded with a formal `handoff` document referencing ADRs (`docs/adr/`) and specifications (`docs/designs/`).
|
|
29
|
+
- Mandatory **5-round convergence loop** with a structured findings ledger across multiple peer models.
|
|
22
30
|
|
|
23
|
-
## 3. The 5-Round Convergence Ledger Protocol
|
|
31
|
+
## 3. The 5-Round Convergence Ledger Protocol (Tier 3)
|
|
24
32
|
For Tier 2 reviews, all findings must be tracked in an authoritative ledger:
|
|
25
33
|
|
|
26
34
|
```markdown
|
|
@@ -17,7 +17,9 @@
|
|
|
17
17
|
# Plan: [Feature / Task Name]
|
|
18
18
|
|
|
19
19
|
## 1. Active Skills & Directives Checklist
|
|
20
|
-
- [x] `brainstorming` — Intent discovered, assumptions surfaced, tradeoffs evaluated
|
|
20
|
+
- [x] `grill-me` / `brainstorming` — Intent discovered via Frontier questioning, assumptions surfaced, tradeoffs evaluated
|
|
21
|
+
- [x] `domain-modeling` — [Required for Tier 3] Architectural decisions recorded in `docs/adr/`, domain terms aligned
|
|
22
|
+
- [x] `codebase-design` — Deep module boundaries established, pass-through layers rejected, deletion test applied
|
|
21
23
|
- [x] `karpathy-guidelines` — Simplicity first, surgical edits, no speculative bloat
|
|
22
24
|
- [x] `antislop` — Clean comments, no AI boilerplate, accessible contrast
|
|
23
25
|
- [x] `communication-doctrine` — BLUF macro layout, STE imperative steps (<=20 words), zero vague qualifiers
|
package/setup.mjs
CHANGED
|
@@ -823,7 +823,7 @@ ${colors.bold}PRIMARY SUBCOMMANDS:${colors.reset}
|
|
|
823
823
|
${colors.green}help${colors.reset} (or ${colors.dim}--help, -h${colors.reset}) Display this parameter and command reference
|
|
824
824
|
|
|
825
825
|
${colors.bold}SETUP & BOOTSTRAP OPTIONS:${colors.reset}
|
|
826
|
-
${colors.yellow}--profile <name>${colors.reset} Skill profile tier: full (
|
|
826
|
+
${colors.yellow}--profile <name>${colors.reset} Skill profile tier: full (64), minimal (16), security (12), design (14) [default: full]
|
|
827
827
|
${colors.yellow}--agents <targets>${colors.reset} Comma-separated harnesses: claude, gemini, codex, hermes, openclaw, desktop, all [default: all]
|
|
828
828
|
${colors.yellow}--link / --no-link${colors.reset} Use live NTFS junctions / symlinks vs static copies [default: false in wizard, true recommended]
|
|
829
829
|
${colors.yellow}--clean${colors.reset} Wipe legacy skills from target directory before deploying
|
|
@@ -1702,7 +1702,7 @@ async function runInteractive(options, detected) {
|
|
|
1702
1702
|
}
|
|
1703
1703
|
|
|
1704
1704
|
console.log(`\n${colors.yellow}Select Installation Profile Tier:${colors.reset}`);
|
|
1705
|
-
console.log(` 1. full - All
|
|
1705
|
+
console.log(` 1. full - All 64 curated skills (Complete Powerhouse)`);
|
|
1706
1706
|
console.log(` 2. minimal - 16 core skills (Planning, TDD, Anti-Slop, Taste, Hygiene)`);
|
|
1707
1707
|
console.log(` 3. security - 12 security skills (Differential HTTP probing, OWASP, Trail of Bits)`);
|
|
1708
1708
|
console.log(` 4. design - 14 frontend skills (Taste, GSAP motion, Brandkit, Tokens)`);
|
|
@@ -100,6 +100,16 @@ allowed-tools: Read Write Edit Glob Grep
|
|
|
100
100
|
> Next.js caches data at multiple layers, including request memoization, the data cache, and the router cache.
|
|
101
101
|
- **Rule:** R-36.
|
|
102
102
|
|
|
103
|
+
### Temporal Runway Clichés
|
|
104
|
+
|
|
105
|
+
- **The pattern:** opening a piece, section, or paragraph with a sweeping temporal generalization: "In today's fast-paced world", "In an era of rapid technological disruption", "In today's ever-evolving digital landscape", "In an increasingly connected world".
|
|
106
|
+
- **Why it reads as AI:** it is empty runway. It establishes a broad, indisputable setting before saying an ordinary thing, padding word count and delaying the real subject. Real writers start directly with the subject itself.
|
|
107
|
+
- **Before:**
|
|
108
|
+
> In today's fast-paced digital landscape, engineering teams struggle to keep internal documentation fresh and accurate.
|
|
109
|
+
- **After:**
|
|
110
|
+
> Engineering teams struggle to keep internal documentation fresh and accurate.
|
|
111
|
+
- **Rule:** R-16, R-36.
|
|
112
|
+
|
|
103
113
|
### All-Caps Emphasis
|
|
104
114
|
|
|
105
115
|
- **The pattern:** a whole sentence, clause, or phrase in ALL CAPS inside a paragraph to shout emphasis: "The launch is ready and WE NEED TO MOVE NOW before the window closes."
|
|
@@ -175,6 +185,16 @@ allowed-tools: Read Write Edit Glob Grep
|
|
|
175
185
|
> The old rules no longer applied, and every page had to be designed from scratch.
|
|
176
186
|
- **Rule:** R-36.
|
|
177
187
|
|
|
188
|
+
### Theatrical Takeaways
|
|
189
|
+
|
|
190
|
+
- **The pattern:** dramatic single-line coaching commands and conclusion-labeling: "Read that again.", "Let that sink in.", "The message is clear:", "That distinction matters.", "The takeaway is simple:", "Here is the bottom line:".
|
|
191
|
+
- **Why it reads as AI:** it directs the reader how to feel or react to an ordinary statement instead of letting the claim stand on its own evidence. It is stage direction pretending to be copywriting.
|
|
192
|
+
- **Before:**
|
|
193
|
+
> Automated rollbacks cut customer downtime by 40%. Read that again. Let that sink in.
|
|
194
|
+
- **After:**
|
|
195
|
+
> Automated rollbacks cut customer downtime by 40%.
|
|
196
|
+
- **Rule:** R-36.
|
|
197
|
+
|
|
178
198
|
### Synonym Cycling
|
|
179
199
|
|
|
180
200
|
- **The pattern:** swapping synonyms to avoid repeating a word: "the protagonist faces a challenge, the main character must adapt, the central figure persists".
|
|
@@ -280,6 +300,19 @@ allowed-tools: Read Write Edit Glob Grep
|
|
|
280
300
|
- **Rule:** R-36.
|
|
281
301
|
- **Carve-out:** the `- **Tell:**` / `- **Why:**` / `- **Fix:**` headers that structure every antislop skill entry are a documentation convention, not the header-restates-the-item habit above, and are exempt.
|
|
282
302
|
|
|
303
|
+
### Title Case in List Elements
|
|
304
|
+
|
|
305
|
+
- **The pattern:** capitalizing every word in bullet items, feature cards, or body list entries: "- Comprehensive Security Audits Across All Repositories".
|
|
306
|
+
- **Why it reads as AI:** models default to title case for list elements and short blocks to make them feel official. Sentence case is easier to read and sounds like a human wrote it.
|
|
307
|
+
- **Before:**
|
|
308
|
+
> - Comprehensive Security Audits Across All Repositories
|
|
309
|
+
> - Instant Notifications Delivered Right To Your Team's Slack Channel
|
|
310
|
+
- **After:**
|
|
311
|
+
> - Comprehensive security audits across all repositories
|
|
312
|
+
> - Instant notifications delivered to your team's Slack channel
|
|
313
|
+
- **Rule:** R-36.
|
|
314
|
+
- **Not a ban:** proper nouns, acronyms, and genuine publication titles keep their capitalization. The tell is capitalizing every word in a regular list item or feature bullet.
|
|
315
|
+
|
|
283
316
|
### Emojis in Headings
|
|
284
317
|
|
|
285
318
|
- **The pattern:** decoration emojis leading headings or bullets: 🚀 Launch, 💡 Key insight, ✅ Next steps.
|
|
@@ -367,6 +400,8 @@ Run these alongside the core Delivery Gate when the task is copy work. Every lin
|
|
|
367
400
|
- [ ] No all-caps emphasis clauses: emphasis written into the sentence, not shouted with caps (R-36)
|
|
368
401
|
- [ ] Every sentence names its actor: no actorless passive, no abstraction given a human verb, where a real subject was available (R-02, R-16)
|
|
369
402
|
- [ ] CTAs specific to the action, not generic templates (R-15)
|
|
370
|
-
- [ ] No AI-rhythm tells: no forced rule of three, no negative parallelism, no staccato drama, no aphorism formulas, no false ranges (R-36)
|
|
403
|
+
- [ ] No AI-rhythm tells: no forced rule of three, no negative parallelism, no staccato drama, no theatrical takeaways, no aphorism formulas, no false ranges (R-36)
|
|
404
|
+
- [ ] No temporal runway clichés ("in today's fast-paced world", "in an increasingly digital landscape") padding openings (R-16, R-36)
|
|
405
|
+
- [ ] List items and bullet points use natural sentence case, not mechanical title case on every word (R-36)
|
|
371
406
|
- [ ] Voice present: the copy has a real voice (the user's sample or a clearly chosen tone), not a sterile default (R-37)
|
|
372
407
|
- [ ] Read aloud: the copy sounds like a person wrote it, not like a model padded it
|