Initial release: FPF simple skill with 20 section files

Split FPF-Spec.md by top-level headings into navigable sections with
auto-generated TOCs. SKILL.md provides an INDEX mapping each section
to its use case.

Based on the First Principles Framework by Anatoly Levenchuk:
https://github.com/ailev/FPF

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: rodion-m

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "FPF"]
+	path = FPF
+	url = https://github.com/ailev/FPF.git

FPF

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CodeAlive-AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LICENSE

@@ -0,0 +1,58 @@
+---
+name: fpf-simple-skill
+description: "First Principles Framework (FPF) — transdisciplinary reasoning architecture for systems engineering, knowledge coordination, and mixed human/AI teams. Use when the user mentions FPF, first principles, bounded contexts, SoTA packs, concept unification, assurance calculus, or FPF Parts A-K. Not for general philosophy or Agile unrelated to FPF."
+license: MIT
+---
+
+# First Principles Framework (FPF)
+
+An "Operating System for Thought" — a rigorous, transdisciplinary architecture for reasoning,
+written in human- and machine-readable pseudo-code. FPF turns raw intelligence (human or machine)
+into organisationally usable reasoning: explicit bounded contexts, auditable artefacts, multi-view
+descriptions, and disciplined hand-offs between specialised actors.
+
+## How to use
+
+1. Find the relevant section(s) from the INDEX below.
+2. Read the corresponding file from `sections/` into context.
+3. Apply FPF patterns using plain language; introduce FPF-internal names only when they add precision.
+
+FPF is not a narrative textbook — it is source code for an evolvable reasoning architecture.
+Treat it as a design kit: ask for bounded-context maps, decision criteria, option portfolios,
+hand-off contracts, and publication surfaces for the user's domain, then iterate.
+
+## Starter prompt
+
+> You have the FPF specification loaded.
+> Help me structure your project / problem / programme.
+> Use plain language for an engineer-manager.
+> Propose: (1) bounded contexts / specialisations, (2) decision criteria, (3) key alternatives,
+> (4) hand-offs, and (5) missing evidence or tests before commitment.
+> Introduce internal FPF names only when they add precision.
+
+## Section INDEX
+
+Load the section file that matches the user's need:
+
+| # | File | When to use |
+|---|------|-------------|
+| 01 | [Title page](sections/01-first-principles-framework-core-conceptual-specification.md) | Need the document's authorship, version date, or top-level identity. |
+| 02 | [Table of Content](sections/02-table-of-content.md) | Navigate the spec, locate a specific pattern, or understand inter-section dependencies. |
+| 03 | [Preface](sections/03-preface.md) | Onboarding to FPF; choosing a reading path for a specific role (project user, pattern author, language-state work). |
+| 04 | [Part A — Kernel Architecture](sections/04-part-a-kernel-architecture-cluster.md) | Understand or apply FPF's core ontological building blocks: holons, bounded contexts, roles, transformers, method/work separation, generative search/portfolio vocabulary. |
+| 05 | [Cluster A.IV.A — Signature Stack & Boundary Discipline](sections/05-cluster-a-iv-a---signature-stack-boundary-discipline.md) | Model system boundaries, APIs, protocols, or any interface where statements must be classified as definitions, gates, duties, or evidence. |
+| 06 | [Cluster A.V — Constitutional Principles / Strict Distinction](sections/06-cluster-a-v---constitutional-principles-of-the-kernel.md) | Prevent category errors: role vs. function, method-description vs. method vs. work, holon vs. system vs. episteme, episteme vs. carrier. |
+| 07 | [Part B — Trans-disciplinary Reasoning](sections/07-part-b-trans-disciplinary-reasoning-cluster.md) | Compose or roll up subsystem properties, trust scores, or any cross-scale aggregation (Gamma algebra). Explicit invariants and weakest-link bounds. |
+| 08 | [Part C — Kernel Extensions (CALs, LOGs, CHRs)](sections/08-part-c-kernel-extensions-specifications.md) | Formally characterize, compose, or compare knowledge artifacts (theories, specs, proofs, datasets). Epistemic scoring on Formality, ClaimScope, Reliability. |
+| 09 | [Part D — Multi-scale Ethics & Conflict-Optimisation](sections/09-part-d-multi-scale-ethics-conflict-optimisation.md) | Ethical trade-offs across scales, conflict resolution between stakeholders, bias auditing, or safety-evidence overriding utility. |
+| 10 | [Part E — Constitution & Authoring (header)](sections/10-part-e---fpf-constitution-and-authoring-cluster.md) | Entry point for Part E subsections (constitution, pillars, authoring protocols, lexical rules). |
+| 11 | [Section E-I — FPF Constitution](sections/11-section-e-i---the-fpf-constitution.md) | Understand FPF's foundational purpose, vision/mission ("OS for Thought"), the 11 Pillars, guard-rails, and the Multi-View Publication Kit (MVPK). |
+| 12 | [Part F — Unification Suite (header)](sections/12-part-f-the-unification-suite-concept-sets-sensecells-contextual-role-assignment.md) | Entry point for Part F subsections (Concept-Sets, SenseCells, Contextual Role Assignment). |
+| 13 | [Cluster F.I — Context of Meaning & Raw Material](sections/13-cluster-f-i-context-of-meaning-raw-material.md) | Semantic drift, homonym collisions, cross-domain vocabulary alignment. Contextual Lexicon Principles and Alignment Bridges. |
+| 14 | [UTS Layout A — Cross-context unification table](sections/14-block-fpf-u-type-unified-tech-name-unified-plain-name-plain-twin-governance-twin.md) | Build or read a cross-context unification table mapping concepts across standards or frameworks (BPMN, PROV-O, ITIL, etc.). |
+| 15 | [UTS Layout B — Base-concept pivot](sections/15-block-base-concept-scale-map.md) | Build a discipline-oriented concept unification table mapping unified concepts across discipline columns (operations, physics, math). |
+| 16 | [Part G — Discipline SoTA Patterns Kit](sections/16-part-g-discipline-sota-patterns-kit.md) | Author, extend, or refactor discipline-specific patterns. Harvest competing schools of thought, build SoTA Packs, TraditionCards, OperatorCards, selector-ready portfolios. |
+| 17 | [Part H — Glossary & Definitional Pattern Index](sections/17-part-h-glossary-definitional-pattern-index.md) | Look up canonical definitions, four-register naming, or cross-references for any FPF term. |
+| 18 | [Part I — Annexes & Extended Tutorials](sections/18-part-i-annexes-extended-tutorials.md) | Deprecated aliases, step-by-step walkthroughs, change log, external standards mappings (ISO 15926, BORO, CCO, Constructor Theory). |
+| 19 | [Part J — Indexes & Navigation Aids](sections/19-part-j-indexes-navigation-aids.md) | Find which pattern or example addresses a known concept or principle (concept-to-pattern, pattern-to-example, principle-trace indexes). |
+| 20 | [Part K — Lexical Debt](sections/20-part-k-lexical-debt.md) | Mandatory terminology replacements and migration debt for deprecated scope terms. Consult when authoring or editing normative FPF text. |

