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.
Files changed (41) hide show
  1. package/README.md +13 -13
  2. package/README.pt-BR.md +36 -22
  3. package/agents/code-sentinel.md +7 -1
  4. package/agents/modernizer.md +4 -2
  5. package/agents/orchestrator.md +20 -7
  6. package/agents/reviewer.md +2 -0
  7. package/config/agents.json +11 -1
  8. package/config/mcp.json +1 -1
  9. package/config/profiles.json +1 -1
  10. package/config/skills.json +762 -683
  11. package/docs/SKILLS.md +96 -74
  12. package/docs/runs/skill-audit/2026-11-12-compare-report.json +1028 -0
  13. package/docs/runs/skill-audit/2026-11-12-upstream-audit.json +275 -0
  14. package/doctrine/AGENTS.md +4 -1
  15. package/lib/catalog-sync.cjs +8 -3
  16. package/package.json +1 -1
  17. package/playbooks/01-interactive-grilling-gate.md +14 -10
  18. package/playbooks/03-adversarial-code-review.md +12 -4
  19. package/playbooks/05-canonical-plan-template.md +3 -1
  20. package/setup.mjs +2 -2
  21. package/skills/antislop-copywriting/SKILL.md +36 -1
  22. package/skills/brainstorming/SKILL.md +60 -38
  23. package/skills/codebase-design/DEEPENING.md +37 -0
  24. package/skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
  25. package/skills/codebase-design/SKILL.md +114 -0
  26. package/skills/domain-modeling/ADR-FORMAT.md +47 -0
  27. package/skills/domain-modeling/GLOSSARY-FORMAT.md +60 -0
  28. package/skills/domain-modeling/SKILL.md +74 -0
  29. package/skills/executing-plans/SKILL.md +6 -4
  30. package/skills/grill-me/SKILL.md +65 -0
  31. package/skills/handoff/SKILL.md +64 -0
  32. package/skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
  33. package/skills/improve-codebase-architecture/SKILL.md +71 -0
  34. package/skills/owasp-security/reference/config-and-supply-chain.md +346 -344
  35. package/skills/owasp-security/reference/languages.md +378 -372
  36. package/skills/owasp-security/reference/owasp-report.md +1144 -1140
  37. package/skills/owasp-security/reference/review-checklist.md +134 -132
  38. package/skills/subagent-driven-development/SKILL.md +7 -4
  39. package/skills/to-spec/SKILL.md +75 -0
  40. package/skills/to-tickets/SKILL.md +105 -0
  41. 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
+ ]
@@ -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
- - Interrogate assumptions: Ask 2-3 probing questions on limits, failure modes, and edge cases.
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/`).
@@ -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 standaloneCount = suiteCount - 5; // 5 Core Suites + remainder Standalone
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 \*\*5 Core Multi-Skill Suites \(37 modules\)\*\* and \*\*)\d+(\s*Standalone Toolkits \()\d+(\s*modules\)\*\*)/g, `$1${standaloneCount}$2${standaloneCount}$3`);
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 \*\*5 Suítes Multi-Skill Principais \(37 módulos\)\*\* e \*\*)\d+(\s*Toolkits Independentes \()\d+(\s*módulos\)\*\*)/g, `$1${standaloneCount}$2${standaloneCount}$3`);
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.1.0",
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 3-Point Questioning Rule**:
27
- - Ask at least 2–3 probing questions about:
28
- a) Non-obvious edge cases, error states, and boundary conditions.
29
- b) Data flow, persistence, and concurrency/race concerns.
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. Probing Questions
44
- 1. [Question 1: edge cases / failure modes]
45
- 2. [Question 2: limits / boundary conditions]
46
- 3. [Question 3: integration / performance constraints]
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. Two-Tier Review Trigger
20
- - **Tier 1 (Bounded & Routine Tasks)**: Single-pass adversarial critique targeting edge cases, security, and anti-slop code hygiene.
21
- - **Tier 2 (Architectural & High-Stakes Tasks)**: Mandatory **5-round convergence loop** with a structured findings ledger.
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 (56), minimal (16), security (12), design (14) [default: 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 56 curated skills (Complete Powerhouse)`);
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