Skip to content

funnel: house-style READMEs for the 28 README-less tools (every tool dir → contact CTA)#4

Open
deemwario wants to merge 1 commit into
mainfrom
funnel/tool-readmes-cycle9
Open

funnel: house-style READMEs for the 28 README-less tools (every tool dir → contact CTA)#4
deemwario wants to merge 1 commit into
mainfrom
funnel/tool-readmes-cycle9

Conversation

@deemwario

Copy link
Copy Markdown

Funnel: house-style READMEs for the 28 README-less tools

#ossengine cycle 9READMEs/funnel, docs only, no owner gate. Independent of PRs #1/#2/#3.

Why

28 of the 33 tools shipped with no README — so a visitor landing on github.com/deemwar-products/agent-ops/tree/main/<tool> hit a dead-end: no context, no install, no CTA. Every tool dir is a funnel surface; this makes each one convert.

What's in here (28 files, docs only)

A house-style README per tool: problem → "nothing to install" run block → what it does (heuristics honestly labelled) → the tool's write-up link → a deemwar.com/contact lead CTA. Now all 33 tools have a README (the 4 lints + storyboard-doctor already did).

Verified accurate by construction

  • All 28 primary tool scripts are byte-identical to the source the READMEs were written against — so the documented flags/behavior match this repo's tools exactly (no drift, no invented flags).
  • Every ported README carries the deemwar.com/contact CTA (grep-confirmed, 28/28).
  • No stale repo references — all clone URLs point at deemwar-products/agent-ops.

Docs only; no tool logic changed.

🤖 Generated with Claude Code

Every tool's directory was a dead-end — no context, no CTA — so a visitor
landing on github.com/.../tree/main/<tool> bounced. This gives all 33 tools
a README (the 4 lints + storyboard-doctor already had one).

- Each README: problem → 'nothing to install' run block → what it does
  (heuristics labelled) → the tool's write-up link → a deemwar.com/contact
  lead CTA. Grounded in each tool's own script (no invented flags).
- Verified accurate by construction: all 28 primary tool scripts are
  byte-identical to the source the READMEs were written against; every
  ported README carries the deemwar.com/contact CTA; no stale repo refs.

Docs only; no tool logic changed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant