Skip to content

File Structure

Jump to bottom
Money Atlas edited this page Apr 25, 2026 · 1 revision

File Structure

[← Back to Home](Home)

Complete directory map of the First Principle Codex OS repository.

Repository Overview

first-principle-codex-os/
├── SKILL.md                          # Main skill file — copy this to create Claude Skill
├── README.md                         # Repository overview with badges
├── LICENSE.md                        # Open Cognitive License v1.0 — full terms
├── CHANGELOG.md                      # Version history and roadmap
├── CONTRIBUTING.md                   # Contribution guidelines
│
├── references/
│   ├── CODEX_KALAMA.md               # Kalama10 deep reference
│   ├── CODEX_ARIYA4.md               # Ariya4 deep reference
│   ├── SHADOW_GATE_DEEP.md           # Shadow Gate 5 protocols — deep reference
│   ├── COMPOUND_MIND_PATTERNS.md     # 8 solution axes + 8 cross-domain patterns
│   ├── SKILL_INHERITANCE.md          # Step-by-step build guide for child skills
│   └── ANTI_HALLUCINATION.md         # 11 hallucination sources mapped to FPCOS
│
└── examples/
    ├── fpcos-finance-example.MD      # Complete finance skill inheriting FPCOS
    └── fpcos-research-example.MD     # Complete research skill inheriting FPCOS

File Descriptions

SKILL.md — The Skill Definition

The primary file. Contains the complete FPCOS pipeline in executable form:

  • YAML frontmatter (name, version, author, license)
  • Full pipeline: L0 → L1 → L2 → L3 → L4 → L5
  • Skill Interface Contract (5 requirements)
  • Cross-Domain Synthesis Architecture diagram
  • Anti-Hallucination Map (11 sources)
  • Compound Genius Principle
  • Token pressure priority

How to use: Copy the entire contents into Claude → Settings → Skills → Create New Skill.

references/CODEX_KALAMA.md — Kalama10 Reference

Deep reference for the 10-gate proof standard. Contains:

  • All 10 gates with extended explanation
  • Practical application examples per gate
  • Common failures per gate
  • The "Proof = Understanding" axiom

Load when: Applying Kalama10 to a non-obvious claim, or building a child skill that needs domain-adapted Kalama10 examples.

references/CODEX_ARIYA4.md — Ariya4 Reference

Deep reference for the problem frame protocol. Contains:

  • All 4 fields with extended explanation
  • Wrong/Right examples for each field
  • Anti-patterns (symptom-as-problem, vague-cessation)
  • Why "Ariya4 is the compass" — directional ordering rationale

Load when: Problem framing is complex or the Problem/Cause distinction is not clear.

references/SHADOW_GATE_DEEP.md — Shadow Gate Deep Reference

Full protocol reference for all 5 Shadow Gate protocols. Contains:

  • 4-axis Mirror method with examples
  • Inversion strength rating guide and common failures
  • 5 Blind Spot categories with examples
  • Interest Map structural mapping method
  • Meta-Void 3-state decision test
  • Shadow Verdict system (CONSISTENT/FRAGILE/REBUILD)
  • Extension guide for child skills

Load when: Applying Shadow Gate to edge cases, debugging verdict decisions, or building domain extensions.

references/COMPOUND_MIND_PATTERNS.md — Pattern Library

Cross-domain pattern reference for L3. Contains:

  • All 8 universal solution axes with use-case guidance
  • 8 cross-domain patterns with origin, appearances, structure, insight, and application
  • Anti-loop protocols (4 methods)
  • Token efficiency rule

Load when: Cross-domain synthesis needed, or L3 is producing single-axis solutions.

references/SKILL_INHERITANCE.md — Build Guide

Step-by-step guide for child skill construction. Contains:

  • 7 build steps from frontmatter to attribution
  • Domain vocabulary adaptation examples (Finance, Medical)
  • Contract compliance table template
  • Shadow Gate extension template
  • Token pressure priority customization
  • Attribution template

Load when: Building a new child skill on FPCOS.

references/ANTI_HALLUCINATION.md — Diagnostic Catalog

11-source hallucination diagnostic. Contains:

  • Quick diagnostic table (type → layer → protocol)
  • Detailed description of each source: what it looks like, why it happens, FPCOS mechanism
  • Debugging guide: how to trace hallucination to its layer

Load when: Debugging hallucination in skill output, or designing domain-specific anti-hallucination measures.

examples/fpcos-finance-example.MD — Finance Example

Complete example of a finance skill inheriting FPCOS. Demonstrates:

  • Correct YAML frontmatter with inheritance declaration
  • Domain pipeline with L2.5 and L3.5 insertions
  • Domain vocabulary adaptation for all inherited layers
  • Shadow Gate extension (Liquidity Check, Regime Check)
  • Domain Confidence Field format

examples/fpcos-research-example.MD — Research Example

Complete example of a research skill inheriting FPCOS. Demonstrates:

  • Research-domain Ariya4 adaptation
  • Source reliability as L1 Kalama10 application
  • L3 cross-domain synthesis for research topics
  • Shadow Gate application for research bias detection

Related Pages

[← Back to Home](Home)

Clone this wiki locally