From 67daf2bf17aace4f4f5b8b2ea367b7cdfaf6543e Mon Sep 17 00:00:00 2001 From: Paul Bakaus Date: Sun, 15 Mar 2026 18:34:15 -0700 Subject: [PATCH] Inline context gathering protocol into frontend-design SKILL.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Moves the protocol from a separate reference file directly into frontend-design's main SKILL.md to avoid two-level indirection (skill → frontend-design → reference file) that could cause the AI to miss it. Also fixes leftover "shipping timeline" in the built polish output. Co-Authored-By: Claude Opus 4.6 (1M context) --- .claude/skills/frontend-design/SKILL.md | 20 ++++++++++++++- .../reference/context-gathering.md | 25 ------------------- .claude/skills/polish/SKILL.md | 2 +- source/skills/frontend-design/SKILL.md | 20 ++++++++++++++- .../reference/context-gathering.md | 25 ------------------- 5 files changed, 39 insertions(+), 53 deletions(-) delete mode 100644 .claude/skills/frontend-design/reference/context-gathering.md delete mode 100644 source/skills/frontend-design/reference/context-gathering.md diff --git a/.claude/skills/frontend-design/SKILL.md b/.claude/skills/frontend-design/SKILL.md index aae260b01..ec9f7bd8b 100644 --- a/.claude/skills/frontend-design/SKILL.md +++ b/.claude/skills/frontend-design/SKILL.md @@ -6,7 +6,25 @@ license: Apache 2.0. Based on Anthropic's frontend-design skill. See NOTICE.md f This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices. -→ *Before starting, follow the [context gathering protocol](reference/context-gathering.md) to ensure you have project context.* +## Context Gathering Protocol + +Design skills produce generic output without project context. Follow this protocol to gather what you need before proceeding. + +**Required context** — every design skill needs at minimum: +- **Target audience**: Who uses this product and in what context? +- **Use cases**: What jobs are they trying to get done? +- **Brand personality/tone**: How should the interface feel? + +Individual skills may require additional context — check the skill's preparation section for specifics. + +**Gathering order:** +1. **Check current instructions (instant)**: If your loaded instructions already contain a **Design Context** section with the required information, you have what you need — proceed immediately. +2. **Check .impeccable.md (fast)**: If not in instructions, read `.impeccable.md` from the project root. If it exists and contains the required context, proceed. +3. **Run teach-impeccable (cold start)**: If neither source has context, run the teach-impeccable skill before continuing. It will gather context interactively and persist it to `.impeccable.md` for all future sessions. + +Do NOT proceed with design work until you have confirmed context. + +--- ## Design Direction diff --git a/.claude/skills/frontend-design/reference/context-gathering.md b/.claude/skills/frontend-design/reference/context-gathering.md deleted file mode 100644 index 8f39429e5..000000000 --- a/.claude/skills/frontend-design/reference/context-gathering.md +++ /dev/null @@ -1,25 +0,0 @@ -# Context Gathering Protocol - -Design skills produce generic output without project context. Follow this protocol to gather what you need before proceeding. - -## Required context - -Every design skill needs at minimum: -- **Target audience**: Who uses this product and in what context? -- **Use cases**: What jobs are they trying to get done? -- **Brand personality/tone**: How should the interface feel? - -Individual skills may require additional context — check the skill's preparation section for specifics. - -## Gathering order - -### 1. Check current instructions (instant) -If your loaded instructions already contain a **Design Context** section with the required information, you have what you need — proceed immediately. - -### 2. Check .impeccable.md (fast) -If not in instructions, read `.impeccable.md` from the project root. If it exists and contains the required context, proceed. - -### 3. Run teach-impeccable (cold start) -If neither source has context, run the teach-impeccable skill before continuing. It will gather context interactively and persist it to `.impeccable.md` for all future sessions. - -Do NOT proceed with design work until you have confirmed context. diff --git a/.claude/skills/polish/SKILL.md b/.claude/skills/polish/SKILL.md index 98d8b6250..a09a80346 100644 --- a/.claude/skills/polish/SKILL.md +++ b/.claude/skills/polish/SKILL.md @@ -10,7 +10,7 @@ args: ## MANDATORY PREPARATION -Use the frontend-design skill — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding. Additionally gather: quality bar (MVP vs flagship) and shipping timeline. +Use the frontend-design skill — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding. Additionally gather: quality bar (MVP vs flagship). --- diff --git a/source/skills/frontend-design/SKILL.md b/source/skills/frontend-design/SKILL.md index c1a6d4115..c7f6febd3 100644 --- a/source/skills/frontend-design/SKILL.md +++ b/source/skills/frontend-design/SKILL.md @@ -6,7 +6,25 @@ license: Apache 2.0. Based on Anthropic's frontend-design skill. See NOTICE.md f This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices. -→ *Before starting, follow the [context gathering protocol](reference/context-gathering.md) to ensure you have project context.* +## Context Gathering Protocol + +Design skills produce generic output without project context. Follow this protocol to gather what you need before proceeding. + +**Required context** — every design skill needs at minimum: +- **Target audience**: Who uses this product and in what context? +- **Use cases**: What jobs are they trying to get done? +- **Brand personality/tone**: How should the interface feel? + +Individual skills may require additional context — check the skill's preparation section for specifics. + +**Gathering order:** +1. **Check current instructions (instant)**: If your loaded instructions already contain a **Design Context** section with the required information, you have what you need — proceed immediately. +2. **Check .impeccable.md (fast)**: If not in instructions, read `.impeccable.md` from the project root. If it exists and contains the required context, proceed. +3. **Run teach-impeccable (cold start)**: If neither source has context, run the teach-impeccable skill before continuing. It will gather context interactively and persist it to `.impeccable.md` for all future sessions. + +Do NOT proceed with design work until you have confirmed context. + +--- ## Design Direction diff --git a/source/skills/frontend-design/reference/context-gathering.md b/source/skills/frontend-design/reference/context-gathering.md deleted file mode 100644 index 8f39429e5..000000000 --- a/source/skills/frontend-design/reference/context-gathering.md +++ /dev/null @@ -1,25 +0,0 @@ -# Context Gathering Protocol - -Design skills produce generic output without project context. Follow this protocol to gather what you need before proceeding. - -## Required context - -Every design skill needs at minimum: -- **Target audience**: Who uses this product and in what context? -- **Use cases**: What jobs are they trying to get done? -- **Brand personality/tone**: How should the interface feel? - -Individual skills may require additional context — check the skill's preparation section for specifics. - -## Gathering order - -### 1. Check current instructions (instant) -If your loaded instructions already contain a **Design Context** section with the required information, you have what you need — proceed immediately. - -### 2. Check .impeccable.md (fast) -If not in instructions, read `.impeccable.md` from the project root. If it exists and contains the required context, proceed. - -### 3. Run teach-impeccable (cold start) -If neither source has context, run the teach-impeccable skill before continuing. It will gather context interactively and persist it to `.impeccable.md` for all future sessions. - -Do NOT proceed with design work until you have confirmed context.