Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

fix(ci): catalog sync, markdownlint, unicode safety, unsupported frontmatter key

Eryk Orłowskif810c19c1338
diff --git a/.agents/skills/brand-discovery/SKILL.md b/.agents/skills/brand-discovery/SKILL.md
index 6e8769d7a..9006a079d 100644
--- a/.agents/skills/brand-discovery/SKILL.md
+++ b/.agents/skills/brand-discovery/SKILL.md
@@ -6,7 +6,6 @@ description: >-
personality, voice, narrative, and founder-brand tension across 8 modules
using laddering, 5 Whys, and projective techniques. Produces a resumable
session with disk-persisted state and a master brandbook (90_SYNTHESIS.md).
-origin: community
---
# Brand Discovery
diff --git a/.agents/skills/brand-discovery/references/10_purpose-why.md b/.agents/skills/brand-discovery/references/10_purpose-why.md
index 8788b9457..d5ccf1757 100644
--- a/.agents/skills/brand-discovery/references/10_purpose-why.md
+++ b/.agents/skills/brand-discovery/references/10_purpose-why.md
@@ -31,9 +31,9 @@
### Candidate Why formulations (offer 2–3 versions, vary register and specificity)
-1.
-2.
-3.
+1.
+2.
+3.
### Open questions / threads to pursue in later modules
diff --git a/.agents/skills/brand-discovery/references/20_positioning.md b/.agents/skills/brand-discovery/references/20_positioning.md
index fe32d241f..7e4894337 100644
--- a/.agents/skills/brand-discovery/references/20_positioning.md
+++ b/.agents/skills/brand-discovery/references/20_positioning.md
@@ -36,8 +36,8 @@
### Alternative framings (vary the category or the differentiator)
-1.
-2.
+1.
+2.
### White-space hypothesis (what no competitor is claiming that this brand could own)
diff --git a/.agents/skills/brand-discovery/references/40_personality-archetype.md b/.agents/skills/brand-discovery/references/40_personality-archetype.md
index d58a4c393..920098840 100644
--- a/.agents/skills/brand-discovery/references/40_personality-archetype.md
+++ b/.agents/skills/brand-discovery/references/40_personality-archetype.md
@@ -50,9 +50,9 @@
### Personality in action (3 behavioural guidelines derived from the archetype)
-1.
-2.
-3.
+1.
+2.
+3.
### What the brand must never sound or look like (the anti-personality)
diff --git a/.agents/skills/brand-discovery/references/50_voice-tone.md b/.agents/skills/brand-discovery/references/50_voice-tone.md
index edc17436d..9239f55ad 100644
--- a/.agents/skills/brand-discovery/references/50_voice-tone.md
+++ b/.agents/skills/brand-discovery/references/50_voice-tone.md
@@ -1,7 +1,7 @@
# Module 50 — Voice & Tone
-> **Frameworks:** Brand voice spectrum (formal ↔ casual, serious ↔ playful,
-> distant ↔ warm, conventional ↔ irreverent) · Content-type tone matrix
+> **Frameworks:** Brand voice spectrum (formal <-> casual, serious <-> playful,
+> distant <-> warm, conventional <-> irreverent) · Content-type tone matrix
>
> **Goal:** Codify the brand's verbal register precisely enough that two different
> writers produce copy that sounds like the same person. Voice is constant;
@@ -54,8 +54,8 @@
### The three things to check every draft against
-1.
-2.
-3.
+1.
+2.
+3.
### Open questions / tensions with Module 40 Personality
diff --git a/.agents/skills/brand-discovery/references/60_narrative-story.md b/.agents/skills/brand-discovery/references/60_narrative-story.md
index 11a8376ca..b3985a045 100644
--- a/.agents/skills/brand-discovery/references/60_narrative-story.md
+++ b/.agents/skills/brand-discovery/references/60_narrative-story.md
@@ -32,13 +32,13 @@
### Trueline draft (Neumeier: "[Brand] is the only [category] that [unique claim].")
->
+>
### Alternative truelines (2–3 variations, vary level of abstraction)
-1.
-2.
-3.
+1.
+2.
+3.
### Brand story arc
diff --git a/.agents/skills/brand-discovery/references/70_founder-tension.md b/.agents/skills/brand-discovery/references/70_founder-tension.md
index 5c414e270..0675e37ab 100644
--- a/.agents/skills/brand-discovery/references/70_founder-tension.md
+++ b/.agents/skills/brand-discovery/references/70_founder-tension.md
@@ -36,7 +36,7 @@
[Founder IS the brand] ←————————→ [Organisation brand stands alone]
1 2 3 4 5
```
-Current position: ___ Target position (3-year): ___
+Current position: `___` Target position (3-year): `___`
### What the founder brand should own (and keeps owning)
diff --git a/.agents/skills/brand-discovery/references/90_SYNTHESIS.md b/.agents/skills/brand-discovery/references/90_SYNTHESIS.md
index c1a5d6358..095396a67 100644
--- a/.agents/skills/brand-discovery/references/90_SYNTHESIS.md
+++ b/.agents/skills/brand-discovery/references/90_SYNTHESIS.md
@@ -24,9 +24,9 @@
### 1. The Why (from Module 10)
> **Core belief:**
-
+>
> **Behavioural How (values in action):**
-
+>
> **What we refuse to be:**
---
@@ -37,7 +37,7 @@
> For **[target client]** who **[situation]**, **[brand name]** is the
> **[category]** that **[unique value]**. Unlike **[alternatives]**, we
> **[key differentiator]**.
-
+>
> **White-space the brand owns:**
---
@@ -45,9 +45,9 @@
### 3. Audience (from Module 30)
> **Ideal Client Profile (one-paragraph portrait):**
-
+>
> **Niche the brand is building toward:**
-
+>
> **Red-flag / disqualifier:**
---
@@ -68,17 +68,17 @@
### 4b. Aaker Brand System (from Module 40)
> **Primary archetype** (Mark & Pearson):
-
+>
> **Secondary archetype** (if present):
-
+>
> **Aaker brand identity** — four dimensions:
> - *Brand as product:*
> - *Brand as organisation:*
> - *Brand as person (personality):*
> - *Brand as symbol:*
-
+>
> **Brand associations** (3–5 key associations the brand should own):
-
+>
> **Brand equity signals** (what clients would lose if this brand disappeared):
---
@@ -86,18 +86,18 @@
### 5. Voice & Tone summary (from Module 50)
> **Voice statement (one paragraph):**
-
+>
> **The three checks every draft must pass:**
-> 1.
-> 2.
-> 3.
+> 1.
+> 2.
+> 3.
---
### 6. Narrative assets (from Module 60)
> **Trueline:**
-
+>
> **Brand story arc (one paragraph, usable as an About page starting point):**
---
@@ -105,7 +105,7 @@
### 7. Founder / organisation brand boundary (from Module 70)
> **What the founder brand owns:**
-
+>
> **What the organisation brand owns:**
---
@@ -128,6 +128,6 @@
<!-- 3–5 concrete actions the brand can take based on this brandbook. -->
-1.
-2.
-3.
+1.
+2.
+3.
diff --git a/.agents/skills/competitive-platform-analysis/SKILL.md b/.agents/skills/competitive-platform-analysis/SKILL.md
index da1078be5..dc9eee967 100644
--- a/.agents/skills/competitive-platform-analysis/SKILL.md
+++ b/.agents/skills/competitive-platform-analysis/SKILL.md
@@ -6,7 +6,6 @@ description: >-
counts as a competitor, which tier they belong to, and which sources to mine.
First step in the three-skill competitive pipeline; precedes
benchmark-methodology.
-origin: community
---
# Competitive Platform Analysis
diff --git a/.agents/skills/competitive-report-structure/SKILL.md b/.agents/skills/competitive-report-structure/SKILL.md
index 7336b63b7..e5e9b1ce3 100644
--- a/.agents/skills/competitive-report-structure/SKILL.md
+++ b/.agents/skills/competitive-report-structure/SKILL.md
@@ -6,7 +6,6 @@ description: >-
profiles, benchmarking matrix, white-space analysis, strategic recommendations,
and team alignment trigger questions. Final step in the three-skill competitive
pipeline.
-origin: community
---
# Competitive Report Structure
@@ -59,7 +58,7 @@ this and knows what to do. No methodology here.
### 2. Market landscape & category framing
Define the category and map it. Use a **multi-axis map** — at minimum a 2×2
-(e.g., *brand-led ↔ capability-led* × *boutique ↔ enterprise-scale*), and
+(e.g., *brand-led <-> capability-led* × *boutique <-> enterprise-scale*), and
ideally the **client's tension plot** from `benchmark-methodology` as the
headline map. Place every profiled competitor and the client. The map should
make the client's intended position visually obvious and show how crowded (or
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 1ad28ba7b..0d33e14f2 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ecc",
"version": "2.0.0",
- "description": "Harness-native ECC plugin for engineering teams - 64 agents, 262 skills, 84 legacy command shims, reusable hooks, rules, MCP conventions, and operator workflows for Claude Code plus adjacent agent harnesses",
+ "description": "Harness-native ECC plugin for engineering teams - 64 agents, 269 skills, 84 legacy command shims, reusable hooks, rules, MCP conventions, and operator workflows for Claude Code plus adjacent agent harnesses",
"author": {
"name": "Affaan Mustafa",
"url": "https://x.com/affaanmustafa"
diff --git a/AGENTS.md b/AGENTS.md
index 7fdbb6e87..928835ef9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,6 +1,6 @@
# Everything Claude Code (ECC) — Agent Instructions
-This is a **production-ready AI coding plugin** providing 64 specialized agents, 262 skills, 84 commands, and automated hook workflows for software development.
+This is a **production-ready AI coding plugin** providing 64 specialized agents, 269 skills, 84 commands, and automated hook workflows for software development.
**Version:** 2.0.0
@@ -150,7 +150,7 @@ Troubleshoot failures: check test isolation → verify mocks → fix implementat
```
agents/ — 64 specialized subagents
-skills/ — 262 workflow skills and domain knowledge
+skills/ — 269 workflow skills and domain knowledge
commands/ — 84 slash commands
hooks/ — Trigger-based automations
rules/ — Always-follow guidelines (common + per-language)
diff --git a/README.md b/README.md
index 6c3bf5a96..2acf7877a 100644
--- a/README.md
+++ b/README.md
@@ -154,7 +154,7 @@ Stable graduation of the 2.0 line: 265 skills, the control-pane substrate (sessi
### v2.0.0-rc.1 — Surface Refresh, Operator Workflows, and ECC 2.0 Alpha (Apr 2026)
- **Dashboard GUI** — New Tkinter-based desktop application (`ecc_dashboard.py` or `npm run dashboard`) with dark/light theme toggle, font customization, and project logo in header and taskbar.
-- **Public surface synced to the live repo** — metadata, catalog counts, plugin manifests, and install-facing docs now match the actual OSS surface: 64 agents, 261 skills, and 84 legacy command shims.
+- **Public surface synced to the live repo** — metadata, catalog counts, plugin manifests, and install-facing docs now match the actual OSS surface: 64 agents, 265 skills, and 84 legacy command shims.
- **Operator and outbound workflow expansion** — `brand-voice`, `social-graph-ranker`, `connections-optimizer`, `customer-billing-ops`, `ecc-tools-cost-audit`, `google-workspace-ops`, `project-flow-ops`, and `workspace-surface-audit` round out the operator lane.
- **Media and launch tooling** — `manim-video`, `remotion-video-creation`, and upgraded social publishing surfaces make technical explainers and launch content part of the same system.
- **Framework and product surface growth** — `nestjs-patterns`, richer Codex/OpenCode install surfaces, and expanded cross-harness packaging keep the repo usable beyond Claude Code alone.
diff --git a/docs/zh-CN/AGENTS.md b/docs/zh-CN/AGENTS.md
index 353246907..c89e642ae 100644
--- a/docs/zh-CN/AGENTS.md
+++ b/docs/zh-CN/AGENTS.md
@@ -1,6 +1,6 @@
# Everything Claude Code (ECC) — 智能体指令
-这是一个**生产就绪的 AI 编码插件**,提供 64 个专业代理、262 项技能、84 条命令以及自动化钩子工作流,用于软件开发。
+这是一个**生产就绪的 AI 编码插件**,提供 64 个专业代理、269 项技能、84 条命令以及自动化钩子工作流,用于软件开发。
**版本:** 2.0.0
@@ -147,7 +147,7 @@
```
agents/ — 64 个专业子代理
-skills/ — 262 个工作流技能和领域知识
+skills/ — 269 个工作流技能和领域知识
commands/ — 84 个斜杠命令
hooks/ — 基于触发的自动化
rules/ — 始终遵循的指导方针(通用 + 每种语言)
diff --git a/package-lock.json b/package-lock.json
index 423f95fd1..b30aae3c4 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -421,6 +421,7 @@
"integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
"dev": true,
"license": "MIT",
+ "peer": true,
"bin": {
"acorn": "bin/acorn"
},
@@ -852,6 +853,7 @@
"integrity": "sha512-LEyamqS7W5HB3ujJyvi0HQK/dtVINZvd5mAAp9eT5S/ujByGjiZLCzPcHVzuXbpJDJF/cxwHlfceVUDZ2lnSTw==",
"dev": true,
"license": "MIT",
+ "peer": true,
"dependencies": {
"@eslint-community/eslint-utils": "^4.8.0",
"@eslint-community/regexpp": "^4.12.1",
@@ -2433,6 +2435,7 @@
"integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
"dev": true,
"license": "MIT",
+ "peer": true,
"engines": {
"node": ">=12"
},
diff --git a/skills/benchmark-methodology/SKILL.md b/skills/benchmark-methodology/SKILL.md
index 950784c3d..bc75367f2 100644
--- a/skills/benchmark-methodology/SKILL.md
+++ b/skills/benchmark-methodology/SKILL.md
@@ -6,7 +6,6 @@ description: >-
visual craft, offer packaging, evidence, enterprise-readiness, thought
leadership, pricing, client's strategic tension) with explicit 1–5 rubrics
and a tension-plot. Precedes competitive-report-structure.
-origin: community
---
# Benchmark Methodology
diff --git a/skills/brand-discovery/SKILL.md b/skills/brand-discovery/SKILL.md
index 6e8769d7a..9006a079d 100644
--- a/skills/brand-discovery/SKILL.md
+++ b/skills/brand-discovery/SKILL.md
@@ -6,7 +6,6 @@ description: >-
personality, voice, narrative, and founder-brand tension across 8 modules
using laddering, 5 Whys, and projective techniques. Produces a resumable
session with disk-persisted state and a master brandbook (90_SYNTHESIS.md).
-origin: community
---
# Brand Discovery
diff --git a/skills/brand-discovery/references/10_purpose-why.md b/skills/brand-discovery/references/10_purpose-why.md
index 8788b9457..d5ccf1757 100644
--- a/skills/brand-discovery/references/10_purpose-why.md
+++ b/skills/brand-discovery/references/10_purpose-why.md
@@ -31,9 +31,9 @@
### Candidate Why formulations (offer 2–3 versions, vary register and specificity)
-1.
-2.
-3.
+1.
+2.
+3.
### Open questions / threads to pursue in later modules
diff --git a/skills/brand-discovery/references/20_positioning.md b/skills/brand-discovery/references/20_positioning.md
index fe32d241f..7e4894337 100644
--- a/skills/brand-discovery/references/20_positioning.md
+++ b/skills/brand-discovery/references/20_positioning.md
@@ -36,8 +36,8 @@
### Alternative framings (vary the category or the differentiator)
-1.
-2.
+1.
+2.
### White-space hypothesis (what no competitor is claiming that this brand could own)
diff --git a/skills/brand-discovery/references/40_personality-archetype.md b/skills/brand-discovery/references/40_personality-archetype.md
index d58a4c393..920098840 100644
--- a/skills/brand-discovery/references/40_personality-archetype.md
+++ b/skills/brand-discovery/references/40_personality-archetype.md
@@ -50,9 +50,9 @@
### Personality in action (3 behavioural guidelines derived from the archetype)
-1.
-2.
-3.
+1.
+2.
+3.
### What the brand must never sound or look like (the anti-personality)
diff --git a/skills/brand-discovery/references/50_voice-tone.md b/skills/brand-discovery/references/50_voice-tone.md
index edc17436d..9239f55ad 100644
--- a/skills/brand-discovery/references/50_voice-tone.md
+++ b/skills/brand-discovery/references/50_voice-tone.md
@@ -1,7 +1,7 @@
# Module 50 — Voice & Tone
-> **Frameworks:** Brand voice spectrum (formal ↔ casual, serious ↔ playful,
-> distant ↔ warm, conventional ↔ irreverent) · Content-type tone matrix
+> **Frameworks:** Brand voice spectrum (formal <-> casual, serious <-> playful,
+> distant <-> warm, conventional <-> irreverent) · Content-type tone matrix
>
> **Goal:** Codify the brand's verbal register precisely enough that two different
> writers produce copy that sounds like the same person. Voice is constant;
@@ -54,8 +54,8 @@
### The three things to check every draft against
-1.
-2.
-3.
+1.
+2.
+3.
### Open questions / tensions with Module 40 Personality
diff --git a/skills/brand-discovery/references/60_narrative-story.md b/skills/brand-discovery/references/60_narrative-story.md
index 11a8376ca..b3985a045 100644
--- a/skills/brand-discovery/references/60_narrative-story.md
+++ b/skills/brand-discovery/references/60_narrative-story.md
@@ -32,13 +32,13 @@
### Trueline draft (Neumeier: "[Brand] is the only [category] that [unique claim].")
->
+>
### Alternative truelines (2–3 variations, vary level of abstraction)
-1.
-2.
-3.
+1.
+2.
+3.
### Brand story arc
diff --git a/skills/brand-discovery/references/70_founder-tension.md b/skills/brand-discovery/references/70_founder-tension.md
index 5c414e270..0675e37ab 100644
--- a/skills/brand-discovery/references/70_founder-tension.md
+++ b/skills/brand-discovery/references/70_founder-tension.md
@@ -36,7 +36,7 @@
[Founder IS the brand] ←————————→ [Organisation brand stands alone]
1 2 3 4 5
```
-Current position: ___ Target position (3-year): ___
+Current position: `___` Target position (3-year): `___`
### What the founder brand should own (and keeps owning)
diff --git a/skills/brand-discovery/references/90_SYNTHESIS.md b/skills/brand-discovery/references/90_SYNTHESIS.md
index c1a5d6358..095396a67 100644
--- a/skills/brand-discovery/references/90_SYNTHESIS.md
+++ b/skills/brand-discovery/references/90_SYNTHESIS.md
@@ -24,9 +24,9 @@
### 1. The Why (from Module 10)
> **Core belief:**
-
+>
> **Behavioural How (values in action):**
-
+>
> **What we refuse to be:**
---
@@ -37,7 +37,7 @@
> For **[target client]** who **[situation]**, **[brand name]** is the
> **[category]** that **[unique value]**. Unlike **[alternatives]**, we
> **[key differentiator]**.
-
+>
> **White-space the brand owns:**
---
@@ -45,9 +45,9 @@
### 3. Audience (from Module 30)
> **Ideal Client Profile (one-paragraph portrait):**
-
+>
> **Niche the brand is building toward:**
-
+>
> **Red-flag / disqualifier:**
---
@@ -68,17 +68,17 @@
### 4b. Aaker Brand System (from Module 40)
> **Primary archetype** (Mark & Pearson):
-
+>
> **Secondary archetype** (if present):
-
+>
> **Aaker brand identity** — four dimensions:
> - *Brand as product:*
> - *Brand as organisation:*
> - *Brand as person (personality):*
> - *Brand as symbol:*
-
+>
> **Brand associations** (3–5 key associations the brand should own):
-
+>
> **Brand equity signals** (what clients would lose if this brand disappeared):
---
@@ -86,18 +86,18 @@
### 5. Voice & Tone summary (from Module 50)
> **Voice statement (one paragraph):**
-
+>
> **The three checks every draft must pass:**
-> 1.
-> 2.
-> 3.
+> 1.
+> 2.
+> 3.
---
### 6. Narrative assets (from Module 60)
> **Trueline:**
-
+>
> **Brand story arc (one paragraph, usable as an About page starting point):**
---
@@ -105,7 +105,7 @@
### 7. Founder / organisation brand boundary (from Module 70)
> **What the founder brand owns:**
-
+>
> **What the organisation brand owns:**
---
@@ -128,6 +128,6 @@
<!-- 3–5 concrete actions the brand can take based on this brandbook. -->
-1.
-2.
-3.
+1.
+2.
+3.
diff --git a/skills/competitive-platform-analysis/SKILL.md b/skills/competitive-platform-analysis/SKILL.md
index da1078be5..dc9eee967 100644
--- a/skills/competitive-platform-analysis/SKILL.md
+++ b/skills/competitive-platform-analysis/SKILL.md
@@ -6,7 +6,6 @@ description: >-
counts as a competitor, which tier they belong to, and which sources to mine.
First step in the three-skill competitive pipeline; precedes
benchmark-methodology.
-origin: community
---
# Competitive Platform Analysis
diff --git a/skills/competitive-report-structure/SKILL.md b/skills/competitive-report-structure/SKILL.md
index 7336b63b7..e5e9b1ce3 100644
--- a/skills/competitive-report-structure/SKILL.md
+++ b/skills/competitive-report-structure/SKILL.md
@@ -6,7 +6,6 @@ description: >-
profiles, benchmarking matrix, white-space analysis, strategic recommendations,
and team alignment trigger questions. Final step in the three-skill competitive
pipeline.
-origin: community
---
# Competitive Report Structure
@@ -59,7 +58,7 @@ this and knows what to do. No methodology here.
### 2. Market landscape & category framing
Define the category and map it. Use a **multi-axis map** — at minimum a 2×2
-(e.g., *brand-led ↔ capability-led* × *boutique ↔ enterprise-scale*), and
+(e.g., *brand-led <-> capability-led* × *boutique <-> enterprise-scale*), and
ideally the **client's tension plot** from `benchmark-methodology` as the
headline map. Place every profiled competitor and the client. The map should
make the client's intended position visually obvious and show how crowded (or