Design Harness

design-harness

Turn scattered reading and half-formed ideas into a design you can defend — a skill, a system, a video script, even the structure of an article. The human adjudicates, the agent runs the errands.

An Agent Skill (Claude Code plugin, works with any SKILL.md-compatible agent): feed it sources and rough ideas as you go — it files and links them, records how your thinking evolves, and assembles the evidence into a system design.

Markdown keeps the record; the canvas makes it readable — every source and idea you add lands on the board, one glance away from any decision's why.

▶ Click the board to open the live canvas — this repo's own design workspace, dogfooded — Pages serves the committed docs/canvas.html as-is. It's also our answer to "why is the design like this?" — send the link.

What This Does

• Sources file themselves — drop papers, repos, blog posts; the agent files one card per source, grades it, and anchors every claim to where it came from.
• Ideas are yours alone — only a human creates an idea card; the agent links it to evidence, clusters neighbors, and surfaces conflicts instead of picking a side.
• Output assembles on your word — one command turns surviving ideas into the deliverable, and every later sync runs on your word too; edit output directly and it flows back into ideas.
• Everything is traceable — every design element links back through ideas to the sources that earned it, with an append-only log on every card.
• Plain Markdown, no lock-in — three folders in your repo; versionable, greppable, renders on GitHub. The agent is just the runtime.
• One visual canvas — a self-contained HTML projection of the whole board: no server, no dependencies, rebuilt from the markdown on demand. Commit it, and whoever gets the repo gets the board.

Installation

Claude Code:

/plugin marketplace add tigerless-labs/design-harness
/plugin install design-harness@design-harness

Codex (CLI and the ChatGPT desktop app share one plugin system):

codex plugin marketplace add tigerless-labs/design-harness

then install from /plugins in the CLI or the desktop app's plugin directory.

For other SKILL.md-compatible agents, copy the skill folder into your agent's skill directory:

git clone https://github.com/tigerless-labs/design-harness
cp -r design-harness/plugins/design-harness/skills/design-harness \
  ~/.claude/skills/

Updating

Claude Code — refresh the marketplace, then update the plugin:

/plugin marketplace update design-harness
/plugin update design-harness@design-harness

(Or enable auto-update for this marketplace under /plugin → Marketplaces.)

Codex — refresh the marketplace snapshot, then update from /plugins:

codex plugin marketplace upgrade

Manual copy — git pull the clone and re-run the cp -r above.

Usage

Talk to your agent in plain language:

> file these papers onto the board

> assemble the design

1. Drop material — the agent files and grades each source as a card.
2. Think out loud — your judgments land as idea cards, linked to their evidence.
3. Say go — the ideas assemble into the output your target.md declares.
4. Ask for the canvas — the agent builds the board and hands you a clickable link.