The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
feat(skills): add brand-discovery and competitive benchmarking pipeline
Eryk Orłowskife37e5426ab9
diff --git a/.agents/skills/benchmark-methodology/SKILL.md b/.agents/skills/benchmark-methodology/SKILL.mdnew file mode 100644index 000000000..bc75367f2--- /dev/null+++ b/.agents/skills/benchmark-methodology/SKILL.md@@ -0,0 +1,190 @@+---+name: benchmark-methodology+description: >-+ Use after competitive-platform-analysis has produced a tiered competitor set.+ Scores each competitor across nine weighted dimensions (positioning, voice,+ 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.+---++# Benchmark Methodology++Use this skill to turn a scoped competitor set into **comparable, defensible+scores**. Each competitor is assessed on the same nine dimensions, with+explicit 1–5 rubrics, then captured in a uniform profile card. Consistency is+the point: scores are only useful if the same evidence would earn the same+number for any competitor.++## When to Activate++- A scoped, tiered competitor set from competitive-platform-analysis is ready to score.+- Need comparable, evidence-anchored scores across competitors — not gut-feel rankings.+- Client's strategic tension (the paired axes defining their target white-space) has been established.+- Preparing to produce profile cards for assembly in competitive-report-structure.++## Client positioning brief (establish first)++Before scoring, establish the client's positioning brief. It supplies:++- **Strategic tension** — the two axes (e.g., memorability × hireability) whose+ intersection marks the client's target white-space. Dimension 9 is always+ the client's named tension; report both poles separately, never averaged.+- **Differentiator** — what makes the client's moat. This informs which+ dimensions matter most for the client's positioning argument.+- **Brand balance** — the intended mix of distinct strategic emphases. Strategic+ recommendations must not break this balance without flagging it.++## Why these dimensions++The client competes on a **specific tension held across two poles**, not on+service breadth. The dimensions are weighted to reflect that moat. Two+dimensions — the tension poles — are scored **separately and never averaged+together**, because the client's strategic question is precisely whether a rival+achieves both simultaneously.++## The nine dimensions (with weights)++Weights guide synthesis emphasis, not a single blended score (avoid a false+composite — see Bias controls). Sum = 100%.++1. **Positioning clarity & distinctiveness** (18%) — Is the studio's position+ sharp, ownable, and instantly legible? Or generic?+2. **Brand voice / verbal distinctiveness** (15%) — Does the copy have an+ ownable register, or is it interchangeable agency-speak?+3. **Visual identity & site craft** (15%) — Quality and ownership of the visual+ system; site as proof-of-craft.+4. **Service offer & packaging** (12%) — Productized and legible (named+ sprints/audits) vs vague. Packaging maturity.+5. **Evidence & credibility** (12%) — Named clients, quantified outcomes,+ case-study depth. Proof beyond assertion.+6. **Enterprise-readiness / commercial maturity** (10%) — Signals they can land+ and hold SaaS/fintech/B2B/enterprise work (process, logos, scale, contracts).+7. **Thought leadership / content presence** (8%) — Owned POV: writing, talks,+ newsletters, frameworks. Depth over volume.+8. **Pricing transparency & engagement model** (5%) — Is pricing/engagement+ legible? Productized vs bespoke vs opaque.+9. **[Client's strategic tension]** (5% as a flag; **score BOTH poles,+ report separately**) — Read the tension name and axis descriptions from the+ client's positioning brief. Plot both; the gap is the insight. The client's+ target quadrant is the single most important finding: who else is already+ there?++## Scoring rubric (1–5, applies to dimensions 1–8)++Anchor every score to observable evidence. Generic descriptors below; adapt the+specifics per dimension but keep the level meaning constant.++- **1 — Absent / generic.** No discernible position or craft; indistinguishable+ from a template. Active liability.+- **2 — Below par.** Some intent but inconsistent, derivative, or unconvincing.+ Wouldn't survive a side-by-side.+- **3 — Competent / table-stakes.** Solid, professional, unremarkable. Meets+ expectation, ownable by nobody.+- **4 — Strong / distinctive.** Clearly above peers; a real strength a buyer+ would notice and cite.+- **5 — Category-defining.** Best-in-class, ownable, hard to imitate. Sets the+ bar others react to.++### Tension axes (dimension 9) — score each 1–5++Read the axis labels and their 1/3/5 anchors from the client's positioning+brief. Example anchors for a memorability × credibility tension:++- **Memorability** — 1: forgotten instantly · 3: recognizable in context ·+ 5: unforgettable, talked-about, distinctively owned.+- **Credibility** — 1: feels risky/amateur · 3: safe, competent,+ unexciting · 5: enterprise-trusted, obvious safe choice.++Plot competitors on the tension 2×2. The client's target quadrant is named in+the positioning brief. Who else occupies that quadrant is the single most+important finding of the benchmark.++## How to collect the data++For each competitor, work the dimensions in this order (cheapest signal first):++1. **Competitor's own site** — positioning, voice, offer packaging, pricing+ posture, named clients, manifesto/POV. Screenshot the homepage + one case+ study.+2. **Case studies / work** — evidence depth, quantified outcomes, client names.+ Distinguish *asserted* ("we delivered X") from *proven* (metrics, named,+ verifiable).+3. **Review directories** — corroborate clients, project size, engagement model+ → credibility & enterprise-readiness (e.g. Clutch.co or the niche equivalent).+4. **LinkedIn** — team size/model, founder narrative, content cadence →+ thought leadership, model.+5. **Portfolio / craft platforms** — craft register (use the showcase native to+ the niche: design boards, showreels, published samples, etc.).+6. **Content channels** — newsletter/talks/writing → thought-leadership depth.++**What to record per dimension:** the score, one-line justification, and the+source link/screenshot that earned it. No score without evidence.++## Bias controls++- **No single composite score.** Report dimension scores and the tension plot+ separately. A weighted average hides the asymmetry that matters.+- **Asserted vs proven.** Downgrade credibility/evidence scores for+ self-reported claims with no corroboration. Site copy is marketing, not fact.+- **Aesthetic affinity bias.** Reviewers may over-score studios whose aesthetic+ they share and under-score rivals' commercial strength. Score craft and+ credibility independently; a "boring" site may be winning bigger clients.+- **Recency / flashiness bias.** Award-winning, showpiece work dazzles but may+ lack commercial depth — verify with directories/clients before scoring+ credibility.+- **Survivorship.** The visible, well-marketed studios aren't the whole market;+ note strong-but-quiet operators found via directories/reviews.+- **Calibrate across the set, not in isolation.** Before finalizing, re-read+ scores side-by-side — a "4" must mean the same thing for every competitor.+ Adjust outliers.++## Competitor profile card (output format)++Produce one card per profiled competitor — the atomic unit the report assembles+from:++```+## <Competitor name>+- **Profile / Tier:** <positioning stance · specialization · size band> / <Direct | Adjacent | Aspirational>+- **One-liner:** <how they position themselves, in their words>+- **Model / size / geography:** <solo|micro|boutique> · <region> · <pricing/engagement model>+- **Notable clients / evidence:** <named, with proven/asserted tag>++### Dimension scores+| Dimension | Score (1–5) | Justification (1 line) | Source |+|---|---|---|---|+| Positioning clarity & distinctiveness | | | |+| Brand voice / verbal distinctiveness | | | |+| Visual identity & site craft | | | |+| Service offer & packaging | | | |+| Evidence & credibility | | | |+| Enterprise-readiness / commercial maturity | | | |+| Thought leadership / content presence | | | |+| Pricing transparency & engagement model | | | |++### Tension plot+- **[Axis 1 from positioning brief]:** <1–5> — <why>+- **[Axis 2 from positioning brief]:** <1–5> — <why>+- **Quadrant:** <high/high | high-1/low-2 | low-1/high-2 | low/low>++### Read for [client]+- **Strength to learn from:** <…>+- **Weakness to exploit / white-space it exposes:** <…>+- **Threat to [client]:** <…>+```++Hand the completed cards plus the tension plot to `competitive-report-structure`.++## Anti-Patterns++- **Averaging the tension axes.** The two poles of the client's strategic tension must be scored and reported separately. Averaging destroys the insight — the gap between poles is the finding.+- **Scoring without evidence.** Every score requires a one-line justification and a source link. A score without evidence is an opinion, not a benchmark.+- **Creating a single composite score.** Report dimension scores individually. A weighted average hides the asymmetric strengths that matter for positioning.+- **Applying generic rubric anchors without adapting.** The 1–5 anchors must be calibrated to the specific dimension and competitor set. The generic descriptions are a starting point, not a fixed standard.+- **Running before the competitor set is scoped.** Use competitive-platform-analysis first to produce a tiered, pruned set. Scoring an unscoped list wastes effort on irrelevant competitors.++## Related Skills++- `competitive-platform-analysis` — the prerequisite; produces the tiered competitor set this skill scores.+- `competitive-report-structure` — the next step; assembles the scored profile cards into a client-deliverable report.diff --git a/.agents/skills/benchmark-methodology/agents/openai.yaml b/.agents/skills/benchmark-methodology/agents/openai.yamlnew file mode 100644index 000000000..18c2a2e95--- /dev/null+++ b/.agents/skills/benchmark-methodology/agents/openai.yaml@@ -0,0 +1,7 @@+interface:+ display_name: "Benchmark Methodology"+ short_description: "Score competitors across nine weighted dimensions"+ brand_color: "#F59E0B"+ default_prompt: "Use $benchmark-methodology to score a tiered competitor set."+policy:+ allow_implicit_invocation: truediff --git a/.agents/skills/brand-discovery/SKILL.md b/.agents/skills/brand-discovery/SKILL.mdnew file mode 100644index 000000000..5ba79b929--- /dev/null+++ b/.agents/skills/brand-discovery/SKILL.md@@ -0,0 +1,133 @@+---+name: brand-discovery+description: >-+ Use when a brand needs to discover or articulate its identity through+ structured multi-session interviews. Covers purpose, positioning, audience,+ 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).+---++# Brand Discovery++Use this skill to conduct a structured, adaptive brand identity interview.+The goal is a complete `90_SYNTHESIS.md` — a master brandbook the+organization can use to brief designers, writers, and external+collaborators.++The interview runs across multiple sessions. Capture answers to disk as you+go so that no elicited knowledge is lost when a conversation ends, and so a+later session can resume from where the last one stopped.++## When to Activate++- A brand is being created, repositioned, or needs a written identity reference to brief collaborators.+- Multiple sessions are expected — the conversation will span days or weeks.+- Multiple founders or stakeholders need individual interviews before a reconciliation pass.+- The user wants a structured, repeatable method rather than an ad-hoc chat.+- Existing brand documentation is scattered, implicit, or founder-dependent and needs to be made explicit.++## Session start protocol++On every activation, perform these steps **before** asking any interview+question:++1. **Check for prior progress.** Look for an existing set of module files+ and a `state.json` checkpoint in the project's brand-identity directory.+ If none exists, this is a fresh start — confirm the brand name,+ participants, and where to save the brand-identity files, then begin at+ the first module.+2. **Read the current module file** if one is in progress, and scan its Raw+ section for previously captured answers.+3. **Report to the user** in two or three sentences: which module we are+ in, its status, and what remains. Then ask: "Continue here, or switch+ module?"++## Interview discipline++Apply these rules throughout every module:++1. **One question at a time.** Never present a list of questions.+2. **After each answer:** short paraphrase → one deepening probe OR close+ the thread if the topic is saturated. Never move on silently.+3. **Laddering:** for every "what" answer, follow with "Why does that+ matter to you?" until a core value surfaces (typically two to four+ iterations).+4. **5 Whys:** for beliefs or positioning claims — push until the root+ reason, not the surface declaration, is on the table.+5. **Detect thin answers:** if generic, jargon-heavy, or vague, ask for+ one concrete example, a client story, or a number.+6. **Projective techniques** (use once per module to break a plateau):+ - "If the brand were a person, how would they walk into a room?"+ - Brand obituary: "If the organization closed in five years, what would+ customers miss? What would you regret not having said?"+ - Competitive contrast: "Name one peer you admire but would never want+ to become. What specifically makes them the wrong model?"+7. **Saturation signal:** when two consecutive probes produce no new+ information, summarise and close the module.+8. **End of module:** write a structured module file with two sections:+ - `## Raw` — verbatim quotes and examples.+ - `## Synthesis` — your interpretation, three candidate formulations,+ open questions, contradictions between participants.+ Then update the `state.json` checkpoint (see State protocol below).++## Module sequence++| File | Label | Frameworks used |+|------|-------|-----------------|+| `10_purpose-why.md` | Purpose / Why | Sinek Golden Circle, Lencioni |+| `20_positioning.md` | Positioning | Dunford "Obviously Awesome", Moore template |+| `30_audience-niche.md` | Audience & Niche | Baker "Business of Expertise", ICP |+| `40_personality-archetype.md` | Personality & Archetype | Mark & Pearson 12 archetypes, J. Aaker 5 dims |+| `50_voice-tone.md` | Voice & Tone | Brand voice guidelines |+| `60_narrative-story.md` | Narrative / Story | Neumeier trueline, brand story arc |+| `70_founder-tension.md` | Founder Brands vs Studio Brand | Enns "Win Without Pitching" |+| `90_SYNTHESIS.md` | Master Brandbook | Kapferer prism, Aaker brand system |++Complete modules in order. Honour a user request to jump modules and note+the skip in `state.json`.++## State write protocol++After each module reaches saturation or done status, write two files:++**Module file** at `modules/{moduleFile}` — full Raw and Synthesis content.++**`state.json`** — a lightweight checkpoint so a later session can resume.+Update `completedModules`, `inProgressModule`, `nextModule`, `lastUpdated`.+Schema:++```json+{+ "session": "{brand_name}-brand-{YYYY-MM}",+ "outputPath": "{path_to_brand_identity_directory}",+ "completedModules": [],+ "inProgressModule": "10_purpose-why.md",+ "nextModule": "20_positioning.md",+ "participants": ["founder-A"],+ "lastUpdated": "{ISO-8601}"+}+```++After writing, confirm: "Module X saved. State updated. Next: Y."++## Multi-founder mode++When more than one founder participates, write each founder's answers to+`founders/{participant}.md` instead of the main module files. After all+founders complete a module, run a reconciliation pass: summarise+convergences and divergences in the module file, flag "productive tensions"+for the group alignment workshop.++## Anti-Patterns++- **Starting without reading state first.** Every session must open by checking for existing module files and `state.json`. Skipping this loses all continuity from prior sessions.+- **Asking multiple questions at once.** One question at a time is not optional — lists produce checklist answers, not real insight.+- **Moving to Synthesis before saturation.** If the last two probes produced no new information, the module is done. If they did — it isn't.+- **Skipping multi-founder reconciliation.** When multiple stakeholders are involved, individual interviews must complete before reconciliation. Discussing the brand collectively first introduces anchoring bias.+- **Treating this as a one-shot session.** This skill is designed for multiple sessions. Rushing to `90_SYNTHESIS.md` in one conversation produces shallow output.++## Related Skills++- `competitive-platform-analysis` — after brand-discovery establishes the positioning brief, use this to scope and categorise the competitor set.+- `brand-voice` (ECC) — if the brand-discovery voice-and-tone module needs a separate, source-derived writing-style profile.diff --git a/.agents/skills/brand-discovery/agents/openai.yaml b/.agents/skills/brand-discovery/agents/openai.yamlnew file mode 100644index 000000000..a1b6d9864--- /dev/null+++ b/.agents/skills/brand-discovery/agents/openai.yaml@@ -0,0 +1,7 @@+interface:+ display_name: "Brand Discovery"+ short_description: "Adaptive multi-session brand identity interviews"+ brand_color: "#8B5CF6"+ default_prompt: "Use $brand-discovery to run a structured brand identity interview."+policy:+ allow_implicit_invocation: truediff --git a/.agents/skills/brand-discovery/references/10_purpose-why.md b/.agents/skills/brand-discovery/references/10_purpose-why.mdnew file mode 100644index 000000000..8788b9457--- /dev/null+++ b/.agents/skills/brand-discovery/references/10_purpose-why.md@@ -0,0 +1,42 @@+# Module 10 — Purpose / Why++> **Frameworks:** Sinek Golden Circle · Lencioni organisational purpose+>+> **Goal:** Surface the brand's core belief — the Why that exists independently+> of what the organisation sells or how it delivers. Captures the founding+> conviction, not the elevator pitch.++---++## Raw++<!-- Verbatim quotes, stories, and examples captured during the interview.+ Record exact language — paraphrase belongs in Synthesis, not here.+ Include speaker attribution if multi-founder session. -->++### Core belief (why does this exist?)++### The behavioural How (values in action, not poster slogans)++### What the brand refuses to be or do++### Founder quotes strong enough to become internal anchors++---++## Synthesis++<!-- Your interpretation of the raw material.+ Write three sections: formulations, open questions, contradictions. -->++### Candidate Why formulations (offer 2–3 versions, vary register and specificity)++1.+2.+3.++### Open questions / threads to pursue in later modules++### Contradictions or tensions between participants (multi-founder only)++### How does this Why constrain or enable positioning? (bridge to Module 20)diff --git a/.agents/skills/brand-discovery/references/20_positioning.md b/.agents/skills/brand-discovery/references/20_positioning.mdnew file mode 100644index 000000000..fe32d241f--- /dev/null+++ b/.agents/skills/brand-discovery/references/20_positioning.md@@ -0,0 +1,46 @@+# Module 20 — Positioning++> **Frameworks:** Dunford *Obviously Awesome* · Moore crossing-the-chasm template ·+> Jobs-to-be-done lens+>+> **Goal:** Define the brand's competitive frame — who it's for, what category it+> competes in, what it does uniquely, and why that matters to the target client.+> Output is the raw material for a positioning statement the brand can act on.++---++## Raw++<!-- Verbatim quotes and examples. Record exact language. -->++### Who is the target client? (role, company type, situation)++### What category does the brand compete in? (how clients currently solve this problem)++### What makes the brand different from alternatives in that category?++### What does the target client care about most? (the value they get that others can't match)++### Competitive alternatives named by the founder (include "do nothing" / "hire in-house")++### Phrases or metaphors the founder uses naturally to describe what they do++---++## Synthesis++### Positioning statement draft (Dunford template)+> For **[target client]** who **[situation / JTBD]**, **[brand name]** is the+> **[category]** that **[unique value]**. Unlike **[alternatives]**, we+> **[key differentiator]**.++### Alternative framings (vary the category or the differentiator)++1.+2.++### White-space hypothesis (what no competitor is claiming that this brand could own)++### Open questions / ambiguities++### Tensions with Module 10 Why (flag any contradictions for Module 90 reconciliation)diff --git a/.agents/skills/brand-discovery/references/30_audience-niche.md b/.agents/skills/brand-discovery/references/30_audience-niche.mdnew file mode 100644index 000000000..2f18e0c9b--- /dev/null+++ b/.agents/skills/brand-discovery/references/30_audience-niche.md@@ -0,0 +1,52 @@+# Module 30 — Audience & Niche++> **Frameworks:** Baker *The Business of Expertise* · Ideal Client Profile (ICP) ·+> Pain / trigger / desired outcome lens+>+> **Goal:** Make the target audience concrete enough to brief a copywriter or run+> a paid campaign — not a demographic sketch, but a psychographic and situational+> portrait of the best client the brand wants more of.++---++## Raw++<!-- Verbatim quotes and examples. -->++### Who is the ideal client? (describe a specific person, not a segment)++### What situation or trigger brings them to look for help?++### What have they tried before and why did it fall short?++### What does success look like to them? (in their words, not the brand's)++### What do they fear or want to avoid?++### Worst-fit clients (who the brand doesn't want to work with, and why)++### Quotes or stories from real past clients that illustrate the ideal fit++---++## Synthesis++### Ideal Client Profile (ICP)++| Dimension | Description |+|---|---|+| Role / title | |+| Organisation type & size | |+| Trigger situation | |+| Primary pain | |+| Desired outcome | |+| Budget signal | |+| Red-flag / disqualifier | |++### Psychographic portrait (2–3 sentences: how this person thinks, what they value, what they distrust)++### Niche hypothesis (the smallest viable market the brand could credibly own)++### Audience segments to test (if there is ambiguity about primary vs secondary ICP)++### Open questions / threads for Module 20 positioning reconciliationdiff --git a/.agents/skills/brand-discovery/references/40_personality-archetype.md b/.agents/skills/brand-discovery/references/40_personality-archetype.mdnew file mode 100644index 000000000..5b5ba29e7--- /dev/null+++ b/.agents/skills/brand-discovery/references/40_personality-archetype.md@@ -0,0 +1,60 @@+# Module 40 — Personality & Archetype++> **Frameworks:** Mark & Pearson 12 brand archetypes · J. Aaker 5 brand personality+> dimensions (sincerity / excitement / competence / sophistication / ruggedness)+>+> **Goal:** Establish the brand's character — how it would behave if it were a+> person. Personality governs tone, visual register, and what feels "on brand"+> versus "wrong". A sharp archetype makes a hundred small decisions automatic.++---++## Raw++<!-- Verbatim quotes and projective-technique responses. -->++### "If the brand were a person, how would they walk into a room?"++### Archetype instinct (which of the 12 resonates immediately, and why?)+> Creator · Caregiver · Ruler · Jester · Regular Person · Lover · Hero ·+> Outlaw · Magician · Innocent · Sage · Explorer++### Three adjectives the founder uses most naturally to describe the brand's character++### One brand or public figure the founder admires but the brand should NOT become+(and specifically what to avoid)++### One brand or public figure whose personality register the brand aspires to++### How should the brand make clients feel? (not think — feel)++---++## Synthesis++### Primary archetype + shadow++| | |+|---|---|+| **Primary archetype** | (name + 1-line why) |+| **Secondary / shadow** | (what the primary archetype risks becoming; what keeps it honest) |++### J. Aaker personality scores (1–5, 5 = strongly applies)++| Dimension | Score | Evidence |+|---|---|---|+| Sincerity (warm, honest, down-to-earth) | | |+| Excitement (daring, spirited, imaginative) | | |+| Competence (reliable, intelligent, successful) | | |+| Sophistication (upper-class, charming) | | |+| Ruggedness (outdoorsy, tough) | | |++### Personality in action (3 behavioural guidelines derived from the archetype)++1.+2.+3.++### What the brand must never sound or look like (the anti-personality)++### Open questions / tensions with Module 50 Voicediff --git a/.agents/skills/brand-discovery/references/50_voice-tone.md b/.agents/skills/brand-discovery/references/50_voice-tone.mdnew file mode 100644index 000000000..edc17436d--- /dev/null+++ b/.agents/skills/brand-discovery/references/50_voice-tone.md@@ -0,0 +1,61 @@+# Module 50 — Voice & Tone++> **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;+> tone shifts by context (home page vs. error message vs. proposal cover).++---++## Raw++<!-- Verbatim quotes and examples from the interview.+ Collect actual copy samples the founder likes or hates. -->++### Copy the founder admires (from their own brand or others) — include the source++### Copy the founder dislikes or finds "wrong register" — what specifically is wrong?++### Words or phrases the brand uses all the time (even informally)++### Words or phrases the brand actively avoids++### How should the brand sound on: a sales page? an error message? a proposal?++### "We always…" / "We never…" statements about how the brand communicates++---++## Synthesis++### Voice spectrum (mark the brand's position on each axis)++| Axis | 1 | 2 | 3 | 4 | 5 | Notes |+|---|---|---|---|---|---|---|+| Formal ←→ Casual | | | | | | |+| Serious ←→ Playful | | | | | | |+| Distant ←→ Warm | | | | | | |+| Conventional ←→ Irreverent | | | | | | |+| Minimal ←→ Expressive | | | | | | |++### Voice statement (one paragraph a writer can internalise)++### Tone matrix by content type++| Content type | Tone shift | Example phrase |+|---|---|---|+| Homepage headline | | |+| Case study / evidence | | |+| Proposal / commercial | | |+| Error / apology | | |+| Social / informal | | |++### The three things to check every draft against++1.+2.+3.++### Open questions / tensions with Module 40 Personalitydiff --git a/.agents/skills/brand-discovery/references/60_narrative-story.md b/.agents/skills/brand-discovery/references/60_narrative-story.mdnew file mode 100644index 000000000..11a8376ca--- /dev/null+++ b/.agents/skills/brand-discovery/references/60_narrative-story.md@@ -0,0 +1,54 @@+# Module 60 — Narrative / Story++> **Frameworks:** Neumeier trueline · Brand story arc (context → conflict →+> resolution → invitation) · Hero's journey (brand as guide, client as hero)+>+> **Goal:** Crystallise the brand's founding story and its narrative arc — the+> conflict it was built to resolve, the transformation it delivers, and the+> invitation it extends to clients. The trueline is the single sentence that+> holds every story the brand tells.++---++## Raw++<!-- Verbatim quotes and stories. -->++### The founding story (what happened, when, why this — not the polished version)++### The conflict or frustration that made the brand necessary++### What the world looks like when the brand's work succeeds (the transformation)++### A client story that best illustrates what the brand does and why it matters++### What would be lost if the brand didn't exist? (brand obituary prompt)++### The invitation: what does the brand ask clients to do or believe?++---++## Synthesis++### Trueline draft (Neumeier: "[Brand] is the only [category] that [unique claim].")++>++### Alternative truelines (2–3 variations, vary level of abstraction)++1.+2.+3.++### Brand story arc++| Beat | Content |+|---|---|+| **Context** (the world before) | |+| **Conflict** (what's broken / wrong) | |+| **Resolution** (what the brand does about it) | |+| **Invitation** (what the client is asked to do) | |++### The brand as guide (not hero) — what the client achieves, not the brand++### Open questions / tensions with Module 20 Positioning and Module 10 Whydiff --git a/.agents/skills/brand-discovery/references/70_founder-tension.md b/.agents/skills/brand-discovery/references/70_founder-tension.mdnew file mode 100644index 000000000..5c414e270--- /dev/null+++ b/.agents/skills/brand-discovery/references/70_founder-tension.md@@ -0,0 +1,49 @@+# Module 70 — Founder Brand vs Organisation Brand++> **Frameworks:** Enns *Win Without Pitching* · Personal brand vs institutional+> brand spectrum+>+> **Goal:** Map the relationship between the founder's personal reputation and the+> organisation's brand. Clarify how much equity each carries, what the healthy+> boundary is, and how to sequence personal vs organisation brand investment.+> Unresolved founder-brand tension is a common scaling bottleneck.++---++## Raw++<!-- Verbatim quotes. -->++### Is the founder personally known in the market? How?++### Do clients buy the founder or the organisation? (ask for evidence, not instinct)++### What happens to the brand if the founder steps back or is unavailable?++### What does the founder want for their personal brand in 3–5 years?++### What does the organisation's brand need to be able to do independently?++### Where has the founder-brand been an asset? Where has it been a constraint?++---++## Synthesis++### Current state: where on the spectrum?++```+[Founder IS the brand] ←————————→ [Organisation brand stands alone]+ 1 2 3 4 5+```+Current position: ___ Target position (3-year): ___++### What the founder brand should own (and keeps owning)++### What the organisation brand needs to own (independently of the founder)++### Transition plan sketch (if moving from founder-centric toward institutional)++### Risk if nothing changes++### Open questions / threads for Module 90 Synthesisdiff --git a/.agents/skills/brand-discovery/references/90_SYNTHESIS.md b/.agents/skills/brand-discovery/references/90_SYNTHESIS.mdnew file mode 100644index 000000000..1bce2f12f--- /dev/null+++ b/.agents/skills/brand-discovery/references/90_SYNTHESIS.md@@ -0,0 +1,105 @@+# Module 90 — Master Brandbook (Synthesis)++> **Frameworks:** Kapferer Brand Identity Prism · Aaker brand system (identity /+> personality / associations / equity)+>+> **Goal:** Reconcile all seven preceding modules into a single, actionable+> brandbook. This document is the source of truth the brand uses to brief+> designers, writers, and external collaborators. It resolves tensions between+> modules, commits to specific formulations, and translates them into practical+> guidelines.++---++## 1. The Why (from Module 10)++> **Core belief:**++> **Behavioural How (values in action):**++> **What we refuse to be:**++---++## 2. Positioning (from Module 20)++> **Positioning statement:**+> For **[target client]** who **[situation]**, **[brand name]** is the+> **[category]** that **[unique value]**. Unlike **[alternatives]**, we+> **[key differentiator]**.++> **White-space the brand owns:**++---++## 3. Audience (from Module 30)++> **Ideal Client Profile (one-paragraph portrait):**++> **Niche the brand is building toward:**++> **Red-flag / disqualifier:**++---++## 4. Kapferer Brand Identity Prism++| Facet | Content |+|---|---|+| **Physique** (visible, tangible brand attributes) | |+| **Personality** (character if the brand were a person) | |+| **Culture** (values and principles behind the brand) | |+| **Relationship** (how the brand relates to clients) | |+| **Reflection** (how clients see themselves using this brand) | |+| **Self-image** (how clients feel inside when using this brand) | |++---++## 5. Voice & Tone summary (from Module 50)++> **Voice statement (one paragraph):**++> **The three checks every draft must pass:**+> 1.+> 2.+> 3.++---++## 6. Narrative assets (from Module 60)++> **Trueline:**++> **Brand story arc (one paragraph, usable as an About page starting point):**++---++## 7. Founder / organisation brand boundary (from Module 70)++> **What the founder brand owns:**++> **What the organisation brand owns:**++---++## 8. Tensions resolved (record any module-to-module conflicts and how they were settled)++| Tension | Module A | Module B | Resolution |+|---|---|---|---|+| | | | |++---++## 9. Open questions deferred to next session++<!-- Anything that couldn't be resolved with the current data. -->++---++## 10. Practical next steps++<!-- 3–5 concrete actions the brand can take based on this brandbook. -->++1.+2.+3.diff --git a/.agents/skills/competitive-platform-analysis/SKILL.md b/.agents/skills/competitive-platform-analysis/SKILL.mdnew file mode 100644index 000000000..2877d3230--- /dev/null+++ b/.agents/skills/competitive-platform-analysis/SKILL.md@@ -0,0 +1,180 @@+---+name: competitive-platform-analysis+description: >-+ Use when scoping a competitive landscape — identifying, categorising, and+ score-filtering a competitor set before any benchmarking begins. Decides who+ 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.+---++# Competitive Platform Analysis++Use this skill to decide **who to benchmark** and **where to find them** before+any scoring begins. A competitive analysis is only as good as its frame: the+wrong set makes the client look either unbeatable or doomed. The goal is a+defensible, decision-relevant set — not an exhaustive census.++## When to Activate++- About to start a competitive benchmarking project and need to define the competitor set first.+- Unsure which companies belong in Direct / Adjacent / Aspirational tiers.+- Need a defensible, pruned scope for a market landscape report.+- Has a positioning brief and wants to identify who contests that position.+- First step before running benchmark-methodology.++## Client positioning brief (establish first)++Before scoping the set, establish the client's positioning brief. If you don't+already have it, run a short brand-discovery interview to elicit it — do **not**+invent one and do **not** scope the set blind. The brief supplies:++- **Identity / aesthetic register** — what kind of studio or company this is and+ how it presents itself.+- **Offer** — what services or products it delivers.+- **Target clients** — who it sells to.+- **Differentiator** — the moat or positioning argument the client believes in.+- **Scoping consequence** — the implication for how to weight competitors (e.g.,+ prioritize by distinctiveness vs. capability overlap vs. price).+- **Strategic tension** — the paired axes that define the client's white-space+ (e.g., memorability × hireability).++**Do not proceed without the positioning brief.** A competitor list scoped+without the client's lens is noise, not intelligence. The scoping consequence in+particular determines which competitors are *strong* rivals (those that contest+the client's moat) vs. merely overlapping on service menu.++## Selection criteria++For each candidate, capture these axes — they decide both inclusion and tier:++- **Size / model** — solo, micro-studio (2–8), boutique (sub-30), mid-size+ agency. Match the client's own band; same-band studios are the realistic+ head-to-head set.+- **Niche / specialization** — how closely the candidate's focus overlaps with+ the client's offer. Tighter overlap = more direct.+- **Geography / market** — EU vs US vs global-remote; language; time-zone reach.+ Note whether they win the same clients the client targets.+- **Pricing & engagement model** — productized sprints, retainer, project,+ day-rate; transparent vs "contact us". Signals positioning maturity.+- **Portfolio style** — generic vs. opinionated/editorial vs. contrarian. Closer+ to the client's aesthetic register = more they contest the client's+ distinctiveness.+- **Technical depth / craft maturity** — relevant if the client's credibility+ story includes public process work, open tooling, or documented systems.+- **Brand strength** — does the studio have an ownable verbal/visual identity, or+ is it interchangeable? Weight this per the client's scoping consequence.++## Player taxonomy — axes to populate across++Don't sort competitors into niche-specific buckets; sort them along a few+generic axes so the landscape isn't skewed toward one archetype. These axes+apply to any creative-service market (design, motion, copywriting, branding,+content, film, etc.). Aim for breadth across each axis first, then prune to the+most instructive.++1. **Positioning stance** — *brand-led / editorial* (competes on identity,+ voice, POV) vs *capability-led* (competes on craft, throughput, outcomes).+ Populate both poles; the client's closest mirror sits at its own end.+2. **Specialization** — *specialist* (one tight discipline or vertical) vs+ *generalist* (broad service menu). Tighter overlap with the client's focus =+ more direct.+3. **Size / model** — *solo / micro* vs *boutique* vs *mid-size* vs+ *enterprise-scale*. Same-band players are the realistic head-to-head; larger+ bands are the aspirational/commercial-maturity reference.+4. **Engagement format** — *productized* (named sprints, audits, fixed packages)+ vs *bespoke* (custom project / retainer). Signals positioning maturity.+5. **Distinctiveness posture** — *conventional / safe* vs *contrarian /+ manifesto-driven*. The opinionated end is key for distinctiveness+ benchmarking in any niche.+6. **Evidence / credibility model** — *outcome-led* (metrics, named clients,+ case depth) vs *aesthetic-led* (portfolio, awards). Tells you how each player+ earns trust.+7. **Brand strength of the operator** — *interchangeable* vs *cult / ownable+ identity* (including senior independents who prove the "memorable solo brand"+ model).+8. **Market / reach** — *local / regional* vs *global-remote*; note whether they+ win the same clients the client targets.++Plot each candidate on the relevant axes; a competitor is *direct* when it sits+near the client on positioning, specialization, size, and market at once.++## Competitive tiers (how the set resolves)++Group the final set into three tiers — this structure carries through to the+report:++- **Direct** — same band, overlapping offer, same client targets. The realistic+ head-to-head.+- **Adjacent** — partial overlap (one capability, or a different client size)+ that pressures at the edges.+- **Aspirational** — players the client is not competing with today but whose+ brand or commercial maturity sets the bar to aim at.+- *(Watch also for substitutes:* no-code/AI tools, in-house teams, generalist+ freelancers — note as a threat vector, not a profiled competitor unless+ materially relevant.)*++## Data sources (where to look)++Match the source to the dimension you need. The platform *types* below are+generic; substitute the ones native to the client's niche (e.g. Dribbble/Behance+for design, showreel/Vimeo for motion, writing samples/published work for copy):++- **Portfolio / craft platforms** — craft quality, range, aesthetic register+ (e.g. Dribbble, Behance, Vimeo, or the niche's equivalent showcase).+- **Awards / curated showcases** — craft ambition and editorial recognition;+ over-indexes on flashy, so cross-check commercial credibility (e.g. Awwwards,+ industry award lists).+- **Competitor's own site** — primary source for positioning, voice, offer+ packaging, pricing posture, named clients, manifesto/POV.+- **LinkedIn** — team size/model, founder narrative, post cadence, client logos,+ geography.+- **Review directories** — reviews, named clients, project sizes, engagement+ models; strongest signal for commercial credibility and enterprise-readiness+ (e.g. Clutch.co or the niche's equivalent).+- **Open / public work** — process repos, published samples, open creative+ output: depth and craft-transparency evidence.+- **Conference talks / podcasts / newsletters** — thought-leadership depth and+ POV ownership.++Always **verify claims across at least two sources** before treating a competitor+attribute as fact (self-reported site copy ≠ verified outcome). Carry an+adversarial-verification discipline into every profile.++## Scoring matrix template (selection stage)++A lightweight pre-filter to decide who graduates into full benchmarking. Score+1–5; keep candidates that score high on **either** distinctiveness **or**+credibility — the client's strategic tension means both poles are instructive.++| Candidate | Positioning stance | Specialization | Size band | Tier | Offer overlap (1–5) | Distinctiveness (1–5) | Commercial credibility (1–5) | Craft proximity (1–5) | Include? |+|-----------|--------------------|----------------|-----------|------|---------------------|------------------------|------------------------------|------------------------|----------|++Rules of thumb (apply per the client's scoping consequence in the positioning brief):++- High distinctiveness **and** high credibility → must-profile (proves the+ client's target tension is achievable).+- High distinctiveness, low credibility → cautionary case (memorable but+ un-hireable — a potential failure mode to learn from).+- High credibility, low distinctiveness → "competent but forgettable" mass the+ client defines itself against.+- Low on both → drop unless needed for landscape breadth.++## Output of this stage++A scoped, tiered competitor set (typically 10–18 candidates → 8–12 profiled),+each tagged with its axis positions, tier, and source links, ready to hand to+`benchmark-methodology`.++## Anti-Patterns++- **Scoping without a positioning brief.** A competitor list built without the client's lens is noise. The brief determines what counts as a real rival.+- **Listing every similar company.** The goal is a defensible 10–18 candidate set, not a census. Breadth without pruning makes benchmarking unmanageable.+- **Blurring the Direct/Adjacent/Aspirational tiers.** These tiers serve different strategic purposes. Mixing them produces a flat list that can't drive decisions.+- **Relying on a single source per competitor.** Self-reported site copy is marketing, not fact. Verify attributes across at least two sources.+- **Jumping straight to scoring.** This skill scopes and tiers the set. Benchmark-methodology handles scoring. Don't conflate the two steps.++## Related Skills++- `brand-discovery` — use first to establish the positioning brief and strategic tension that scopes the competitor set.+- `benchmark-methodology` — the next step; takes the tiered set and scores each competitor across nine dimensions.diff --git a/.agents/skills/competitive-platform-analysis/agents/openai.yaml b/.agents/skills/competitive-platform-analysis/agents/openai.yamlnew file mode 100644index 000000000..a3afbc89f--- /dev/null+++ b/.agents/skills/competitive-platform-analysis/agents/openai.yaml@@ -0,0 +1,7 @@+interface:+ display_name: "Competitive Platform Analysis"+ short_description: "Scope and tier a competitor set before benchmarking"+ brand_color: "#0EA5E9"+ default_prompt: "Use $competitive-platform-analysis to scope and categorize a competitor set."+policy:+ allow_implicit_invocation: truediff --git a/.agents/skills/competitive-report-structure/SKILL.md b/.agents/skills/competitive-report-structure/SKILL.mdnew file mode 100644index 000000000..c20f1d73e--- /dev/null+++ b/.agents/skills/competitive-report-structure/SKILL.md@@ -0,0 +1,159 @@+---+name: competitive-report-structure+description: >-+ Use after benchmark-methodology has produced scored competitor profile cards.+ Assembles findings into a decision-grade report: landscape map, competitor+ profiles, benchmarking matrix, white-space analysis, strategic recommendations,+ and team alignment trigger questions. Final step in the three-skill competitive+ pipeline.+---++# Competitive Report Structure++Use this skill to assemble scored competitor cards into a decision-grade report.+The report must answer three questions for the client: **who do we compete with,+how do we compete, and where is our defensible white-space?** Every section+earns its place by moving toward those answers — cut anything that doesn't.++## When to Activate++- All competitor profile cards from benchmark-methodology are complete and ready to assemble.+- Need to present competitive findings to a founder, leadership team, or board.+- The report must drive decisions (who to compete with, how, where the moat is) — not just document the landscape.+- Preparing a client deliverable that must be auditable and defensible.++## Client positioning brief (establish first)++Before assembling the report, establish the client's positioning brief. It+supplies:++- **Strategic tension** — the paired axes (e.g., memorability × hireability)+ that define the client's target white-space. All maps and synthesis resolve+ back to this tension.+- **Brand balance** — the intended proportional mix of the client's strategic+ emphases (e.g., 60% strategy/evidence, 25% distinctiveness, 15% craft).+ Every recommendation must be checked against this balance; flag any that+ would shift it.+- **Differentiator** — the framing principle for the executive summary and+ white-space section.+- **Target quadrant** — where the client intends to sit in the tension map;+ confirming whether that quadrant is genuinely open is the report's central+ empirical question.++## Framing principle++The whole report is organized around the client's strategic tension and+recommendations resolve back to the client's deliberate brand balance.+Recommendations that would break that balance must be flagged against it+explicitly — "this move shifts the balance from X/Y/Z toward A/B/C; confirm+intent."++## Report sections++### 1. Executive summary+3–5 takeaways, decision-first. State the most important findings in plain+language: where the client is strong, where it's exposed, who occupies its+target white-space, and the top 2–3 moves. Written so a founder/PM reads only+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+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+empty) it is.++### 3. Competitor tiers+Organize the set into **Direct / Adjacent / Aspirational** (from+`competitive-platform-analysis`). One short paragraph per tier explaining who's+in it and why it matters to the client. This sets reader expectations before+the detail.++### 4. Benchmarking matrix+The full **competitors × dimensions** table — the quantitative spine. Rows =+competitors (grouped by tier), columns = the nine dimensions. Include the+client's own honest self-assessment as a row for contrast. Use a **heatmap**+(color or symbol scale) so strength/weakness patterns are scannable. Do **not**+add a blended total column — report dimensions separately (per the bias+controls). Call out the columns where the client leads and where it trails.++### 5. Deep dives+3–5 most instructive competitors in narrative form (from their profile cards).+Choose for instruction, not ranking: the best exemplar of the target tension+(high on both poles), the cautionary "one pole only" case, the "competent but+forgettable" archetype the client defines against, plus any direct threat. Each+deep dive: what they do, what the client should learn, what the client should+avoid.++### 6. White-space & threats+The strategic heart. Two parts:++- **White-space:** the position the client can own that rivals don't — argued+ from the maps and matrix, not asserted. Confirm whether the target quadrant+ (from the positioning brief) is genuinely open.+- **Threats:** who/what pressures the client — a rival closing the gap,+ substitutes (no-code/AI tools, in-house teams, generalist freelancers), or+ category shifts. Be honest about the client's own risks (e.g., a bold identity+ reading as un-serious to risk-averse buyers).++### 7. Strategic recommendations+Concrete, prioritized moves: who the client competes with, how it differentiates,+and where to invest (offer packaging, evidence/case studies, thought leadership,+brand sharpening). **Tie every recommendation back to the brand balance from the+positioning brief** and flag any that would shift it. Sequence by impact ×+effort.++### 8. Sources / methodology appendix+The dimensions, weights, rubrics, the scoped set with tiers, source links per+competitor, and verification notes (asserted vs proven). This is what makes the+report auditable and defensible — carry the adversarial citation discipline+through.++## How to present data++- **2×2 / positioning maps** — for landscape and the tension plot. Lead with+ these; they carry the argument faster than prose.+- **Heatmap matrix** — for the competitors × dimensions comparison (section 4).+- **Profile cards** — the source unit feeding deep dives (section 5).+- **Quadrant callouts** — name who sits in each quadrant explicitly, especially+ the client's target one.+- Keep tables scannable; push raw evidence and links to the appendix.++## Decision framework (the report must resolve these)++- **Who do we compete with?** — Name the Direct tier specifically; that's the+ real fight.+- **How do we compete?** — State the client's differentiator in one sentence,+ grounded in the matrix (which dimensions the client owns).+- **Where are our differentiators defensible?** — Identify the+ dimensions/quadrant rivals can't easily copy (the moat), vs. the ones that+ are table-stakes.++## Trigger questions for the team alignment session++End with questions that force decisions, not admiration of the analysis:++- Is the target quadrant truly open, or is a rival already moving in?+- Which Direct competitor is the sharpest threat in the next 12 months, and+ what's the counter?+- Does the brand balance still hold given the landscape — should any emphasis+ shift?+- Which dimension where the client trails is worth closing, and which to+ deliberately concede?+- What's the one move that most widens distinctiveness *without* costing+ hireability / credibility?++## Anti-Patterns++- **Leading with methodology.** The executive summary opens with the most important finding, not an explanation of how the benchmark was run. Methodology belongs in the appendix.+- **Presenting scores without the tension plot.** The 2×2 tension map is the headline artefact. A table of numbers without the map buries the strategic insight.+- **Omitting the decision framework.** The report must resolve the three questions (who to compete with, how, where the moat is). Leaving these unanswered turns the report into a literature review.+- **Starting before all profile cards are complete.** Benchmark-methodology must finish before assembly begins. Partial data produces gaps that undermine the heatmap and white-space analysis.+- **Adding a blended total column to the matrix.** Explicitly excluded — it creates a false composite that obscures the asymmetry the client needs to act on.++## Related Skills++- `benchmark-methodology` — the prerequisite; produces the scored competitor profile cards this skill assembles.+- `competitive-platform-analysis` — provides the tier structure (Direct / Adjacent / Aspirational) used in Section 3.+- `brand-discovery` — use to establish the client's positioning brief if it hasn't been defined.diff --git a/.agents/skills/competitive-report-structure/agents/openai.yaml b/.agents/skills/competitive-report-structure/agents/openai.yamlnew file mode 100644index 000000000..86df7c046--- /dev/null+++ b/.agents/skills/competitive-report-structure/agents/openai.yaml@@ -0,0 +1,7 @@+interface:+ display_name: "Competitive Report Structure"+ short_description: "Assemble scored cards into a decision-grade competitive report"+ brand_color: "#10B981"+ default_prompt: "Use $competitive-report-structure to assemble a competitive benchmarking report."+policy:+ allow_implicit_invocation: truediff --git a/README.md b/README.mdindex cb3ad85a5..768e76361 100644--- a/README.md+++ b/README.md@@ -149,12 +149,12 @@ This repo is the raw code only. The guides explain everything.### v2.0.0 — The Agent Harness Operating System (Jun 2026)-Stable graduation of the 2.0 line: 261 skills, the control-pane substrate (session adapters + MCP inventory), the worktree-lifecycle service, the `orch-*` orchestrator family, and the launch of the [ECC Discord community](https://discord.gg/36yGMHGFbR). Full notes: [docs/releases/2.0.0/release-notes.md](docs/releases/2.0.0/release-notes.md).+Stable graduation of the 2.0 line: 265 skills, the control-pane substrate (session adapters + MCP inventory), the worktree-lifecycle service, the `orch-*` orchestrator family, and the launch of the [ECC Discord community](https://discord.gg/36yGMHGFbR). Full notes: [docs/releases/2.0.0/release-notes.md](docs/releases/2.0.0/release-notes.md).### 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, 262 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, 269 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.@@ -425,7 +425,7 @@ If you stacked methods, clean up in this order:/plugin list ecc@ecc```-**That's it!** You now have access to 64 agents, 262 skills, and 84 legacy command shims.+**That's it!** You now have access to 64 agents, 269 skills, and 84 legacy command shims.### Dashboard GUI@@ -1498,7 +1498,7 @@ The configuration is automatically detected from `.opencode/opencode.json`.|---------|---------------------|----------|--------|| Agents | PASS: 64 agents | PASS: 12 agents | **Claude Code leads** || Commands | PASS: 84 commands | PASS: 35 commands | **Claude Code leads** |-| Skills | PASS: 262 skills | PASS: 37 skills | **Claude Code leads** |+| Skills | PASS: 269 skills | PASS: 37 skills | **Claude Code leads** || Hooks | PASS: 8 event types | PASS: 11 events | **OpenCode has more!** || Rules | PASS: 29 rules | PASS: 13 instructions | **Claude Code leads** || MCP Servers | PASS: 14 servers | PASS: Full | **Full parity** |@@ -1659,7 +1659,7 @@ ECC is the **first plugin to maximize every major AI coding tool**. Here's how e|---------|-----------------------|------------|-----------|----------|----------------|| **Agents** | 64 | Shared (AGENTS.md) | Shared (AGENTS.md) | 12 | N/A || **Commands** | 84 | Shared | Instruction-based | 35 | 5 prompts |-| **Skills** | 262 | Shared | 10 (native format) | 37 | Via instructions |+| **Skills** | 269 | Shared | 10 (native format) | 37 | Via instructions || **Hook Events** | 8 types | 15 types | None yet | 11 types | None || **Hook Scripts** | 20+ scripts | 16 scripts (DRY adapter) | N/A | Plugin hooks | N/A || **Rules** | 34 (common + lang) | 34 (YAML frontmatter) | Instruction-based | 13 instructions | 1 always-on file |diff --git a/README.zh-CN.md b/README.zh-CN.mdindex 3e29edcf3..411bec877 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -82,7 +82,7 @@### v2.0.0 — 智能体 Harness 操作系统(2026年6月)-2.0 主线稳定版:261 个技能、control-pane 基底(会话适配器 + MCP 清单)、worktree 生命周期服务,以及 [ECC Discord 社区](https://discord.gg/36yGMHGFbR)。+2.0 主线稳定版:265 个技能、control-pane 基底(会话适配器 + MCP 清单)、worktree 生命周期服务,以及 [ECC Discord 社区](https://discord.gg/36yGMHGFbR)。### v2.0.0-rc.1 — 表面同步、运营工作流与 ECC 2.0 Alpha(2026年4月)@@ -164,7 +164,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"/plugin list ecc@ecc```-**完成!** 你现在可以使用 64 个代理、262 个技能和 84 个命令。+**完成!** 你现在可以使用 64 个代理、269 个技能和 84 个命令。### multi-* 命令需要额外配置diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.mdindex 49303d979..62c30de04 100644--- a/docs/zh-CN/README.md+++ b/docs/zh-CN/README.md@@ -83,7 +83,7 @@### v2.0.0 — 智能体 Harness 操作系统(2026年6月)-2.0 主线稳定版:261 个技能、control-pane 基底(会话适配器 + MCP 清单)、worktree 生命周期服务,以及 [ECC Discord 社区](https://discord.gg/36yGMHGFbR)。+2.0 主线稳定版:265 个技能、control-pane 基底(会话适配器 + MCP 清单)、worktree 生命周期服务,以及 [ECC Discord 社区](https://discord.gg/36yGMHGFbR)。### v2.0.0-rc.1 — 表面同步、运营工作流与 ECC 2.0 Alpha(2026年4月)@@ -228,7 +228,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"/plugin list ecc@ecc```-**搞定!** 你现在可以使用 64 个智能体、262 项技能和 84 个命令了。+**搞定!** 你现在可以使用 64 个智能体、269 项技能和 84 个命令了。***@@ -1142,7 +1142,7 @@ opencode|---------|---------------|----------|--------|| 智能体 | PASS: 64 个 | PASS: 12 个 | **Claude Code 领先** || 命令 | PASS: 84 个 | PASS: 35 个 | **Claude Code 领先** |-| 技能 | PASS: 262 项 | PASS: 37 项 | **Claude Code 领先** |+| 技能 | PASS: 269 项 | PASS: 37 项 | **Claude Code 领先** || 钩子 | PASS: 8 种事件类型 | PASS: 11 种事件 | **OpenCode 更多!** || 规则 | PASS: 29 条 | PASS: 13 条指令 | **Claude Code 领先** || MCP 服务器 | PASS: 14 个 | PASS: 完整 | **完全对等** |@@ -1250,7 +1250,7 @@ ECC 是**第一个最大化利用每个主要 AI 编码工具的插件**。以|---------|-----------------------|------------|-----------|----------|| **智能体** | 64 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 || **命令** | 84 | 共享 | 基于指令 | 35 |-| **技能** | 262 | 共享 | 10 (原生格式) | 37 |+| **技能** | 269 | 共享 | 10 (原生格式) | 37 || **钩子事件** | 8 种类型 | 15 种类型 | 暂无 | 11 种类型 || **钩子脚本** | 20+ 个脚本 | 16 个脚本 (DRY 适配器) | N/A | 插件钩子 || **规则** | 34 (通用 + 语言) | 34 (YAML 前页) | 基于指令 | 13 条指令 |diff --git a/skills/benchmark-methodology/SKILL.md b/skills/benchmark-methodology/SKILL.mdnew file mode 100644index 000000000..950784c3d--- /dev/null+++ b/skills/benchmark-methodology/SKILL.md@@ -0,0 +1,191 @@+---+name: benchmark-methodology+description: >-+ Use after competitive-platform-analysis has produced a tiered competitor set.+ Scores each competitor across nine weighted dimensions (positioning, voice,+ 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++Use this skill to turn a scoped competitor set into **comparable, defensible+scores**. Each competitor is assessed on the same nine dimensions, with+explicit 1–5 rubrics, then captured in a uniform profile card. Consistency is+the point: scores are only useful if the same evidence would earn the same+number for any competitor.++## When to Activate++- A scoped, tiered competitor set from competitive-platform-analysis is ready to score.+- Need comparable, evidence-anchored scores across competitors — not gut-feel rankings.+- Client's strategic tension (the paired axes defining their target white-space) has been established.+- Preparing to produce profile cards for assembly in competitive-report-structure.++## Client positioning brief (establish first)++Before scoring, establish the client's positioning brief. It supplies:++- **Strategic tension** — the two axes (e.g., memorability × hireability) whose+ intersection marks the client's target white-space. Dimension 9 is always+ the client's named tension; report both poles separately, never averaged.+- **Differentiator** — what makes the client's moat. This informs which+ dimensions matter most for the client's positioning argument.+- **Brand balance** — the intended mix of distinct strategic emphases. Strategic+ recommendations must not break this balance without flagging it.++## Why these dimensions++The client competes on a **specific tension held across two poles**, not on+service breadth. The dimensions are weighted to reflect that moat. Two+dimensions — the tension poles — are scored **separately and never averaged+together**, because the client's strategic question is precisely whether a rival+achieves both simultaneously.++## The nine dimensions (with weights)++Weights guide synthesis emphasis, not a single blended score (avoid a false+composite — see Bias controls). Sum = 100%.++1. **Positioning clarity & distinctiveness** (18%) — Is the studio's position+ sharp, ownable, and instantly legible? Or generic?+2. **Brand voice / verbal distinctiveness** (15%) — Does the copy have an+ ownable register, or is it interchangeable agency-speak?+3. **Visual identity & site craft** (15%) — Quality and ownership of the visual+ system; site as proof-of-craft.+4. **Service offer & packaging** (12%) — Productized and legible (named+ sprints/audits) vs vague. Packaging maturity.+5. **Evidence & credibility** (12%) — Named clients, quantified outcomes,+ case-study depth. Proof beyond assertion.+6. **Enterprise-readiness / commercial maturity** (10%) — Signals they can land+ and hold SaaS/fintech/B2B/enterprise work (process, logos, scale, contracts).+7. **Thought leadership / content presence** (8%) — Owned POV: writing, talks,+ newsletters, frameworks. Depth over volume.+8. **Pricing transparency & engagement model** (5%) — Is pricing/engagement+ legible? Productized vs bespoke vs opaque.+9. **[Client's strategic tension]** (5% as a flag; **score BOTH poles,+ report separately**) — Read the tension name and axis descriptions from the+ client's positioning brief. Plot both; the gap is the insight. The client's+ target quadrant is the single most important finding: who else is already+ there?++## Scoring rubric (1–5, applies to dimensions 1–8)++Anchor every score to observable evidence. Generic descriptors below; adapt the+specifics per dimension but keep the level meaning constant.++- **1 — Absent / generic.** No discernible position or craft; indistinguishable+ from a template. Active liability.+- **2 — Below par.** Some intent but inconsistent, derivative, or unconvincing.+ Wouldn't survive a side-by-side.+- **3 — Competent / table-stakes.** Solid, professional, unremarkable. Meets+ expectation, ownable by nobody.+- **4 — Strong / distinctive.** Clearly above peers; a real strength a buyer+ would notice and cite.+- **5 — Category-defining.** Best-in-class, ownable, hard to imitate. Sets the+ bar others react to.++### Tension axes (dimension 9) — score each 1–5++Read the axis labels and their 1/3/5 anchors from the client's positioning+brief. Example anchors for a memorability × credibility tension:++- **Memorability** — 1: forgotten instantly · 3: recognizable in context ·+ 5: unforgettable, talked-about, distinctively owned.+- **Credibility** — 1: feels risky/amateur · 3: safe, competent,+ unexciting · 5: enterprise-trusted, obvious safe choice.++Plot competitors on the tension 2×2. The client's target quadrant is named in+the positioning brief. Who else occupies that quadrant is the single most+important finding of the benchmark.++## How to collect the data++For each competitor, work the dimensions in this order (cheapest signal first):++1. **Competitor's own site** — positioning, voice, offer packaging, pricing+ posture, named clients, manifesto/POV. Screenshot the homepage + one case+ study.+2. **Case studies / work** — evidence depth, quantified outcomes, client names.+ Distinguish *asserted* ("we delivered X") from *proven* (metrics, named,+ verifiable).+3. **Review directories** — corroborate clients, project size, engagement model+ → credibility & enterprise-readiness (e.g. Clutch.co or the niche equivalent).+4. **LinkedIn** — team size/model, founder narrative, content cadence →+ thought leadership, model.+5. **Portfolio / craft platforms** — craft register (use the showcase native to+ the niche: design boards, showreels, published samples, etc.).+6. **Content channels** — newsletter/talks/writing → thought-leadership depth.++**What to record per dimension:** the score, one-line justification, and the+source link/screenshot that earned it. No score without evidence.++## Bias controls++- **No single composite score.** Report dimension scores and the tension plot+ separately. A weighted average hides the asymmetry that matters.+- **Asserted vs proven.** Downgrade credibility/evidence scores for+ self-reported claims with no corroboration. Site copy is marketing, not fact.+- **Aesthetic affinity bias.** Reviewers may over-score studios whose aesthetic+ they share and under-score rivals' commercial strength. Score craft and+ credibility independently; a "boring" site may be winning bigger clients.+- **Recency / flashiness bias.** Award-winning, showpiece work dazzles but may+ lack commercial depth — verify with directories/clients before scoring+ credibility.+- **Survivorship.** The visible, well-marketed studios aren't the whole market;+ note strong-but-quiet operators found via directories/reviews.+- **Calibrate across the set, not in isolation.** Before finalizing, re-read+ scores side-by-side — a "4" must mean the same thing for every competitor.+ Adjust outliers.++## Competitor profile card (output format)++Produce one card per profiled competitor — the atomic unit the report assembles+from:++```+## <Competitor name>+- **Profile / Tier:** <positioning stance · specialization · size band> / <Direct | Adjacent | Aspirational>+- **One-liner:** <how they position themselves, in their words>+- **Model / size / geography:** <solo|micro|boutique> · <region> · <pricing/engagement model>+- **Notable clients / evidence:** <named, with proven/asserted tag>++### Dimension scores+| Dimension | Score (1–5) | Justification (1 line) | Source |+|---|---|---|---|+| Positioning clarity & distinctiveness | | | |+| Brand voice / verbal distinctiveness | | | |+| Visual identity & site craft | | | |+| Service offer & packaging | | | |+| Evidence & credibility | | | |+| Enterprise-readiness / commercial maturity | | | |+| Thought leadership / content presence | | | |+| Pricing transparency & engagement model | | | |++### Tension plot+- **[Axis 1 from positioning brief]:** <1–5> — <why>+- **[Axis 2 from positioning brief]:** <1–5> — <why>+- **Quadrant:** <high/high | high-1/low-2 | low-1/high-2 | low/low>++### Read for [client]+- **Strength to learn from:** <…>+- **Weakness to exploit / white-space it exposes:** <…>+- **Threat to [client]:** <…>+```++Hand the completed cards plus the tension plot to `competitive-report-structure`.++## Anti-Patterns++- **Averaging the tension axes.** The two poles of the client's strategic tension must be scored and reported separately. Averaging destroys the insight — the gap between poles is the finding.+- **Scoring without evidence.** Every score requires a one-line justification and a source link. A score without evidence is an opinion, not a benchmark.+- **Creating a single composite score.** Report dimension scores individually. A weighted average hides the asymmetric strengths that matter for positioning.+- **Applying generic rubric anchors without adapting.** The 1–5 anchors must be calibrated to the specific dimension and competitor set. The generic descriptions are a starting point, not a fixed standard.+- **Running before the competitor set is scoped.** Use competitive-platform-analysis first to produce a tiered, pruned set. Scoring an unscoped list wastes effort on irrelevant competitors.++## Related Skills++- `competitive-platform-analysis` — the prerequisite; produces the tiered competitor set this skill scores.+- `competitive-report-structure` — the next step; assembles the scored profile cards into a client-deliverable report.diff --git a/skills/brand-discovery/SKILL.md b/skills/brand-discovery/SKILL.mdnew file mode 100644index 000000000..c5e593585--- /dev/null+++ b/skills/brand-discovery/SKILL.md@@ -0,0 +1,134 @@+---+name: brand-discovery+description: >-+ Use when a brand needs to discover or articulate its identity through+ structured multi-session interviews. Covers purpose, positioning, audience,+ 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++Use this skill to conduct a structured, adaptive brand identity interview.+The goal is a complete `90_SYNTHESIS.md` — a master brandbook the+organization can use to brief designers, writers, and external+collaborators.++The interview runs across multiple sessions. Capture answers to disk as you+go so that no elicited knowledge is lost when a conversation ends, and so a+later session can resume from where the last one stopped.++## When to Activate++- A brand is being created, repositioned, or needs a written identity reference to brief collaborators.+- Multiple sessions are expected — the conversation will span days or weeks.+- Multiple founders or stakeholders need individual interviews before a reconciliation pass.+- The user wants a structured, repeatable method rather than an ad-hoc chat.+- Existing brand documentation is scattered, implicit, or founder-dependent and needs to be made explicit.++## Session start protocol++On every activation, perform these steps **before** asking any interview+question:++1. **Check for prior progress.** Look for an existing set of module files+ and a `state.json` checkpoint in the project's brand-identity directory.+ If none exists, this is a fresh start — confirm the brand name,+ participants, and where to save the brand-identity files, then begin at+ the first module.+2. **Read the current module file** if one is in progress, and scan its Raw+ section for previously captured answers.+3. **Report to the user** in two or three sentences: which module we are+ in, its status, and what remains. Then ask: "Continue here, or switch+ module?"++## Interview discipline++Apply these rules throughout every module:++1. **One question at a time.** Never present a list of questions.+2. **After each answer:** short paraphrase → one deepening probe OR close+ the thread if the topic is saturated. Never move on silently.+3. **Laddering:** for every "what" answer, follow with "Why does that+ matter to you?" until a core value surfaces (typically two to four+ iterations).+4. **5 Whys:** for beliefs or positioning claims — push until the root+ reason, not the surface declaration, is on the table.+5. **Detect thin answers:** if generic, jargon-heavy, or vague, ask for+ one concrete example, a client story, or a number.+6. **Projective techniques** (use once per module to break a plateau):+ - "If the brand were a person, how would they walk into a room?"+ - Brand obituary: "If the organization closed in five years, what would+ customers miss? What would you regret not having said?"+ - Competitive contrast: "Name one peer you admire but would never want+ to become. What specifically makes them the wrong model?"+7. **Saturation signal:** when two consecutive probes produce no new+ information, summarise and close the module.+8. **End of module:** write a structured module file with two sections:+ - `## Raw` — verbatim quotes and examples.+ - `## Synthesis` — your interpretation, three candidate formulations,+ open questions, contradictions between participants.+ Then update the `state.json` checkpoint (see State protocol below).++## Module sequence++| File | Label | Frameworks used |+|------|-------|-----------------|+| `10_purpose-why.md` | Purpose / Why | Sinek Golden Circle, Lencioni |+| `20_positioning.md` | Positioning | Dunford "Obviously Awesome", Moore template |+| `30_audience-niche.md` | Audience & Niche | Baker "Business of Expertise", ICP |+| `40_personality-archetype.md` | Personality & Archetype | Mark & Pearson 12 archetypes, J. Aaker 5 dims |+| `50_voice-tone.md` | Voice & Tone | Brand voice guidelines |+| `60_narrative-story.md` | Narrative / Story | Neumeier trueline, brand story arc |+| `70_founder-tension.md` | Founder Brands vs Studio Brand | Enns "Win Without Pitching" |+| `90_SYNTHESIS.md` | Master Brandbook | Kapferer prism, Aaker brand system |++Complete modules in order. Honour a user request to jump modules and note+the skip in `state.json`.++## State write protocol++After each module reaches saturation or done status, write two files:++**Module file** at `modules/{moduleFile}` — full Raw and Synthesis content.++**`state.json`** — a lightweight checkpoint so a later session can resume.+Update `completedModules`, `inProgressModule`, `nextModule`, `lastUpdated`.+Schema:++```json+{+ "session": "{brand_name}-brand-{YYYY-MM}",+ "outputPath": "{path_to_brand_identity_directory}",+ "completedModules": [],+ "inProgressModule": "10_purpose-why.md",+ "nextModule": "20_positioning.md",+ "participants": ["founder-A"],+ "lastUpdated": "{ISO-8601}"+}+```++After writing, confirm: "Module X saved. State updated. Next: Y."++## Multi-founder mode++When more than one founder participates, write each founder's answers to+`founders/{participant}.md` instead of the main module files. After all+founders complete a module, run a reconciliation pass: summarise+convergences and divergences in the module file, flag "productive tensions"+for the group alignment workshop.++## Anti-Patterns++- **Starting without reading state first.** Every session must open by checking for existing module files and `state.json`. Skipping this loses all continuity from prior sessions.+- **Asking multiple questions at once.** One question at a time is not optional — lists produce checklist answers, not real insight.+- **Moving to Synthesis before saturation.** If the last two probes produced no new information, the module is done. If they did — it isn't.+- **Skipping multi-founder reconciliation.** When multiple stakeholders are involved, individual interviews must complete before reconciliation. Discussing the brand collectively first introduces anchoring bias.+- **Treating this as a one-shot session.** This skill is designed for multiple sessions. Rushing to `90_SYNTHESIS.md` in one conversation produces shallow output.++## Related Skills++- `competitive-platform-analysis` — after brand-discovery establishes the positioning brief, use this to scope and categorise the competitor set.+- `brand-voice` (ECC) — if the brand-discovery voice-and-tone module needs a separate, source-derived writing-style profile.diff --git a/skills/brand-discovery/references/10_purpose-why.md b/skills/brand-discovery/references/10_purpose-why.mdnew file mode 100644index 000000000..8788b9457--- /dev/null+++ b/skills/brand-discovery/references/10_purpose-why.md@@ -0,0 +1,42 @@+# Module 10 — Purpose / Why++> **Frameworks:** Sinek Golden Circle · Lencioni organisational purpose+>+> **Goal:** Surface the brand's core belief — the Why that exists independently+> of what the organisation sells or how it delivers. Captures the founding+> conviction, not the elevator pitch.++---++## Raw++<!-- Verbatim quotes, stories, and examples captured during the interview.+ Record exact language — paraphrase belongs in Synthesis, not here.+ Include speaker attribution if multi-founder session. -->++### Core belief (why does this exist?)++### The behavioural How (values in action, not poster slogans)++### What the brand refuses to be or do++### Founder quotes strong enough to become internal anchors++---++## Synthesis++<!-- Your interpretation of the raw material.+ Write three sections: formulations, open questions, contradictions. -->++### Candidate Why formulations (offer 2–3 versions, vary register and specificity)++1.+2.+3.++### Open questions / threads to pursue in later modules++### Contradictions or tensions between participants (multi-founder only)++### How does this Why constrain or enable positioning? (bridge to Module 20)diff --git a/skills/brand-discovery/references/20_positioning.md b/skills/brand-discovery/references/20_positioning.mdnew file mode 100644index 000000000..fe32d241f--- /dev/null+++ b/skills/brand-discovery/references/20_positioning.md@@ -0,0 +1,46 @@+# Module 20 — Positioning++> **Frameworks:** Dunford *Obviously Awesome* · Moore crossing-the-chasm template ·+> Jobs-to-be-done lens+>+> **Goal:** Define the brand's competitive frame — who it's for, what category it+> competes in, what it does uniquely, and why that matters to the target client.+> Output is the raw material for a positioning statement the brand can act on.++---++## Raw++<!-- Verbatim quotes and examples. Record exact language. -->++### Who is the target client? (role, company type, situation)++### What category does the brand compete in? (how clients currently solve this problem)++### What makes the brand different from alternatives in that category?++### What does the target client care about most? (the value they get that others can't match)++### Competitive alternatives named by the founder (include "do nothing" / "hire in-house")++### Phrases or metaphors the founder uses naturally to describe what they do++---++## Synthesis++### Positioning statement draft (Dunford template)+> For **[target client]** who **[situation / JTBD]**, **[brand name]** is the+> **[category]** that **[unique value]**. Unlike **[alternatives]**, we+> **[key differentiator]**.++### Alternative framings (vary the category or the differentiator)++1.+2.++### White-space hypothesis (what no competitor is claiming that this brand could own)++### Open questions / ambiguities++### Tensions with Module 10 Why (flag any contradictions for Module 90 reconciliation)diff --git a/skills/brand-discovery/references/30_audience-niche.md b/skills/brand-discovery/references/30_audience-niche.mdnew file mode 100644index 000000000..2f18e0c9b--- /dev/null+++ b/skills/brand-discovery/references/30_audience-niche.md@@ -0,0 +1,52 @@+# Module 30 — Audience & Niche++> **Frameworks:** Baker *The Business of Expertise* · Ideal Client Profile (ICP) ·+> Pain / trigger / desired outcome lens+>+> **Goal:** Make the target audience concrete enough to brief a copywriter or run+> a paid campaign — not a demographic sketch, but a psychographic and situational+> portrait of the best client the brand wants more of.++---++## Raw++<!-- Verbatim quotes and examples. -->++### Who is the ideal client? (describe a specific person, not a segment)++### What situation or trigger brings them to look for help?++### What have they tried before and why did it fall short?++### What does success look like to them? (in their words, not the brand's)++### What do they fear or want to avoid?++### Worst-fit clients (who the brand doesn't want to work with, and why)++### Quotes or stories from real past clients that illustrate the ideal fit++---++## Synthesis++### Ideal Client Profile (ICP)++| Dimension | Description |+|---|---|+| Role / title | |+| Organisation type & size | |+| Trigger situation | |+| Primary pain | |+| Desired outcome | |+| Budget signal | |+| Red-flag / disqualifier | |++### Psychographic portrait (2–3 sentences: how this person thinks, what they value, what they distrust)++### Niche hypothesis (the smallest viable market the brand could credibly own)++### Audience segments to test (if there is ambiguity about primary vs secondary ICP)++### Open questions / threads for Module 20 positioning reconciliationdiff --git a/skills/brand-discovery/references/40_personality-archetype.md b/skills/brand-discovery/references/40_personality-archetype.mdnew file mode 100644index 000000000..5b5ba29e7--- /dev/null+++ b/skills/brand-discovery/references/40_personality-archetype.md@@ -0,0 +1,60 @@+# Module 40 — Personality & Archetype++> **Frameworks:** Mark & Pearson 12 brand archetypes · J. Aaker 5 brand personality+> dimensions (sincerity / excitement / competence / sophistication / ruggedness)+>+> **Goal:** Establish the brand's character — how it would behave if it were a+> person. Personality governs tone, visual register, and what feels "on brand"+> versus "wrong". A sharp archetype makes a hundred small decisions automatic.++---++## Raw++<!-- Verbatim quotes and projective-technique responses. -->++### "If the brand were a person, how would they walk into a room?"++### Archetype instinct (which of the 12 resonates immediately, and why?)+> Creator · Caregiver · Ruler · Jester · Regular Person · Lover · Hero ·+> Outlaw · Magician · Innocent · Sage · Explorer++### Three adjectives the founder uses most naturally to describe the brand's character++### One brand or public figure the founder admires but the brand should NOT become+(and specifically what to avoid)++### One brand or public figure whose personality register the brand aspires to++### How should the brand make clients feel? (not think — feel)++---++## Synthesis++### Primary archetype + shadow++| | |+|---|---|+| **Primary archetype** | (name + 1-line why) |+| **Secondary / shadow** | (what the primary archetype risks becoming; what keeps it honest) |++### J. Aaker personality scores (1–5, 5 = strongly applies)++| Dimension | Score | Evidence |+|---|---|---|+| Sincerity (warm, honest, down-to-earth) | | |+| Excitement (daring, spirited, imaginative) | | |+| Competence (reliable, intelligent, successful) | | |+| Sophistication (upper-class, charming) | | |+| Ruggedness (outdoorsy, tough) | | |++### Personality in action (3 behavioural guidelines derived from the archetype)++1.+2.+3.++### What the brand must never sound or look like (the anti-personality)++### Open questions / tensions with Module 50 Voicediff --git a/skills/brand-discovery/references/50_voice-tone.md b/skills/brand-discovery/references/50_voice-tone.mdnew file mode 100644index 000000000..edc17436d--- /dev/null+++ b/skills/brand-discovery/references/50_voice-tone.md@@ -0,0 +1,61 @@+# Module 50 — Voice & Tone++> **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;+> tone shifts by context (home page vs. error message vs. proposal cover).++---++## Raw++<!-- Verbatim quotes and examples from the interview.+ Collect actual copy samples the founder likes or hates. -->++### Copy the founder admires (from their own brand or others) — include the source++### Copy the founder dislikes or finds "wrong register" — what specifically is wrong?++### Words or phrases the brand uses all the time (even informally)++### Words or phrases the brand actively avoids++### How should the brand sound on: a sales page? an error message? a proposal?++### "We always…" / "We never…" statements about how the brand communicates++---++## Synthesis++### Voice spectrum (mark the brand's position on each axis)++| Axis | 1 | 2 | 3 | 4 | 5 | Notes |+|---|---|---|---|---|---|---|+| Formal ←→ Casual | | | | | | |+| Serious ←→ Playful | | | | | | |+| Distant ←→ Warm | | | | | | |+| Conventional ←→ Irreverent | | | | | | |+| Minimal ←→ Expressive | | | | | | |++### Voice statement (one paragraph a writer can internalise)++### Tone matrix by content type++| Content type | Tone shift | Example phrase |+|---|---|---|+| Homepage headline | | |+| Case study / evidence | | |+| Proposal / commercial | | |+| Error / apology | | |+| Social / informal | | |++### The three things to check every draft against++1.+2.+3.++### Open questions / tensions with Module 40 Personalitydiff --git a/skills/brand-discovery/references/60_narrative-story.md b/skills/brand-discovery/references/60_narrative-story.mdnew file mode 100644index 000000000..11a8376ca--- /dev/null+++ b/skills/brand-discovery/references/60_narrative-story.md@@ -0,0 +1,54 @@+# Module 60 — Narrative / Story++> **Frameworks:** Neumeier trueline · Brand story arc (context → conflict →+> resolution → invitation) · Hero's journey (brand as guide, client as hero)+>+> **Goal:** Crystallise the brand's founding story and its narrative arc — the+> conflict it was built to resolve, the transformation it delivers, and the+> invitation it extends to clients. The trueline is the single sentence that+> holds every story the brand tells.++---++## Raw++<!-- Verbatim quotes and stories. -->++### The founding story (what happened, when, why this — not the polished version)++### The conflict or frustration that made the brand necessary++### What the world looks like when the brand's work succeeds (the transformation)++### A client story that best illustrates what the brand does and why it matters++### What would be lost if the brand didn't exist? (brand obituary prompt)++### The invitation: what does the brand ask clients to do or believe?++---++## Synthesis++### Trueline draft (Neumeier: "[Brand] is the only [category] that [unique claim].")++>++### Alternative truelines (2–3 variations, vary level of abstraction)++1.+2.+3.++### Brand story arc++| Beat | Content |+|---|---|+| **Context** (the world before) | |+| **Conflict** (what's broken / wrong) | |+| **Resolution** (what the brand does about it) | |+| **Invitation** (what the client is asked to do) | |++### The brand as guide (not hero) — what the client achieves, not the brand++### Open questions / tensions with Module 20 Positioning and Module 10 Whydiff --git a/skills/brand-discovery/references/70_founder-tension.md b/skills/brand-discovery/references/70_founder-tension.mdnew file mode 100644index 000000000..5c414e270--- /dev/null+++ b/skills/brand-discovery/references/70_founder-tension.md@@ -0,0 +1,49 @@+# Module 70 — Founder Brand vs Organisation Brand++> **Frameworks:** Enns *Win Without Pitching* · Personal brand vs institutional+> brand spectrum+>+> **Goal:** Map the relationship between the founder's personal reputation and the+> organisation's brand. Clarify how much equity each carries, what the healthy+> boundary is, and how to sequence personal vs organisation brand investment.+> Unresolved founder-brand tension is a common scaling bottleneck.++---++## Raw++<!-- Verbatim quotes. -->++### Is the founder personally known in the market? How?++### Do clients buy the founder or the organisation? (ask for evidence, not instinct)++### What happens to the brand if the founder steps back or is unavailable?++### What does the founder want for their personal brand in 3–5 years?++### What does the organisation's brand need to be able to do independently?++### Where has the founder-brand been an asset? Where has it been a constraint?++---++## Synthesis++### Current state: where on the spectrum?++```+[Founder IS the brand] ←————————→ [Organisation brand stands alone]+ 1 2 3 4 5+```+Current position: ___ Target position (3-year): ___++### What the founder brand should own (and keeps owning)++### What the organisation brand needs to own (independently of the founder)++### Transition plan sketch (if moving from founder-centric toward institutional)++### Risk if nothing changes++### Open questions / threads for Module 90 Synthesisdiff --git a/skills/brand-discovery/references/90_SYNTHESIS.md b/skills/brand-discovery/references/90_SYNTHESIS.mdnew file mode 100644index 000000000..1bce2f12f--- /dev/null+++ b/skills/brand-discovery/references/90_SYNTHESIS.md@@ -0,0 +1,105 @@+# Module 90 — Master Brandbook (Synthesis)++> **Frameworks:** Kapferer Brand Identity Prism · Aaker brand system (identity /+> personality / associations / equity)+>+> **Goal:** Reconcile all seven preceding modules into a single, actionable+> brandbook. This document is the source of truth the brand uses to brief+> designers, writers, and external collaborators. It resolves tensions between+> modules, commits to specific formulations, and translates them into practical+> guidelines.++---++## 1. The Why (from Module 10)++> **Core belief:**++> **Behavioural How (values in action):**++> **What we refuse to be:**++---++## 2. Positioning (from Module 20)++> **Positioning statement:**+> For **[target client]** who **[situation]**, **[brand name]** is the+> **[category]** that **[unique value]**. Unlike **[alternatives]**, we+> **[key differentiator]**.++> **White-space the brand owns:**++---++## 3. Audience (from Module 30)++> **Ideal Client Profile (one-paragraph portrait):**++> **Niche the brand is building toward:**++> **Red-flag / disqualifier:**++---++## 4. Kapferer Brand Identity Prism++| Facet | Content |+|---|---|+| **Physique** (visible, tangible brand attributes) | |+| **Personality** (character if the brand were a person) | |+| **Culture** (values and principles behind the brand) | |+| **Relationship** (how the brand relates to clients) | |+| **Reflection** (how clients see themselves using this brand) | |+| **Self-image** (how clients feel inside when using this brand) | |++---++## 5. Voice & Tone summary (from Module 50)++> **Voice statement (one paragraph):**++> **The three checks every draft must pass:**+> 1.+> 2.+> 3.++---++## 6. Narrative assets (from Module 60)++> **Trueline:**++> **Brand story arc (one paragraph, usable as an About page starting point):**++---++## 7. Founder / organisation brand boundary (from Module 70)++> **What the founder brand owns:**++> **What the organisation brand owns:**++---++## 8. Tensions resolved (record any module-to-module conflicts and how they were settled)++| Tension | Module A | Module B | Resolution |+|---|---|---|---|+| | | | |++---++## 9. Open questions deferred to next session++<!-- Anything that couldn't be resolved with the current data. -->++---++## 10. Practical next steps++<!-- 3–5 concrete actions the brand can take based on this brandbook. -->++1.+2.+3.diff --git a/skills/competitive-platform-analysis/SKILL.md b/skills/competitive-platform-analysis/SKILL.mdnew file mode 100644index 000000000..97633807b--- /dev/null+++ b/skills/competitive-platform-analysis/SKILL.md@@ -0,0 +1,181 @@+---+name: competitive-platform-analysis+description: >-+ Use when scoping a competitive landscape — identifying, categorising, and+ score-filtering a competitor set before any benchmarking begins. Decides who+ 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++Use this skill to decide **who to benchmark** and **where to find them** before+any scoring begins. A competitive analysis is only as good as its frame: the+wrong set makes the client look either unbeatable or doomed. The goal is a+defensible, decision-relevant set — not an exhaustive census.++## When to Activate++- About to start a competitive benchmarking project and need to define the competitor set first.+- Unsure which companies belong in Direct / Adjacent / Aspirational tiers.+- Need a defensible, pruned scope for a market landscape report.+- Has a positioning brief and wants to identify who contests that position.+- First step before running benchmark-methodology.++## Client positioning brief (establish first)++Before scoping the set, establish the client's positioning brief. If you don't+already have it, run a short brand-discovery interview to elicit it — do **not**+invent one and do **not** scope the set blind. The brief supplies:++- **Identity / aesthetic register** — what kind of studio or company this is and+ how it presents itself.+- **Offer** — what services or products it delivers.+- **Target clients** — who it sells to.+- **Differentiator** — the moat or positioning argument the client believes in.+- **Scoping consequence** — the implication for how to weight competitors (e.g.,+ prioritize by distinctiveness vs. capability overlap vs. price).+- **Strategic tension** — the paired axes that define the client's white-space+ (e.g., memorability × hireability).++**Do not proceed without the positioning brief.** A competitor list scoped+without the client's lens is noise, not intelligence. The scoping consequence in+particular determines which competitors are *strong* rivals (those that contest+the client's moat) vs. merely overlapping on service menu.++## Selection criteria++For each candidate, capture these axes — they decide both inclusion and tier:++- **Size / model** — solo, micro-studio (2–8), boutique (sub-30), mid-size+ agency. Match the client's own band; same-band studios are the realistic+ head-to-head set.+- **Niche / specialization** — how closely the candidate's focus overlaps with+ the client's offer. Tighter overlap = more direct.+- **Geography / market** — EU vs US vs global-remote; language; time-zone reach.+ Note whether they win the same clients the client targets.+- **Pricing & engagement model** — productized sprints, retainer, project,+ day-rate; transparent vs "contact us". Signals positioning maturity.+- **Portfolio style** — generic vs. opinionated/editorial vs. contrarian. Closer+ to the client's aesthetic register = more they contest the client's+ distinctiveness.+- **Technical depth / craft maturity** — relevant if the client's credibility+ story includes public process work, open tooling, or documented systems.+- **Brand strength** — does the studio have an ownable verbal/visual identity, or+ is it interchangeable? Weight this per the client's scoping consequence.++## Player taxonomy — axes to populate across++Don't sort competitors into niche-specific buckets; sort them along a few+generic axes so the landscape isn't skewed toward one archetype. These axes+apply to any creative-service market (design, motion, copywriting, branding,+content, film, etc.). Aim for breadth across each axis first, then prune to the+most instructive.++1. **Positioning stance** — *brand-led / editorial* (competes on identity,+ voice, POV) vs *capability-led* (competes on craft, throughput, outcomes).+ Populate both poles; the client's closest mirror sits at its own end.+2. **Specialization** — *specialist* (one tight discipline or vertical) vs+ *generalist* (broad service menu). Tighter overlap with the client's focus =+ more direct.+3. **Size / model** — *solo / micro* vs *boutique* vs *mid-size* vs+ *enterprise-scale*. Same-band players are the realistic head-to-head; larger+ bands are the aspirational/commercial-maturity reference.+4. **Engagement format** — *productized* (named sprints, audits, fixed packages)+ vs *bespoke* (custom project / retainer). Signals positioning maturity.+5. **Distinctiveness posture** — *conventional / safe* vs *contrarian /+ manifesto-driven*. The opinionated end is key for distinctiveness+ benchmarking in any niche.+6. **Evidence / credibility model** — *outcome-led* (metrics, named clients,+ case depth) vs *aesthetic-led* (portfolio, awards). Tells you how each player+ earns trust.+7. **Brand strength of the operator** — *interchangeable* vs *cult / ownable+ identity* (including senior independents who prove the "memorable solo brand"+ model).+8. **Market / reach** — *local / regional* vs *global-remote*; note whether they+ win the same clients the client targets.++Plot each candidate on the relevant axes; a competitor is *direct* when it sits+near the client on positioning, specialization, size, and market at once.++## Competitive tiers (how the set resolves)++Group the final set into three tiers — this structure carries through to the+report:++- **Direct** — same band, overlapping offer, same client targets. The realistic+ head-to-head.+- **Adjacent** — partial overlap (one capability, or a different client size)+ that pressures at the edges.+- **Aspirational** — players the client is not competing with today but whose+ brand or commercial maturity sets the bar to aim at.+- *(Watch also for substitutes:* no-code/AI tools, in-house teams, generalist+ freelancers — note as a threat vector, not a profiled competitor unless+ materially relevant.)*++## Data sources (where to look)++Match the source to the dimension you need. The platform *types* below are+generic; substitute the ones native to the client's niche (e.g. Dribbble/Behance+for design, showreel/Vimeo for motion, writing samples/published work for copy):++- **Portfolio / craft platforms** — craft quality, range, aesthetic register+ (e.g. Dribbble, Behance, Vimeo, or the niche's equivalent showcase).+- **Awards / curated showcases** — craft ambition and editorial recognition;+ over-indexes on flashy, so cross-check commercial credibility (e.g. Awwwards,+ industry award lists).+- **Competitor's own site** — primary source for positioning, voice, offer+ packaging, pricing posture, named clients, manifesto/POV.+- **LinkedIn** — team size/model, founder narrative, post cadence, client logos,+ geography.+- **Review directories** — reviews, named clients, project sizes, engagement+ models; strongest signal for commercial credibility and enterprise-readiness+ (e.g. Clutch.co or the niche's equivalent).+- **Open / public work** — process repos, published samples, open creative+ output: depth and craft-transparency evidence.+- **Conference talks / podcasts / newsletters** — thought-leadership depth and+ POV ownership.++Always **verify claims across at least two sources** before treating a competitor+attribute as fact (self-reported site copy ≠ verified outcome). Carry an+adversarial-verification discipline into every profile.++## Scoring matrix template (selection stage)++A lightweight pre-filter to decide who graduates into full benchmarking. Score+1–5; keep candidates that score high on **either** distinctiveness **or**+credibility — the client's strategic tension means both poles are instructive.++| Candidate | Positioning stance | Specialization | Size band | Tier | Offer overlap (1–5) | Distinctiveness (1–5) | Commercial credibility (1–5) | Craft proximity (1–5) | Include? |+|-----------|--------------------|----------------|-----------|------|---------------------|------------------------|------------------------------|------------------------|----------|++Rules of thumb (apply per the client's scoping consequence in the positioning brief):++- High distinctiveness **and** high credibility → must-profile (proves the+ client's target tension is achievable).+- High distinctiveness, low credibility → cautionary case (memorable but+ un-hireable — a potential failure mode to learn from).+- High credibility, low distinctiveness → "competent but forgettable" mass the+ client defines itself against.+- Low on both → drop unless needed for landscape breadth.++## Output of this stage++A scoped, tiered competitor set (typically 10–18 candidates → 8–12 profiled),+each tagged with its axis positions, tier, and source links, ready to hand to+`benchmark-methodology`.++## Anti-Patterns++- **Scoping without a positioning brief.** A competitor list built without the client's lens is noise. The brief determines what counts as a real rival.+- **Listing every similar company.** The goal is a defensible 10–18 candidate set, not a census. Breadth without pruning makes benchmarking unmanageable.+- **Blurring the Direct/Adjacent/Aspirational tiers.** These tiers serve different strategic purposes. Mixing them produces a flat list that can't drive decisions.+- **Relying on a single source per competitor.** Self-reported site copy is marketing, not fact. Verify attributes across at least two sources.+- **Jumping straight to scoring.** This skill scopes and tiers the set. Benchmark-methodology handles scoring. Don't conflate the two steps.++## Related Skills++- `brand-discovery` — use first to establish the positioning brief and strategic tension that scopes the competitor set.+- `benchmark-methodology` — the next step; takes the tiered set and scores each competitor across nine dimensions.diff --git a/skills/competitive-report-structure/SKILL.md b/skills/competitive-report-structure/SKILL.mdnew file mode 100644index 000000000..cc81a0785--- /dev/null+++ b/skills/competitive-report-structure/SKILL.md@@ -0,0 +1,160 @@+---+name: competitive-report-structure+description: >-+ Use after benchmark-methodology has produced scored competitor profile cards.+ Assembles findings into a decision-grade report: landscape map, competitor+ 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++Use this skill to assemble scored competitor cards into a decision-grade report.+The report must answer three questions for the client: **who do we compete with,+how do we compete, and where is our defensible white-space?** Every section+earns its place by moving toward those answers — cut anything that doesn't.++## When to Activate++- All competitor profile cards from benchmark-methodology are complete and ready to assemble.+- Need to present competitive findings to a founder, leadership team, or board.+- The report must drive decisions (who to compete with, how, where the moat is) — not just document the landscape.+- Preparing a client deliverable that must be auditable and defensible.++## Client positioning brief (establish first)++Before assembling the report, establish the client's positioning brief. It+supplies:++- **Strategic tension** — the paired axes (e.g., memorability × hireability)+ that define the client's target white-space. All maps and synthesis resolve+ back to this tension.+- **Brand balance** — the intended proportional mix of the client's strategic+ emphases (e.g., 60% strategy/evidence, 25% distinctiveness, 15% craft).+ Every recommendation must be checked against this balance; flag any that+ would shift it.+- **Differentiator** — the framing principle for the executive summary and+ white-space section.+- **Target quadrant** — where the client intends to sit in the tension map;+ confirming whether that quadrant is genuinely open is the report's central+ empirical question.++## Framing principle++The whole report is organized around the client's strategic tension and+recommendations resolve back to the client's deliberate brand balance.+Recommendations that would break that balance must be flagged against it+explicitly — "this move shifts the balance from X/Y/Z toward A/B/C; confirm+intent."++## Report sections++### 1. Executive summary+3–5 takeaways, decision-first. State the most important findings in plain+language: where the client is strong, where it's exposed, who occupies its+target white-space, and the top 2–3 moves. Written so a founder/PM reads only+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+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+empty) it is.++### 3. Competitor tiers+Organize the set into **Direct / Adjacent / Aspirational** (from+`competitive-platform-analysis`). One short paragraph per tier explaining who's+in it and why it matters to the client. This sets reader expectations before+the detail.++### 4. Benchmarking matrix+The full **competitors × dimensions** table — the quantitative spine. Rows =+competitors (grouped by tier), columns = the nine dimensions. Include the+client's own honest self-assessment as a row for contrast. Use a **heatmap**+(color or symbol scale) so strength/weakness patterns are scannable. Do **not**+add a blended total column — report dimensions separately (per the bias+controls). Call out the columns where the client leads and where it trails.++### 5. Deep dives+3–5 most instructive competitors in narrative form (from their profile cards).+Choose for instruction, not ranking: the best exemplar of the target tension+(high on both poles), the cautionary "one pole only" case, the "competent but+forgettable" archetype the client defines against, plus any direct threat. Each+deep dive: what they do, what the client should learn, what the client should+avoid.++### 6. White-space & threats+The strategic heart. Two parts:++- **White-space:** the position the client can own that rivals don't — argued+ from the maps and matrix, not asserted. Confirm whether the target quadrant+ (from the positioning brief) is genuinely open.+- **Threats:** who/what pressures the client — a rival closing the gap,+ substitutes (no-code/AI tools, in-house teams, generalist freelancers), or+ category shifts. Be honest about the client's own risks (e.g., a bold identity+ reading as un-serious to risk-averse buyers).++### 7. Strategic recommendations+Concrete, prioritized moves: who the client competes with, how it differentiates,+and where to invest (offer packaging, evidence/case studies, thought leadership,+brand sharpening). **Tie every recommendation back to the brand balance from the+positioning brief** and flag any that would shift it. Sequence by impact ×+effort.++### 8. Sources / methodology appendix+The dimensions, weights, rubrics, the scoped set with tiers, source links per+competitor, and verification notes (asserted vs proven). This is what makes the+report auditable and defensible — carry the adversarial citation discipline+through.++## How to present data++- **2×2 / positioning maps** — for landscape and the tension plot. Lead with+ these; they carry the argument faster than prose.+- **Heatmap matrix** — for the competitors × dimensions comparison (section 4).+- **Profile cards** — the source unit feeding deep dives (section 5).+- **Quadrant callouts** — name who sits in each quadrant explicitly, especially+ the client's target one.+- Keep tables scannable; push raw evidence and links to the appendix.++## Decision framework (the report must resolve these)++- **Who do we compete with?** — Name the Direct tier specifically; that's the+ real fight.+- **How do we compete?** — State the client's differentiator in one sentence,+ grounded in the matrix (which dimensions the client owns).+- **Where are our differentiators defensible?** — Identify the+ dimensions/quadrant rivals can't easily copy (the moat), vs. the ones that+ are table-stakes.++## Trigger questions for the team alignment session++End with questions that force decisions, not admiration of the analysis:++- Is the target quadrant truly open, or is a rival already moving in?+- Which Direct competitor is the sharpest threat in the next 12 months, and+ what's the counter?+- Does the brand balance still hold given the landscape — should any emphasis+ shift?+- Which dimension where the client trails is worth closing, and which to+ deliberately concede?+- What's the one move that most widens distinctiveness *without* costing+ hireability / credibility?++## Anti-Patterns++- **Leading with methodology.** The executive summary opens with the most important finding, not an explanation of how the benchmark was run. Methodology belongs in the appendix.+- **Presenting scores without the tension plot.** The 2×2 tension map is the headline artefact. A table of numbers without the map buries the strategic insight.+- **Omitting the decision framework.** The report must resolve the three questions (who to compete with, how, where the moat is). Leaving these unanswered turns the report into a literature review.+- **Starting before all profile cards are complete.** Benchmark-methodology must finish before assembly begins. Partial data produces gaps that undermine the heatmap and white-space analysis.+- **Adding a blended total column to the matrix.** Explicitly excluded — it creates a false composite that obscures the asymmetry the client needs to act on.++## Related Skills++- `benchmark-methodology` — the prerequisite; produces the scored competitor profile cards this skill assembles.+- `competitive-platform-analysis` — provides the tier structure (Direct / Adjacent / Aspirational) used in Section 3.+- `brand-discovery` — use to establish the client's positioning brief if it hasn't been defined.