SKILL.md

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+"""Split FPF-Spec.md into separate files by top-level (#) headings."""
+
+import re
+import sys
+from pathlib import Path
+
+SCRIPT_DIR = Path(__file__).resolve().parent
+PROJECT_ROOT = SCRIPT_DIR.parent
+SPEC_FILE = PROJECT_ROOT / "FPF" / "FPF-Spec.md"
+OUTPUT_DIR = PROJECT_ROOT / "sections"
+
+
+def heading_to_filename(index: int, heading: str) -> str:
+    """Convert a heading line into a clean filename like '01-part-a-kernel-architecture-cluster.md'."""
+    # Remove markdown formatting: **, *, backticks
+    clean = heading.lstrip("# ").strip()
+    clean = re.sub(r"[*`]", "", clean)
+    # Remove content inside parentheses
+    clean = re.sub(r"\(.*?\)", "", clean)
+    # Replace special chars with spaces, collapse whitespace
+    clean = re.sub(r"[^a-zA-Z0-9\s-]", " ", clean)
+    clean = re.sub(r"\s+", " ", clean).strip()
+    # Convert to kebab-case, truncate
+    slug = clean.lower().replace(" ", "-")[:80].rstrip("-")
+    return f"{index:02d}-{slug}.md"
+
+
+def split_spec():
+    if not SPEC_FILE.exists():
+        print(f"Error: {SPEC_FILE} not found. Did you init the submodule?", file=sys.stderr)
+        sys.exit(1)
+
+    lines = SPEC_FILE.read_text(encoding="utf-8").splitlines(keepends=True)
+
+    # Find all top-level heading positions (lines starting with exactly '# ')
+    heading_positions = []
+    for i, line in enumerate(lines):
+        if re.match(r"^# ", line):
+            heading_positions.append(i)
+
+    print(f"Found {len(heading_positions)} top-level sections")
+
+    OUTPUT_DIR.mkdir(parents=True, exist_ok=True)
+
+    files_created = []
+    for idx, start in enumerate(heading_positions):
+        end = heading_positions[idx + 1] if idx + 1 < len(heading_positions) else len(lines)
+        heading_text = lines[start].rstrip("\n")
+        filename = heading_to_filename(idx + 1, heading_text)
+        content = "".join(lines[start:end])
+        out_path = OUTPUT_DIR / filename
+        out_path.write_text(content, encoding="utf-8")
+        line_count = end - start
+        files_created.append((filename, line_count, heading_text))
+        print(f"  {filename} ({line_count} lines)")
+
+    print(f"\nWrote {len(files_created)} files to {OUTPUT_DIR}")
+    return files_created
+
+
+if __name__ == "__main__":
+    split_spec()

scripts/split_spec.py

@@ -0,0 +1,6 @@
+# First Principles Framework (FPF) — Core Conceptual Specification
+by Anatoly Levenchuk and assortment of LLMs.
+March 2026
+
+Pattern and headers templates are explained in pattern E.8.
+