AI coding agent skill for the First Principles Framework (FPF) by Anatoly Levenchuk.
FPF is a transdisciplinary reasoning architecture for systems engineering, knowledge coordination, and mixed human/AI teams.
FPF is a thinking amplifier — it helps you plan deeper and make better decisions by systematically exploring relevant alternatives instead of anchoring on the first idea.
This skill functions as agentic RAG — retrieval-augmented generation driven by the agent itself, with no external vector database or embedding pipeline. The FPF specification is split into a two-level hierarchy (17 directories, 292 files). SKILL.md provides a thinking-verb router that maps the user's intent to the right section. The agent then navigates _index.md files to pick the narrowest sub-section (~350 lines) and loads only that into context. The agent is the retriever, the router, and the reasoner — all in one loop.
npx skills add CodeAlive-AI/fpf-problem-solving-skill -gsections/
05-part-a---kernel-architecture-cluster/
_index.md # TOC with descriptions of all sub-sections
01-a-0---onboarding-glossary.md # 137 lines
02-a-1---holonic-foundation.md # 185 lines
... # 21 sub-sections total
09-part-c-kernel-extension-specifications/
_index.md
... # 56 sub-sections
... # 17 directories total
The agent reads _index.md first, picks the right sub-section file, and loads only that.
| # | Section | Sub-sections |
|---|---|---|
| 01 | Title page | 0 |
| 02 | Table of Content | 1 |
| 03 | Readme | 7 |
| 04 | Preface | 21 |
| 05 | Part A — Kernel Architecture | 21 |
| 06 | A.IV.A — Signature Stack & Boundary | 23 |
| 07 | A.V — Constitutional Principles | 35 |
| 08 | Part B — Trans-disciplinary Reasoning | 24 |
| 09 | Part C — Kernel Extensions | 56 |
| 10 | Part D — Multi-Scale Ethics & Conflict-Optimisation | 1 |
| 11 | Part E — Constitution & Authoring | 47 |
| 12 | Part F — Unification Suite | 21 |
| 13 | Part G — Discipline & SoTA Patterns Kit | 15 |
| 14 | Part H — Glossary | 0 |
| 15 | Part I — Annexes | 1 |
| 16 | Part J — Indexes | 0 |
| 17 | Part K — Lexical Debt | 3 |
When the upstream FPF specification changes, two things need updating:
Pull the submodule and re-run the splitter to rebuild the sections/ hierarchy:
git submodule update --remote
python3 scripts/split_spec.pyThe section files are raw content — SKILL.md is the navigation layer on top.
After regenerating, review whether the thinking-verb router, use cases, or Section INDEX
in SKILL.md need updating to reflect new, changed, or removed content.
See FPF-SKILL-UPDATE-GUIDE.md for the full methodology: what to check, how to validate router entries, and how to run an FPF self-audit on the skill file itself.
- FPF specification: Anatoly Levenchuk — github.com/ailev/FPF
- Skill packaging: CodeAlive-AI
MIT