architecture-fitness-function-author

Convert architecture findings into fitness-function candidates with validation commands.

4|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/danielbaustin/agent-design-language --skill architecture-fitness-function-author
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-fitness-function-author
Source: https://github.com/danielbaustin/agent-design-language/tree/main/adl/tools/skills/architecture-fitness-function-author
Command: npx skills add https://github.com/danielbaustin/agent-design-language --skill architecture-fitness-function-author

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps teams convert scattered architecture findings into structured, executable fitness-function plans by separating machine-checkable invariants from human judgment and by outlining policy checks, validation commands, and ownership, without mutating customer repositories.

Core Features & Use Cases

  • Transforms CodeBuddy review packets, architecture reviews, findings, or repository evidence into bounded, testable rules.
  • Classifies invariants into machine-checkable, human-judgment, or deferred automation to guide implementation priorities.
  • Produces a concrete plan artifact (JSON) and a readable report (Markdown) that drive downstream contract tests, CI gates, ADRs, and governance.

Quick Start

Run the planner on your review artifacts to emit architecture_fitness_functions.json and architecture_fitness_functions.md.

Frequently Asked Questions about architecture-fitness-function-author

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

FAQPage Schema
How do I convert architecture review findings into executable fitness functions?

Architecture fitness functions translate review findings into executable validation rules by classifying invariants as machine-checkable, human-judgment, or deferred. This planner separates automated checks from manual reviews to produce structured, testable rules from scattered repository evidence.

How do I generate machine-checkable architecture rules from CodeBuddy review packets?

You can generate machine-checkable architecture rules from CodeBuddy review packets by applying the planner to classify findings into bounded, testable invariants. The Skill produces an architecture_fitness_functions.json artifact and a Markdown report with validation commands and ownership details.

Can I use architecture fitness functions to drive CI gates and contract tests?

Yes, architecture fitness functions drive CI gates and contract tests by producing a concrete JSON artifact and Markdown report. These outputs map validation commands and ownership details directly into downstream contract tests, CI gates, ADRs, and governance processes.

What is the difference between machine-checkable and human-judgment architecture invariants?

Machine-checkable invariants are automated rules evaluated locally by tools, while human-judgment invariants require manual review. The planner separates architecture findings into these categories alongside deferred automation to guide implementation priorities and structure downstream validation.

Does the fitness function planner mutate my repository when analyzing architecture findings?

No, the fitness function planner does not mutate your repository when analyzing architecture findings. It reads repository evidence and review packets to output standalone JSON and Markdown artifacts, ensuring the source code remains unchanged during the validation planning process.