What does the validation step involve?

The validation process uses 'organon validate' to check the YAML frontmatter schema, ensure all required content sections are present, verify file path references, and confirm the validity of the inheritance chain.

When should I use ETHOS.md versus PHILOSOPHY.md?

Use ETHOS.md for defining identity (IS/IS NOT statements), invariants, and core principles. Use PHILOSOPHY.md for explaining the problem context, design decisions, and trade-offs associated with a specific implementation.

What is an Organon file?

Organon files are specialized Markdown documents (such as ETHOS.md, PHILOSOPHY.md, and PROTOCOL.md) used to define project identity, constraints, design rationale, and operational procedures within a structured documentation system.

How does scope inheritance work in this skill?

Child scopes, such as features or components, automatically inherit constraints from their parent domain's ETHOS.md. The skill ensures that child documents never relax or contradict the rules established by their parents.

Organon File Creation

Name: Organon File Creation
Author: VledicFranco

byVledicFranco

0•

Learning & Documentation

Automates the generation of structured Organon documentation files with validated frontmatter and inheritance rules.

The Organon File Creation skill provides a standardized workflow for building architectural and procedural documentation within the Organon framework. It automates the creation of ETHOS, PHILOSOPHY, PROTOCOL, and README files, ensuring they maintain correct directory placement, required frontmatter schema, and bidirectional references. By leveraging built-in validation tools, it ensures that new project domains, features, or components adhere to established constraints and inheritance patterns, preventing ad-hoc documentation debt and ensuring that every file follows project-wide quality standards.

Key Features

01Inheritance enforcement from parent scope constraints

020 GitHub stars

03Smart scope classification for domains, features, and components

04Validation of YAML frontmatter and bidirectional file references

05Automated generation of ETHOS, PHILOSOPHY, PROTOCOL, and README templates

06Structured content generation for invariants, principles, and decision heuristics

Use Cases

01Documenting design rationale and trade-offs for new architectural features

02Initial setup of a new business domain with specific invariants and principles

03Creating standardized step-by-step procedure documentation (PROTOCOLS)

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vledicfranco/organon organon-file-creation

For use in Claude.ai and ChatGPT

Download Skill