Hk Scout Wiki

Scout wave → wiki → ideas (project-agnostic)

Three phases. Phases 1-2 are cheap (haiku); phase 3 needs judgment (sonnet or the main conversation). The wiki is evidence; the ideas are the product.

Phase 0 — Discover the project (once per session)

• Wiki root: existing docs/wiki/ (or wherever a wiki README already

lives). None yet → create docs/wiki/README.md with: a category table, the entry format below, and grep/tag conventions. Never a second format.

• Project context: read the project's CLAUDE.md / roadmap / ideas file to

learn (a) what the system IS in one line, (b) the named areas/buckets/ themes work is organized under, (c) where distilled ideas belong (an IDEAS/BRAINSTORM file, a backlog, or — if none — propose one). If the project defines a writing tone doc, read it and obey it.

Entry format (uniform, always)

# 
source: 
author:   |  fetched:   |  status: read | unreachable
tags: 

**One line.** 

## TL;DR
3-6 plain sentences.

## Key ideas
Self-contained bullets.

## Project hooks
Where this touches THIS project: named areas, files, contradictions worth
arguing about. Honest "nothing yet" allowed.

Phase 1 — Scout (parallel haiku agents)

1. Partition sources into batches of 4-8 by theme; each theme is a wiki

category directory with its own TOC.md. Whole-blog surveys go in sources/ (survey = recurring theses + best posts, one line each).

1. Launch ALL batches as parallel haiku general-purpose agents in ONE

message. Every prompt includes: the entry format verbatim, the fetch list, the project-context line from Phase 0, the unreachable rule (retry once, then write the entry with status: unreachable — NEVER invent content), and the order to write the category TOC.md (- [title](file.md) — one line. tags: ...).

1. No explicit link list ("trending X")? One haiku agent with WebSearch

builds the URL list first; then partition.

Phase 2 — Assemble (main conversation, minutes)

• Spot-check 2-3 entries for format drift; fix entries, not the format.
• Ensure every category TOC exists and its links resolve; write any TOC a

scout couldn't own (shared directories).

• Commit the wiki separately from the distillation.

Phase 3 — Distill (one sonnet agent, or main conversation)

Read the new entries' TL;DR + hooks (not the sources again) and append to the project's ideas file, in that file's existing structure and tone:

• One paragraph per idea, graded honestly against where the project

stands, citing the wiki entry, naming the area it would move.

• Contradictions with the project's philosophy are wanted — state them

plainly and why the outside view might be right.

• Distillation means "what should WE do", never "what did they say".

Cost discipline

Scouts read the web, not the repo. Distillation reads the wiki, not the web. Nothing here needs opus. ~30 links ≈ one mid-size task execution.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: deepklarity
• Source: deepklarity/harness-kit
• License: MIT

Install and usage instructions live in the source repository linked above.