title: Wishes
shell: standard

components:
  - type: header
    title: Wishes
    eyebrow: New in v0.4.0
    subtitle: Point kazam at a folder with your real context, let your agent read it, get back a populated YAML. No terminal interviews, no file parsing in kazam.

  - type: section
    eyebrow: The flow
    heading: Scaffold, drop, grant
    components:
      - type: markdown
        body: |
          A **wish** is a workspace template plus the prompt that tells your agent
          how to turn that workspace into a valid kazam YAML. kazam scaffolds the
          workspace and shells out to your agent — it doesn't parse PDFs, chunk
          large files, or do anything the agent is already good at.

      - type: columns
        equal_heights: true
        columns:
          - - type: callout
              variant: info
              title: 1. Make the wish
              body: "`kazam wish deck` with no `wish-deck/` folder present scaffolds one: `questions.md` for structured prompts, `README.md` for what to drop in, and `reference/` with the schema + a worked example (version-matched to the binary)."
          - - type: callout
              variant: info
              title: 2. Add your context
              body: "Fill in any parts of `questions.md` you already know the answer to. Drop your real material into the folder — meeting notes, transcripts, last quarter's deck, PDFs, metrics dumps. Anything the agent can read is fair game."
          - - type: callout
              variant: info
              title: 3. Grant it
              body: "`kazam wish deck` a second time. kazam picks the first agent on your `$PATH` (Claude, Gemini, Codex, OpenCode), runs it from inside the workspace, and writes `deck.yaml`. The agent reads the workspace with its own file tools."

  - type: section
    eyebrow: First wish
    heading: "kazam wish deck"
    components:
      - type: markdown
        body: |
          A 7-slide QBR / strategy-review deck. The agent writes every slide —
          cover, context, wins, challenges, learnings, next, the ask — from
          whatever you drop into the workspace. No placeholder copy.

      - type: code
        language: bash
        code: |
          kazam wish deck                          # 1st run: scaffold wish-deck/
          # …fill in wish-deck/questions.md, drop your context files…
          kazam wish deck                          # 2nd run: grant it
          kazam wish deck --yolo                   # skip the workspace, agent invents everything
          kazam wish deck --yolo "about me"        # YOLO with a topic (agent pulls from context)
          kazam wish deck --agent claude           # force a specific agent
          kazam wish deck --dry-run                # print the grant prompt
          kazam wish deck --stdout                 # portable wish spec (markdown)
          kazam wish deck --out quarterly.yaml     # pick the output path
          kazam wish list                          # see every wish

      - type: callout
        variant: info
        title: 🎲 YOLO mode
        body: "Skip the workspace entirely with `kazam wish deck --yolo`. The agent invents every slide — no questions, no context files, just vibes. Pass an optional topic (`--yolo \"about me\"`, `--yolo \"history of coffee\"`) or leave it bare for a surprise. Great for demos, warm-ups, or when your agent already knows you well enough to write the deck."

  - type: section
    eyebrow: Applications
    heading: First-class in every agent
    components:
      - type: markdown
        body: |
          kazam auto-detects the first agent on your `$PATH` and shells out using
          its native non-interactive mode. No skill installer, no per-agent plugin
          format. Pass `--agent <name>` to force a specific one.

      - type: card_grid
        columns: 2
        cards:
          - title: "Claude Code"
            description: "`claude -p` — best for agents that want to use Read tools on your context."
            color: default
          - title: "Gemini CLI"
            description: "`gemini -p` — Google's CLI, same one-shot prompt shape."
            color: default
          - title: "Codex"
            description: "`codex exec` — OpenAI's Codex CLI, subcommand form."
            color: default
          - title: "OpenCode"
            description: "`opencode run` — SST's open-source agent CLI."
            color: default
          - title: "Any other agent"
            badge:
              label: universal
              color: teal
            description: "`kazam wish deck --dry-run` prints the grant prompt. Paste it into ChatGPT, Cursor, Aider, or any LLM context — point it at the `wish-deck/` folder."
            color: teal

  - type: section
    eyebrow: Roadmap
    heading: Eight wishes in eight weeks
    components:
      - type: markdown
        body: |
          `deck` ships with v0.4.0. One new wish every Friday for the following seven weeks,
          each one the Friday drop for a minor release.

      - type: timeline
        items:
          - name: "W1: deck"
            status: completed
          - name: "W2: brief"
            status: active
          - name: "W3: landing"
            status: upcoming
          - name: "W4: api-ref"
            status: upcoming
          - name: "W5: dashboard"
            status: upcoming
          - name: "W6: post-mortem"
            status: upcoming
          - name: "W7: resume"
            status: upcoming
          - name: "W8: roadmap"
            status: upcoming

      - type: steps
        numbered: true
        items:
          - title: "Week 1 — `kazam wish deck`"
            detail: "QBR / strategy-review deck (7 slides). Ships with v0.4.0."
          - title: "Week 2 — `kazam wish brief`"
            detail: "Incident brief / meeting agenda. Document shell, print-optimized."
          - title: "Week 3 — `kazam wish landing`"
            detail: "Indie-hacker landing page with hero, features, stats, CTA."
          - title: "Week 4 — `kazam wish api-ref`"
            detail: "OpenAPI-style endpoint documentation."
          - title: "Week 5 — `kazam wish dashboard`"
            detail: "Dashboard + `sync.sh` reference script. You own the fetcher; kazam ships zero connectors."
          - title: "Week 6 — `kazam wish post-mortem`"
            detail: "Structured incident post-mortem with timeline, impact, learnings."
          - title: "Week 7 — `kazam wish resume`"
            detail: "Personal CV / resume riff."
          - title: "Week 8 — `kazam wish roadmap`"
            detail: "Public product roadmap with timeline and status."

  - type: section
    eyebrow: Next
    components:
      - type: callout
        variant: info
        title: Next up → Components
        body: Browse the component catalog to see what the rendered output can look like. `kazam agents` prints the full authoring guide — it's also what kazam drops into every wish workspace as `reference/kazam-schema.md`.
