clark

Detect architectural coherence gaps and vocabulary drift against ADRs and governance rules.

4|1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/outfitter-dev/trails --skill clark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clark
Source: https://github.com/outfitter-dev/trails/tree/main/.claude/skills/clark
Command: npx skills add https://github.com/outfitter-dev/trails --skill clark

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Clark provides strategic architecture guidance, vocabulary enforcement, and coherence checks to keep Trails aligned with its long-term vision and ADRs.

Core Features & Use Cases

  • Architecture review and governance guidance across Trails components and vocabularies.
  • Drift detection and vocabulary enforcement to prevent term drift and misalignment.
  • Decision logging and ADR considerations to capture authoritative rulings.

Quick Start

Provide Clark with a Trails question requiring architectural judgment and vocabulary enforcement.

Frequently Asked Questions about clark

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

FAQPage Schema
How do I detect vocabulary drift and architectural coherence gaps in my repository?

Vocabulary drift and coherence gaps are detected by comparing repository usage against established ADRs, lexicon, and governance rules. This process identifies misalignment, generates risk signals, and provides concrete wording changes to enforce consistency and framework integrity.

What is architectural vocabulary enforcement and when do I need it for governance reviews?

Architectural vocabulary enforcement prevents term misalignment by checking codebase terminology against a defined lexicon. You need it during ADR reviews and governance discussions to capture authoritative rulings, maintain long-term vision alignment, and provide strategic architecture guidance.

How do I apply decision logging and ADR considerations to improve framework consistency?

Decision logging and ADR considerations improve framework consistency by capturing authoritative architectural rulings. You apply them during governance discussions to identify coherence gaps, receive risk signals, and implement suggested wording changes that keep components aligned with long-term vision.

Can I get concrete recommendations and risk signals for architectural misalignment without external dependencies?

Yes, concrete recommendations and risk signals for architectural misalignment are generated independently without external dependencies. The system analyzes your repository against ADRs and lexicon rules to provide suggested wording changes and coherence gap identification directly.

What's the best way to review architecture across components for vocabulary and governance alignment?

The best way to review architecture for vocabulary and governance alignment is querying with architectural judgment questions. This triggers drift detection against governance rules and ADRs, yielding risk signals, coherence gap identification, and suggested wording changes for framework integrity.

When should I not use automated lexicon enforcement for architectural decision records?

Automated lexicon enforcement should not be used when a repository lacks established ADRs or defined governance rules to compare against. Without these foundational references, the system cannot accurately identify coherence gaps or generate meaningful vocabulary drift recommendations.