waymark

<!-- tldr ::: guide interactive waymark addition to files with proper syntax -->

<!-- tldr ::: apply pending waymarks from plan document with interactive review -->

<!-- tldr ::: audit waymark coverage quality and accuracy across codebase files -->

<!-- tldr ::: guided project initialization for waymark setup with strategy selection -->

Inject all waymarks as JSON for full codebase context

Show starred (high-priority) waymarks

Show file-level TLDR waymarks across the codebase

Show all todo waymarks in the codebase

You are a waymarker specializing in code annotation and documentation through waymarks.

Use this agent when you need to perform comprehensive testing of the wm (Waymark) CLI tool after code changes, before releases, or when verifying functionality across all commands and output formats. This agent should be invoked proactively after: <example> Context: User has just completed implementing a new CLI command or flag. user: "I just added a --jsonl flag to wm scan" assistant: "Great! Let me verify the implementation works correctly." <commentary> Since new CLI functionality was added, use the Task tool to launch the wm-tester agent to validate the new flag works correctly and doesn't break existing functionality. </commentary> assistant: "Now let me use the wm-tester agent to run comprehensive tests on the CLI" </example> <example> Context: User is preparing for a release. user: "Waymark 1.0.0-beta.2 is ready to ship" assistant: "Before we proceed with the release, let me run comprehensive CLI tests to ensure everything is working." <commentary> Before any release, use the wm-tester agent to validate all CLI functionality is working correctly across all commands and output formats. </commentary> assistant: "I'm going to use the Task tool to launch the wm-tester agent for pre-release validation" </example> <example> Context: User has made changes to formatting, scanning, or ID management. user: "I refactored the formatter and tweaked ID reservation logic" assistant: "Let me verify the formatting changes work correctly across all commands." <commentary> Since core formatting and record management changed, use the wm-tester agent to exercise formatting, scanning, insert/modify/remove flows, and JSON/text outputs. </commentary> assistant: "Now let me use the wm-tester agent to validate the formatting and ID changes" </example>

This skill should be used when the user asks about "waymark syntax", "writing waymarks", "::: sigil", "tldr waymarks", "about waymarks", searching waymarks with ripgrep, or mentions waymark grammar, signals, markers, or properties. Provides comprehensive guidance for authoring and searching waymarks without requiring CLI tools.

This skill should be used when the user asks about "wm command", "waymark cli", "wm find", "wm add", "wm edit", "wm rm", "wm fmt", "wm lint", or needs to use waymark tooling. Requires `using-waymarks` skill for syntax fundamentals. Provides comprehensive CLI command reference and workflows.

<!-- tldr ::: command guide for wm skill -->