arrow-maintenance

Audit arrow overlay coherence across LLDs, EARS specs, and code references.

90|14|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/jszmajda/lid --skill arrow-maintenance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arrow-maintenance
Source: https://github.com/jszmajda/lid/tree/main/plugins/arrow-maintenance/skills/arrow-maintenance
Command: npx skills add https://github.com/jszmajda/lid --skill arrow-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Arrow maintenance overlays help teams keep design, spec, and code aligned across large codebases, preventing drift and stale mappings by surfacing issues before they become blockers.

Core Features & Use Cases

  • Ambient mode: surfaces relevant work without automatic edits, catch-and-recommend behavior
  • Command mode: explicit /arrow-maintenance passes that perform audit-and-update actions
  • Works on brownfield and greenfield projects to map and maintain overlay coherence

Quick Start

Run /arrow-maintenance to start a guided audit-and-update pass on your project's overlay.

Frequently Asked Questions about arrow-maintenance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit design and code overlay coherence across large projects?

To audit overlay coherence across large projects, run an explicit audit pass that checks reference coherence, coverage, staleness, drift signals, and orphan artifacts between design specs and code references, applying fixes in place.

How do I detect drift between LLDs, EARS specs, and code references?

Detecting drift between LLDs, EARS specs, and code references requires running a deterministic audit that surfaces stale mappings and reference inconsistencies, ensuring your arrow overlay stays aligned across documentation and implementation.

What is the best way to maintain arrow overlay coherence without automatic edits?

Maintaining arrow overlay coherence without automatic edits uses ambient mode, which surfaces relevant work and catch-and-recommend guidance by detecting drift signals and orphan artifacts without modifying files directly.

Can I use arrow maintenance on both brownfield and greenfield projects?

Yes, arrow maintenance works on both brownfield and greenfield projects to map and maintain overlay coherence, surfacing drift and stale mappings before they become blockers in your codebase.

Why does my index.yaml overlay have orphan artifacts and stale mappings?

Orphan artifacts and stale mappings in your index.yaml overlay occur when design specs, EARS requirements, and code references drift apart over time. A directed audit pass detects these issues and applies fixes in place.

Do I need a docs/arrows overlay to use arrow maintenance?

Yes, arrow maintenance targets large projects with an existing docs/arrows overlay structure. It provides ambient guidance when the overlay exists, or you can run an explicit audit for directed passes.