Cps Creative

Tier 1 -- Ideation Mode

Four phases: SCAN -> GENERATE -> SURFACE -> SEED.

SCAN (server-side)

POST /api/projects/current/creative/scan with optional body:

{ "grep_limit": 20, "completion_log_lines": 10 }

Server reads 6 index files, greps TODO/FIXME/HACK/XXX, reads completion log. Returns:

{
  "scan_hits": [
    { "source_category": "index|todo|completion_log|transcript_meta",
      "source_file": "...", "signal": "...", "signal_type": "gap|saturated|sparse|deferred_work|follow_up|deferred|error",
      "entries": ["..."]  // optional, for index categories
    }
  ],
  "summary": {
    "total_hits": 12,
    "by_category": { "index": 6, "todo": 4, "completion_log": 2 },
    "gaps": ["patterns", "ideas"]
  }
}

Session metadata enrichment (Claude-side): Server cannot access MCP session tools. After receiving server scan_hits, optionally call mcp__session_info__list_sessions to scan recent session titles for signal words ("should", "annoying", "keep having to", "what if", "idea", "wish", "broken", "slow", "missing"). Append matches to scan_hits.

Degrade silently if MCP unavailable.

Print one-line summary: "Scan: [N] hits -- [X] gaps, [Y] deferred work, [Z] follow-ups."

Fallback (portal unreachable): Read the 6 index files directly + grep. Session scan + completion log still Claude-side. Significantly more tokens but functional.

GENERATE (LLM judgment)

Read current_constraint and project_goal from portal: GET /api/projects/current/meta.

Process scan_hits into 3-5 candidate ideas using these heuristics in order:

1. Gap-based: "Build/Create/Add [thing that fills the gap]." Prioritize constraint-aligned.
2. Pain-point: "Automate/Improve/Fix [thing]." From pain_point/aspirational signals.
3. Follow-up: "Extend/Complete/Refine [follow-up work]."
4. Deferred-work: "Address/Resolve [TODO description]."
5. Combinatorial: "Combine [Idea A] and [Idea B] into [unified feature]."

Cap at 5. Fill by diversity-first: one per heuristic type, then strongest remaining.

For each candidate assign:

Deduplicate against existing Ideas, Roadmap, and active tasks (from scan_hits entries data). Drop duplicates: same verb + same noun domain.

Rank: exploits > elevates > subordinates. Within tier: diversity tiebreaker, then heuristic order.

SURFACE

Present via AskUserQuestion with multiSelect: true.

Label: "Ideation scan found [N] candidates. Select ideas to capture:"

Options: each candidate as title -- rationale.

SEED

For each selected candidate, invoke cps-capture with bucket: Ideas and source: cps-creative. Capture gate bypass applies.

Tier 2 -- Creative Design

Four phases: CLARIFY -> IDEATE -> DEVELOP -> DELIVER. All LLM judgment -- no portal offload.

CLARIFY

Step 1 -- Deep scan

Run Tier 1 SCAN (portal /creative/scan) to get server-side scan_hits.

Then enrich Claude-side:

• Session transcripts: mcp__session_info__list_sessions + read_transcript for 3-5 recent sessions. Scan for: "we should..." (aspirational), "this is annoying" (pain_point), repeated questions (knowledge_gap), abandoned threads.
• cps-query sweep: If .cps/cps_server.py exists, extract domain keywords from scan_hits and run python .cps/cps_server.py search --query="[keywords]". Cap at 10 hits.

Degrade silently when MCP or CPS runtime unavailable.

Print: "Deep scan: [N] sources -- [X] index, [Y] transcript, [Z] cps-query, [W] structural."

Step 2 -- Problem framings

Generate 3-5 "the problem is..." statements. Each references a different scan source category. Span lenses: user experience, system architecture, knowledge gaps, process friction, scale.

Format: "The problem is that [observation] -- [consequence]."

Step 3 -- Targeted extraction

Ask 1-2 clarifying questions via AskUserQuestion to narrow design space. Select from:

Step 4 -- Convergence

Synthesize into a single "How might we...?" statement referencing current constraint. Must be specific enough to generate two concrete approaches.

IDEATE

Apply four techniques to the HMW statement:

Produce 5-8 raw concepts: title + one-sentence description + source technique.

DEVELOP

Narrow to 2-3 via AskUserQuestion (multi-select from IDEATE output).

For each selected concept, produce:

Ask via AskUserQuestion at design forks.

DELIVER

Present final sketches. Ask via AskUserQuestion:

All writes tagged source: cps-creative -- capture gate bypass.

Degradation

Integration Points