organon-tools-developer

Enforce Organon methodology invariants and design principles in tooling development.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/VledicFranco/organon --skill organon-tools-developer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: organon-tools-developer
Source: https://github.com/VledicFranco/organon/tree/main/.claude/skills/organon-tools-developer
Command: npx skills add https://github.com/VledicFranco/organon --skill organon-tools-developer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Organon-tools development sometimes diverges from the core ETHOS.md and PHILOSOPHY.md constraints, risking inconsistent tooling and unsafe changes. This Skill enforces the Organon methodology by validating invariants, ensuring that new CLI commands, verification gates, MCP tools, and methodology evolution follow the established design rules and loading requirements.

Core Features & Use Cases

  • Enforces the 6 invariants (schema fidelity, every command has tests, gates fail builds, machine-parsable output, idempotent operations, breaking changes require major version bump) and 5 design principles (fail-fast, composability, testability, clarity).
  • Loads ETHOS.md, PHILOSOPHY.md, and related architecture docs before starting work to ensure alignment.
  • Guides developers through adding CLI commands, gates, MCP tools, or evolving book-llms specs while maintaining methodology integrity.

Quick Start

Load ETHOS.md and PHILOSOPHY.md, then begin development tasks for CLI commands, verification gates, MCP tools, or evolving the methodology while strictly following invariants and design principles.

Frequently Asked Questions about organon-tools-developer

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

FAQPage Schema
How do I enforce methodology constraints when adding CLI commands to Organon tooling?

To enforce Organon methodology constraints when adding CLI commands, load ETHOS.md and PHILOSOPHY.md before development, then validate work against the 6 invariants and 5 design principles to ensure schema fidelity, test coverage, and fail-fast behavior.

What are the core invariants required for Organon verification gates and MCP tools?

The core invariants for Organon verification gates and MCP tools require schema fidelity, mandatory command tests, gates that fail builds, machine-parsable output, idempotent operations, and major version bumps for breaking changes to ensure safe tooling evolution.

Why do my Organon tools development changes risk breaking methodology alignment?

Organon tools development changes risk breaking methodology alignment when they diverge from ETHOS.md and PHILOSOPHY.md constraints, which this Skill prevents by requiring architecture docs to load first and validating invariants before new CLI commands or MCP tools are finalized.

Can I evolve the Organon methodology specification without loading frontmatter docs first?

You cannot safely evolve the Organon methodology specification without loading ETHOS.md, PHILOSOPHY.md, and related frontmatter specifications first, as this loading step is a strict prerequisite to ensure design principles like composability and testability are followed.

What's the best way to structure tests for new Organon CLI commands and MCP tools?

The best way to structure tests for Organon CLI commands and MCP tools is to apply the testability design principle alongside the invariant requiring every command to have tests, ensuring gates fail builds and operations remain idempotent during methodology evolution.

When should I use Organon methodology enforcement for evolving tooling specifications?

You should use Organon methodology enforcement whenever adding CLI commands, verification gates, or MCP tools, or evolving book-llms specs, to ensure structured guidance and tests validate invariants like machine-parsable output and breaking change version bumps.