clark-decision

Log Trails framework decisions with rationale to .trails/clark/decisions.md.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Authoritative ruling on when a definitive call is needed for Trails framework questions, ensuring consistent governance and a traceable log of decisions.

Core Features & Use Cases

  • Provides fast, authoritative rulings on naming, lexicon, architecture, and scope questions.
  • Follows the constitutional hierarchy to resolve disputes and document rationale.
  • Logs each decision to .trails/clark/decisions.md with date, topic, decision, basis, and confidence.

Quick Start

Ask Clark to decide a question and log the decision to .trails/clark/decisions.md.

Frequently Asked Questions about clark-decision

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

FAQPage Schema
How do I enforce governance and log architectural decisions for a software framework?

To enforce governance and log architectural decisions, you need a structured approach providing authoritative rulings on naming, lexicon, and scope. Each decision is formally recorded with its date, topic, basis, and confidence for traceability.

What is the best way to resolve disputes over naming conventions and lexicon in a project?

The best way to resolve disputes over naming conventions and lexicon is through authoritative governance. This applies a constitutional hierarchy to make definitive calls and documents the rationale, ensuring consistent rulings across the framework.

How do I document architecture decisions with a clear basis and confidence level?

You document architecture decisions by logging them to a dedicated markdown file. The log enforces a structured format detailing the date, topic, decision, basis, and confidence level, creating a traceable record of the governance ruling.

When do I need a formal decision log for framework architecture questions?

You need a formal decision log for framework architecture questions when a definitive call is required to ensure consistent governance. It is specifically applied to questions requiring hierarchical rationale and formal logging of scope decisions.

Does architectural governance documentation require a specific file structure?

Yes, architectural governance documentation requires a specific file structure. Decisions are logged directly to a designated markdown file, ensuring all rulings, dates, topics, and confidence levels are centralized and traceable.