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.