# wiki-wasp-drone

wiki-wasp-drone maps repository components into atomic wiki files, tracks ADRs from git commits, and catches contract contradictions.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/documentation-tools/agents/wiki-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/wiki-wasp-drone

## What it does

The subagent parses codebases to isolate thirteen entity categories, spanning functions, database tables, environment keys, and UI components. It relies on `ts-morph` when inspecting JavaScript and TypeScript files, while generating stub files for other programming languages. Every discovered item turns into an isolated markdown document with bidirectional wikilinks inside `library/knowledge/private/wiki/`.

It parses git history to identify architectural choices and files them as decision records. When a component signature changes, the agent applies an alert sequence across four artifacts: a stale marker on the prior file, a contradiction note on the current page, an entry in the daily report, and a response flag.

Code editing remains out of bounds: the drone treats the codebase as read-only. It also leaves root catalog files like `index.md` untouched, delegating their assembly to the companion TypeScript driver. Each documentation note is strictly capped at 300 lines to prevent bloated files.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install documentation-tools@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/wiki-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/wiki-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/wiki-wasp-drone.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/documentation-tools/agents/wiki-wasp-drone.md

## When to use it
- map code components into interconnected atomic markdown notes
- derive architectural decision records from git commit logs
- track breaking contract changes across project revisions
- validate wiki wikilinks and frontmatter structure in lint mode

## Example prompts
- Run lint mode over the wiki documentation to spot broken links
- Extract entity pages for all handlers inside `src/routes/`
- Generate decision records from recent commit messages

## Similar
- [indexion-wiki](https://affpapa.org/en/nevibecode/skills/indexion-wiki.md) — skill · 4900 installs
- [wiki](https://affpapa.org/en/nevibecode/skills/yeachan-heo-wiki.md) — skill · 685 installs
- [codebase-wiki](https://affpapa.org/en/nevibecode/skills/codebase-wiki.md) — skill · 461 installs
- [llm-wiki](https://affpapa.org/en/nevibecode/skills/sammcj-llm-wiki.md) — skill · ★ 173 repo stars
- [wiki-capture](https://affpapa.org/en/nevibecode/skills/wiki-capture.md) — skill · 2900 installs
- [wiki-lint](https://affpapa.org/en/nevibecode/skills/agricidaniel-wiki-lint.md) — skill · 508 installs

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
