get-shit-pretty 0.7.0 → 0.7.3

package/gsp/{agents/gsp-creative-director.md → skills/gsp-brand-identity/methodology/gsp-brand-creative-director.md}

@@ -1,12 +1,3 @@
----
-name: gsp-creative-director
-description: Creative director — makes visual identity decisions (logo, color, typography, imagery). Domain skills enrich with technical precision. Spawned by /gsp-brand-identity.
-tools: Read, Write, Edit, Bash, Grep, Glob, WebFetch
-maxTurns: 30
-permissionMode: acceptEdits
-color: magenta
----
-
 <role>
 You are a GSP creative director spawned by `/gsp-brand-identity`.
 

package/gsp/skills/gsp-brand-refine/SKILL.md

@@ -2,7 +2,6 @@
 name: gsp-brand-refine
 description: Targeted brand adjustments mid-project — tweak colors, typography, or spacing without re-running the full branding diamond
 user-invocable: true
-model: sonnet
 allowed-tools:
   - Read
   - Write

package/gsp/skills/gsp-brand-research/SKILL.md

@@ -2,8 +2,6 @@
 name: gsp-brand-research
 description: Research your market and competitors
 user-invocable: true
-model: sonnet
-effort: high
 allowed-tools:
   - Read
   - Write
@@ -22,15 +20,9 @@ Research market context that will inform brand strategy.
 
 **Input:** `.design/branding/{brand}/BRIEF.md`
 **Output:** `.design/branding/{brand}/discover/` (4 chunks + INDEX.md)
-**Agent:** `gsp-researcher`
+**Agent:** `gsp-brand-researcher`
 </objective>
 
-<execution_context>
-@${CLAUDE_SKILL_DIR}/../../templates/phases/discover.md
-@${CLAUDE_SKILL_DIR}/design-trends.md (index only — agent loads specific trend files only after open research validates relevance)
-@${CLAUDE_SKILL_DIR}/../gsp-style/styles/INDEX.yml
-</execution_context>
-
 <rules>
 - Always use `AskUserQuestion` for user-facing questions — never raw text prompts
 - One decision per question — never batch multiple questions in a single message
@@ -60,15 +52,23 @@ While preparing the agent context, use `WebFetch` with `run_in_background: true`
 
 ## Step 3: Spawn researcher
 
+### Load references and agent methodology
+Read these files and hold their content for inlining into the agent prompt:
+- `${CLAUDE_SKILL_DIR}/../../templates/phases/discover.md` — discover output template
+- `${CLAUDE_SKILL_DIR}/design-trends.md` — design trends index (agent loads specific trend files only after open research validates relevance)
+- `${CLAUDE_SKILL_DIR}/../gsp-style/styles/INDEX.yml` — style presets index
+- `${CLAUDE_SKILL_DIR}/methodology/gsp-brand-researcher.md` — agent methodology
+
 Include any pre-fetched competitor content in the agent context.
 
-Spawn the `gsp-researcher` agent with:
+Spawn the `gsp-brand-researcher` agent with:
 - BRIEF.md content
-- Discover output template
-- Design trends index (reference only — agent loads specific trend files only after open research validates them)
-- Style presets index (`INDEX.yml`) — agent matches research findings to existing aesthetics
+- **Content of** discover output template (loaded above)
+- **Content of** design trends index (loaded above — reference only, agent loads specific trend files only after open research validates them)
+- **Content of** style presets index (loaded above) — agent matches research findings to existing aesthetics
 - User-confirmed scope adjustments
 - `brand_mode` from config.json
+- **Agent methodology** (loaded above)
 - Audit chunks if they exist
 - **Output path:** `{BRAND_PATH}/discover/`
 

package/gsp/{agents/gsp-researcher.md → skills/gsp-brand-research/methodology/gsp-brand-researcher.md}

@@ -1,13 +1,3 @@
----
-name: gsp-researcher
-description: Researches market landscape and competitive positioning. Spawned by /gsp-brand-research.
-tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch
-disallowedTools: Edit
-maxTurns: 50
-permissionMode: acceptEdits
-color: magenta
----
-
 <role>
 You are a GSP design researcher spawned by `/gsp-brand-research`.
 

package/gsp/skills/gsp-brand-strategy/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: gsp-brand-strategy
-description: Define positioning, voice, and messaging
+description: Define positioning, voice, and messaging (creative phase — benefits from capable models)
 user-invocable: true
-model: opus
-effort: high
 allowed-tools:
   - Read
   - Write
@@ -25,13 +23,6 @@ Define brand strategy and voice through interactive creative direction, then pro
 **Agent:** `gsp-brand-strategist`
 </objective>
 
-<execution_context>
-@${CLAUDE_SKILL_DIR}/../../templates/phases/strategy.md
-@${CLAUDE_SKILL_DIR}/brand-archetypes.md
-@${CLAUDE_SKILL_DIR}/positioning-frameworks.md
-@${CLAUDE_SKILL_DIR}/voice-tone.md
-</execution_context>
-
 <rules>
 - Always use `AskUserQuestion` for user-facing questions — never raw text prompts
 - One decision per question — never batch multiple questions in a single message
@@ -103,14 +94,23 @@ If the Style Affinity section doesn't exist or discover was skipped, skip this s
 
 ## Step 6: Spawn strategist
 
+### Load references and agent methodology
+Read these files and hold their content for inlining into the agent prompt:
+- `${CLAUDE_SKILL_DIR}/../../templates/phases/strategy.md` — strategy output template
+- `${CLAUDE_SKILL_DIR}/brand-archetypes.md` — brand archetypes reference
+- `${CLAUDE_SKILL_DIR}/positioning-frameworks.md` — positioning frameworks reference
+- `${CLAUDE_SKILL_DIR}/voice-tone.md` — voice-tone reference
+- `${CLAUDE_SKILL_DIR}/methodology/gsp-brand-strategist.md` — agent methodology
+
 With confirmed archetype, positioning, and voice direction, spawn the `gsp-brand-strategist` agent with:
 - BRIEF.md content
 - All discover chunks
 - Confirmed archetype, positioning, voice direction
-- Strategy output template
-- Brand archetypes reference
-- Positioning frameworks reference
-- Voice-tone reference
+- **Content of** strategy output template (loaded above)
+- **Content of** brand archetypes reference (loaded above)
+- **Content of** positioning frameworks reference (loaded above)
+- **Content of** voice-tone reference (loaded above)
+- **Agent methodology** (loaded above)
 - Audit chunks if they exist: `evolution-map.md`, `equity-analysis.md`
 - `brand_mode` from config.json
 - `style_base` from config.json (may be empty)

package/gsp/skills/gsp-brand-strategy/methodology/gsp-brand-strategist.md

@@ -0,0 +1,65 @@
+<role>
+You are a GSP brand strategist spawned by `/gsp-brand-strategy`.
+
+Act as Head of Strategy at a top branding agency. Define the strategic foundation — positioning, archetype, platform, voice, and messaging — that the visual identity will be built on.
+
+</role>
+
+<inputs>
+- BRIEF.md content (business, personas, brand essence, competitive landscape)
+- All 4 discover chunks
+- Audit chunks (if exist): evolution-map.md, equity-analysis.md
+- User-confirmed archetype, positioning, and voice direction
+- brand_mode from config.json
+- style_base from config.json (array of preset slugs, may be empty)
+- Output path
+</inputs>
+
+<methodology>
+1. **Absorb context** — BRIEF.md for business/personas/essence, discover chunks for market/competition
+2. **Define positioning** — 2-axis map, plot competitors, claim white space. Statement formula: "For {audience} who {need}, {brand} is the {category} that {benefit} because {reason}"
+3. **Lock archetype** — primary + secondary from 12 Jungian archetypes. Justify with persona alignment and competitive gaps. Note shadow traits. If `style_base` is set, note the style direction in the visual tendencies section — connect the preset's character to the archetype (e.g. "The Sage archetype's clarity aligns with swiss-minimalist's structured restraint").
+4. **Build platform** — Purpose (Why), Vision, Mission, Values, Promise. Each must be specific and ownable.
+5. **Define voice** — 3-5 attributes with means/doesn't mean/examples. Map tone spectrum with context shifts. Include style rules.
+6. **Build messaging** — core message → 3 supporting messages with proof points → elevator pitch → tagline directions → audience-segment mapping
+
+## Quality Standards
+- Archetype must align with persona needs and competitive gaps
+- Positioning axes must matter to the target audience
+- Values must be behavioral (actionable), not aspirational platitudes
+- Voice attributes must be specific enough that two writers produce similar-sounding content
+- Messaging must trace back to persona frustrations and aspirations from BRIEF.md
+</methodology>
+
+<references>
+- `references/brand-archetypes.md` — 12 archetypes with traits, shadows, visual tendencies
+- `references/positioning-frameworks.md` — positioning maps, brand pyramid
+- `references/voice-tone.md` — voice attribute framework, tone spectrum, messaging matrix
+</references>
+
+<output>
+Write 5 chunks + INDEX.md to the strategy directory (path provided by the skill that spawned you).
+
+Each chunk follows the standard chunk format.
+
+1. **`positioning.md`** — positioning statement + 2-axis map with competitors plotted + white space analysis
+2. **`archetype.md`** — primary + secondary archetype, rationale, shadow traits, communication style, visual tendencies
+3. **`brand-platform.md`** — Purpose (Why), Vision, Mission, Values, Promise
+4. **`voice-and-tone.md`** — voice attributes (means/doesn't mean/examples), tone spectrum (scales + context shifts), do/don't chart, style rules, nomenclature
+5. **`messaging.md`** — core message, 3 supporting messages with proof points, elevator pitch, 2-3 tagline directions, audience-segment mapping per persona
+
+### INDEX.md
+
+```markdown
+# Strategy
+> Phase: strategy | Brand: {name} | Generated: {DATE}
+
+| Chunk | File | ~Lines |
+|-------|------|--------|
+| Positioning | [positioning.md](./positioning.md) | ~{N} |
+| Archetype | [archetype.md](./archetype.md) | ~{N} |
+| Brand Platform | [brand-platform.md](./brand-platform.md) | ~{N} |
+| Voice & Tone | [voice-and-tone.md](./voice-and-tone.md) | ~{N} |
+| Messaging | [messaging.md](./messaging.md) | ~{N} |
+```
+</output>

package/gsp/skills/gsp-brand-sync/SKILL.md

@@ -2,14 +2,11 @@
 name: gsp-brand-sync
 description: Sync brand to match a project's shipped state — tokens, voice, visual patterns, personality
 user-invocable: true
-model: opus
-effort: high
 allowed-tools:
   - Read
   - Write
   - Edit
   - Bash
-  - Agent
   - Glob
   - Grep
   - AskUserQuestion
@@ -29,7 +26,6 @@ Compare a project's shipped state against its source brand across all dimensions
 
 **Input:** A project with a linked brand (via project config or `.design/branding/`)
 **Output:** Updated brand tokens, strategy chunks, identity chunks, and style preset (as applicable)
-**Agent:** `gsp-brand-syncer`
 </objective>
 
 <execution_context>
@@ -53,18 +49,72 @@ Check that the brand has at least one of: `patterns/{brand-name}.yml`, `strategy
 
 Verify the project codebase has shipped output — source files with components, copy, or styles.
 
-## Step 1: Spawn syncer agent
+## Step 1: Analyze divergences
 
 ```bash
 mkdir -p {BRAND_PATH}/sync
 ```
 
-Spawn the `gsp-brand-syncer` agent with:
-- `BRAND_PATH` and all available brand files ({brand-name}.yml, strategy chunks, identity chunks, foundation chunks)
-- Project codebase location (working directory)
-- **Output path:** `{BRAND_PATH}/sync/`
+Run 4-dimension analysis directly. Read brand files first: `{BRAND_PATH}/patterns/{brand-name}.yml`, strategy chunks, identity chunks.
 
-The agent writes `SYNC-REPORT.md` with divergences across four dimensions: tokens, voice & tone, visual patterns, personality. Each divergence includes evidence (file paths, line numbers, before/after values).
+### Dimension 1: Token diff (quantitative)
+
+Grep for token values in: `tailwind.config.*` (`theme.extend`), CSS custom properties in globals/variables/theme CSS, theme/token JS/TS files, hardcoded values in components. Compare each against brand `.yml`. Classify: **Changed** (value differs), **Added** (in project, not brand), **Removed** (in brand, not project). Skip equivalents and framework defaults.
+
+### Dimension 2: Voice & tone (qualitative)
+
+Read `{BRAND_PATH}/strategy/voice-and-tone.md` for attributes and tone spectrum. Grep project for user-facing strings — headings, button labels, error states, tooltips, onboarding, meta content. Sample 10-15 representative strings. Assess each voice attribute: does copy match? Note drift direction ("more casual", "more technical"). Flag new patterns not in spec.
+
+### Dimension 3: Visual patterns (qualitative)
+
+Read brand foundations and identity chunks. Glob/Grep components for layout patterns, component styling (radius, shadow, states), color application, typography hierarchy, imagery, motion. Classify each: **Aligned**, **Evolved** (refined), **Drifted** (diverged), **New** (not in brand).
+
+### Dimension 4: Personality (qualitative)
+
+Read `{BRAND_PATH}/strategy/archetype.md` and `positioning.md`. Assess holistically: does the product feel like the archetype? Has positioning shifted? Are shadow traits showing? Classify: **On-brand**, **Shifted** (name direction), **Stronger**. Connect evidence from dimensions 1-3.
+
+### Quality standards
+
+- Token divergences: exact values (brand vs project)
+- Voice/visual assessments: cite file:line evidence
+- Personality: connect to specific patterns from other dimensions
+- Only flag genuine divergences, not noise
+
+### Write report
+
+Write `SYNC-REPORT.md` to `{BRAND_PATH}/sync/` with this structure:
+
+```markdown
+# Brand Sync Report
+> Brand: {name} | Project: {directory} | Generated: {DATE}
+
+## Tokens
+| Token | Brand Value | Project Value | Status |
+|-------|------------|---------------|--------|
+
+**Summary:** {N} changed · {N} added · {N} removed
+
+## Voice & Tone
+### Divergences
+- **{attribute}** — {aligned|drifted|new}
+  - Brand: "{spec}" | Project: "{reality}" | Direction: {drift}
+  - Evidence: {file:line}
+### Overall: {N}/{N} attributes aligned
+
+## Visual Patterns
+### Divergences
+- **{pattern}** — {aligned|evolved|drifted|new}
+  - Brand: "{spec}" | Project: "{reality}"
+  - Evidence: {file:line}
+
+## Personality
+- **Archetype:** {on-brand|shifted|stronger} — {assessment + evidence}
+- **Positioning:** {holds|shifted} — {assessment if shifted}
+
+## Update Map
+| Dimension | File to Update | Change |
+|-----------|---------------|--------|
+```
 
 ## Step 2: Present findings
 

package/gsp/skills/gsp-color/SKILL.md

@@ -2,7 +2,6 @@
 name: gsp-color
 description: "Design color systems — palettes, contrast, semantic mapping, dark mode"
 user-invocable: true
-model: sonnet
 allowed-tools:
   - Read
   - Write

package/gsp/skills/gsp-design-system/SKILL.md

@@ -2,7 +2,6 @@
 name: gsp-design-system
 description: Scan and document the existing design system state
 user-invocable: true
-model: sonnet
 allowed-tools:
   - Read
   - Write

package/gsp/skills/gsp-doctor/SKILL.md

@@ -2,7 +2,6 @@
 name: gsp-doctor
 description: Check project health
 user-invocable: true
-model: sonnet
 allowed-tools:
   - Read
   - Glob

package/gsp/skills/gsp-help/SKILL.md

@@ -2,7 +2,6 @@
 name: gsp-help
 description: Show all skills
 user-invocable: true
-model: sonnet
 ---
 <objective>
 Display the complete GSP skill reference as plain text.
@@ -38,10 +37,11 @@ Skill names are left-padded with 4 spaces. Descriptions start at column 27 (4 in
 
   ─── Branding ─────────────────────────
 
+    /gsp-brand-brief       define your brand through guided Q&A
     /gsp-brand-research    research your market and audience
     /gsp-brand-strategy    define positioning, personality, voice and messaging
     /gsp-brand-identity    create visual identity
-    /gsp-brand-guidelines    build design system tokens and components
+    /gsp-brand-guidelines  build design system tokens and components
     /gsp-brand-sync        sync brand to match a project's shipped state
     /gsp-brand-refine      tweak brand tokens mid-project without re-running identity
     /gsp-brand-audit       audit existing brand before evolving (optional)
@@ -61,14 +61,17 @@ Skill names are left-padded with 4 spaces. Descriptions start at column 27 (4 in
     /gsp-color             color systems — palettes, contrast, semantic mapping, dark mode
     /gsp-typography        type systems — scale, pairing, fluid type, vertical rhythm
     /gsp-visuals           visual direction — imagery, 3D, video, textures
-    /gsp-accessibility     accessibility audit — contrast, WCAG, code checks
+    /gsp-icons             icon systems — library, sizing, containers, custom SVG
+    /gsp-logo              logo directions — concepts, variations, usage rules
+    /gsp-accessibility     contrast checks and token WCAG audits
     /gsp-style             apply a design style preset
 
   ─── Utilities ────────────────────────
 
+    /gsp-design-system     scan and document existing design system state
+    /gsp-scaffold          deterministic stack setup — deps, configs, verify build
     /gsp-doctor            check project health
     /gsp-update            update GSP to latest version
-    /gsp-launch            create launch and marketing assets (optional)
 
   ─── Easter Eggs ────────────────────
 
@@ -81,7 +84,7 @@ Skill names are left-padded with 4 spaces. Descriptions start at column 27 (4 in
     — or —
     quick mode: pick a style → jump straight to project.
 
-    branding   research → strategy → identity → patterns
+    branding   brief → research → strategy → identity → guidelines
     project    brief → research → design → critique → build → review
                                     ↑                    ↑
                               critique loop         QA loop
@@ -100,7 +103,7 @@ Skill names are left-padded with 4 spaces. Descriptions start at column 27 (4 in
     │       ├── discover/         research chunks
     │       ├── strategy/         strategy + voice and messaging
     │       ├── identity/         visual identity
-    │       └── patterns/         tokens + components
+    │       └── system/           tokens + components
     └── projects/
         └── {project}/
             ├── config.json       project config
@@ -116,7 +119,7 @@ Skill names are left-padded with 4 spaces. Descriptions start at column 27 (4 in
             └── exports/INDEX.md  chunk index
 
   get-shit-pretty v{VERSION}
-  github.com/juliuslipp/get-shit-pretty
+  github.com/jubscodes/get-shit-pretty
 ```
 
 Replace `{VERSION}` with the value read from the VERSION file.

package/gsp/skills/gsp-icons/SKILL.md

@@ -2,7 +2,6 @@
 name: gsp-icons
 description: Design icon systems — library selection, sizing, containers, custom SVG direction
 user-invocable: true
-model: sonnet
 allowed-tools:
   - Read
   - Write

package/gsp/skills/gsp-logo/SKILL.md

@@ -2,7 +2,6 @@
 name: gsp-logo
 description: Design logo directions — concepts, variations, usage rules, and clear space
 user-invocable: true
-model: sonnet
 allowed-tools:
   - Read
   - Write

package/gsp/skills/gsp-phase-transition/SKILL.md

@@ -2,7 +2,6 @@
 name: gsp-phase-transition
 description: "Render phase transition screens — pipeline progress, completion banner, file tree. Invoked by pipeline skills at phase completion."
 user-invocable: false
-model: sonnet
 allowed-tools:
   - Read
   - Glob
@@ -65,7 +64,6 @@ If audit phase exists (evolve mode), prepend: `audit ─── `
 
 `brief ─── research ─── design ─── critique ─── build ─── review`
 
-If launch is in scope, append: ` ─── launch`
 
 ## Step 3: Completion banner + file tree
 
@@ -116,7 +114,6 @@ If all phases in the pipeline are complete, add `  fully pretty.` after the divi
 | critique | designs critiqued |
 | build | code implemented |
 | review | implementation validated |
-| launch | campaign assets created |
 
 ## Step 4: Return
 

package/gsp/skills/gsp-pretty/SKILL.md

@@ -2,11 +2,10 @@
 name: gsp-pretty
 description: "Surprise ASCII art in the terminal"
 user-invocable: true
-model: sonnet
 allowed-tools:
   - Read
   - Bash
-  - Agent
+  - Write
 ---
 <context>
 Easter egg command. Instantly renders a surprise piece of ASCII/Unicode terminal art. Context-aware — riffs on what the user is working on.
@@ -19,13 +18,12 @@ Surprise the user with a piece of terminal art that's relevant to their current
 
 **Input:** None explicit — you gather context yourself
 **Output:** Rendered art in the terminal
-**Agent:** `gsp-ascii-artist`
 </objective>
 
 <process>
 ## Step 1: Gather context clues
 
-Before spawning the artist, quickly gather signal about what the user is working on. Check 2-3 of these (pick whichever are most likely to yield something interesting):
+Quickly gather signal about what the user is working on. Check 2-3 of these (pick whichever are most likely to yield something interesting):
 
 - `git log --oneline -5` — recent commit messages
 - The project's `package.json` name/description, or `README.md` first lines
@@ -33,29 +31,32 @@ Before spawning the artist, quickly gather signal about what the user is working
 - The current branch name
 - The current date/time and day of week
 
-Don't overthink it — spend 10 seconds gathering, not 10 minutes. You just need a seed for the artist.
+Don't overthink it — spend 10 seconds gathering, not 10 minutes. You just need a seed.
 
 ## Step 2: Create surprise art
 
-Spawn the `gsp-ascii-artist` agent with this prompt, filling in the context you found:
-
-> Freestyle a single piece of terminal art. Medium size (5-15 lines). Render it via `node -e` so the user sees it directly in their terminal.
->
-> **Context from the user's session:**
-> [INSERT 2-3 bullet points of what you found — project name, recent work, current date, etc.]
->
-> **Direction:** Use that context as inspiration, not as a label. Do NOT make art about GSP, branding, or the tool itself. Be witty, culturally aware, and open-minded. The art should feel like a clever aside from someone who's been watching what you're building — not a logo for it.
->
-> Some vibes to riff on (pick one or invent your own):
-> - A tiny scene with a punchline (visual wit)
-> - A metaphor for what the user is working on right now
-> - Something seasonal or timely for today's date
-> - A tribute to a classic (art, music, film, code) that connects to the context
-> - An abstract mood piece — rain, neon, space, dawn
-> - A visual one-liner that makes someone smile
-> - Something completely unexpected
->
-> IMPORTANT: Only create ONE piece. Render it with `node -e` so it displays in the terminal. Then return the console.log() code snippet so the user can reuse it.
+Read `${CLAUDE_SKILL_DIR}/../gsp-art/terminal-art.md` for the full ANSI/Unicode reference if needed.
+
+Freestyle a single piece of terminal art. Medium size (5-15 lines).
+
+**Creative direction:** Use the context as inspiration, not as a label. Do NOT make art about GSP, branding, or the tool itself. Be witty, culturally aware, and open-minded. The art should feel like a clever aside from someone who's been watching what you're building — not a logo for it.
+
+**Vibes to riff on** (pick one or invent your own):
+- A tiny scene with a punchline (visual wit)
+- A metaphor for what the user is working on right now
+- Something seasonal or timely for today's date
+- A tribute to a classic (art, music, film, code) that connects to the context
+- An abstract mood piece — rain, neon, space, dawn
+- A visual one-liner that makes someone smile
+- Something completely unexpected
+
+**Process:**
+1. Pick a technique — gradient bars, scatter/splatter, block text, box frames, shadow/depth, negative space
+2. Draft in plain text first, then add ANSI color (dim for decoration, bold for focal, cyan accents, yellow sparingly, avoid red/green)
+3. Test via `node -e` so the user sees it directly in their terminal
+4. Provide the `console.log()` code snippet so the user can reuse it
+
+**Constraints:** max 80 columns wide, max 25 lines tall, no emoji, always reset ANSI (`\x1b[0m`), readable without color, respect `NO_COLOR`.
 
 ## Step 3: Done
 

package/gsp/skills/gsp-progress/SKILL.md

@@ -2,7 +2,6 @@
 name: gsp-progress
 description: How pretty are we?
 user-invocable: true
-model: sonnet
 allowed-tools:
   - Read
   - Glob

package/gsp/skills/gsp-project-brief/SKILL.md

@@ -2,12 +2,10 @@
 name: gsp-project-brief
 description: Scope what you're building
 user-invocable: true
-model: sonnet
 allowed-tools:
   - Read
   - Write
   - Bash
-  - Agent
   - Grep
   - Glob
 ---
@@ -24,7 +22,6 @@ Scope the project and plan adaptations from the brand system.
 
 **Input:** Brand system (via brand.ref) + project BRIEF.md + config.json
 **Output:** `{project}/brief/` (scope.md, target-adaptations.md, conditionals, INDEX.md)
-**Agent:** `gsp-scoper`
 </objective>
 
 <execution_context>
@@ -77,30 +74,62 @@ Suggest to the user:
 
 If the project scope feels large, suggest breaking it into multiple bounded issues — each one a focused deliverable that can be reviewed independently.
 
-## Step 2: Spawn scoper
+## Step 2: Scope the project
 
-Spawn the `gsp-scoper` agent. **Inline all content** — the agent should not need to read any input files.
-
-Pass in the agent prompt:
-- **Content of** brand patterns foundation + component chunks (loaded in Step 1)
-- **Content of** brand `.yml` preset (loaded in Step 1)
-- **Content of** BRIEF.md (loaded in Step 1)
-- **Content of** `.design/system/STACK.md`, `COMPONENTS.md` (when loaded in Step 1)
-- **Content of** CHANGELOG.md + relevant MANIFEST.md files (loaded in Step 1)
-- Brief output template (from execution_context)
-- `implementation_target`, `design_scope`, `codebase_type`
-- **Output path:** `{PROJECT_PATH}/brief/`
+Using all context loaded in Step 1, scope the project directly. Act as a Senior Design Project Lead bridging the brand system and the project's specific needs.
 
 If any sibling project is active and its scope overlaps with this project, flag it: "⚠️ {name} is actively working on {scope}. Coordinate to avoid conflicts."
 If this project modifies components from a sibling's manifest, note provenance.
 
-The agent writes chunks directly:
-- `brief/scope.md`
-- `brief/target-adaptations.md`
-- `brief/install-manifest.md` (shadcn/rn-reusables)
-- `brief/gap-analysis.md` (existing target)
-- `brief/file-references.md` (existing target)
-- `brief/INDEX.md`
+### Scoping process
+
+1. **Analyze brief** — what's being built, for whom, on what platforms
+2. **Define screen list** — prioritized screens from brief, user flows, success criteria
+3. **Map component scope** — which brand system components this project needs
+4. **Identify adaptations** — project-specific variants, overrides, or extensions to brand components
+5. **Map to implementation target** — connect design components to target primitives (shadcn, rn-reusables, existing, code)
+6. **Gap analysis** (existing codebases) — what's in the brand system but missing from the codebase
+7. **Generate install manifest** (shadcn/rn-reusables) — install commands for needed components
+8. **Issue framing** — suggest how to break the project into bounded, shippable issues
+
+### Quality standards
+
+- Every screen has a clear purpose and priority level
+- Component adaptations reference specific brand system components
+- Gap analysis is concrete (component names, token names)
+- Install manifests are copy-paste ready
+- Scope boundaries are explicit (what's in, what's out)
+
+### Write chunks to `{PROJECT_PATH}/brief/`
+
+Use the brief output template from execution_context for chunk formatting.
+
+1. **`scope.md`** (~80-120 lines) — prioritized screen list, component scope, project boundaries, success criteria, dependencies, issue framing
+2. **`target-adaptations.md`** (~60-100 lines) — token overrides, component adaptations, platform considerations, implementation target mapping
+3. **`install-manifest.md`** (shadcn/rn-reusables only) — install commands for all needed components
+4. **`gap-analysis.md`** (existing target only) — components/tokens in brand system but not in codebase
+5. **`file-references.md`** (existing target only) — paths to existing components/tokens being used
+
+Cross-references: `target-adaptations.md` links to `{BRAND_PATH}/patterns/components/{name}.md`; `gap-analysis.md` links to brand system components and tokens; `scope.md` references the project BRIEF.md.
+
+### Write `INDEX.md`
+
+```markdown
+# Brief
+> Phase: brief | Project: {name} | Generated: {DATE}
+
+## Scoping
+
+| Chunk | File | ~Lines |
+|-------|------|--------|
+| Scope | [scope.md](./scope.md) | ~{N} |
+| Target Adaptations | [target-adaptations.md](./target-adaptations.md) | ~{N} |
+| Install Manifest | [install-manifest.md](./install-manifest.md) | ~{N} |
+| Gap Analysis | [gap-analysis.md](./gap-analysis.md) | ~{N} |
+| File References | [file-references.md](./file-references.md) | ~{N} |
+```
+
+Only include rows for chunks that were actually produced.
 
 ## Step 3: Write exports