Skill для AI coding agent по First Principles Framework (FPF) от Анатолия Левенчука.
FPF — трансдисциплинарная архитектура рассуждения для системной инженерии, координации знаний и смешанных human/AI-команд.
FPF работает как усилитель мышления: помогает глубже планировать и принимать более качественные решения через систематическое исследование релевантных альтернатив, а не фиксацию на первом варианте.
Skill работает как agentic RAG: retrieval-augmented generation, где поиск выполняет сам агент без внешней векторной базы и embedding pipeline. Upstream-спецификация FPF разделена на двухуровневую иерархию: 15 директорий и 405 файлов. SKILL.md содержит router по thinking verbs, который сопоставляет намерение пользователя с нужной секцией: выбор стартовой или практической точки входа, поиск систем, которые могут нести значимые последствия, восстановление кандидата метода из свидетельств о работе, устранение неоднозначности agent-relative инструкций, выбор или возобновление следующего действия в ходе работы, обнаружение применимых методов, начало исследования из обычной работы, координация состояний развития, сопоставление доменных терминов, проверка конфигурации исполнителей и средств поддержки при прерываниях, передачах, задержках и реконфигурациях, проверка обязательных шагов workflow на операционную значимость, сравнение конечных изменений конфигурации, оценка полезности советов и требований к свидетельствам для решения получателя, уточнение утверждений о learning, development и evolution, проверка причин кажущейся утраты capability до выбора повторного развития, применение паттерна до первого полезного результата, навигация по DPF Suite Reference, перепроверка затронутых решений после изменения источника, запрос ограниченного результата другой практики, подбор представлений для одного использования, построение сопоставимых способов получить один результат, сборка формы публикации framework или связанных методов, синтез архитектуры из несовпадающих структур практики, развитие capability для именованного Work, синтез исходных онтологий без утраты их локальных смыслов, восстановление предметов и ролей, трассировка зависимостей от внешнего использования, различение отношений и их реализаций, преобразование эпистем, рассуждения о решениях, построении и проверке causal models, фактической временной структуре, времени, архитектуре и структурной адекватности, публикация стабильных multi-view артефактов, управление ontic admission, обновление SoTA-паков и provenance. Навигация также охватывает структуру, извлекаемую читателем при заданных условиях (C.2.8), Architectural Rationale и выбор профиля, retargeting с отдельными bounded-use assertions и суждениями о текущем случае, а также межконтекстное повторное использование с требованиями assurance для заявленного использования. Затем агент читает _index.md, выбирает самый узкий подраздел и загружает только его в контекст. Агент одновременно является retriever, router и reasoner.
Навигация также охватывает связь составляющих действий с объемлющей работой (B.1.5.EW), сохранение требований использующих работ при замене метода (B.1.5.RS), первые модели и применение теорий, пересмотр рассуждений, связь физических, математических и вычислительных результатов, построение и исправление измерений, повторную идентификацию объектов, информацию для прогноза, повторно используемые операции и ветвящийся поиск. Сравнение преобразований симметрии доступно в C.29.1, а уточнение смысла model/explanation — в E.10.
npx skills add CodeAlive-AI/fpf-problem-solving-skill -gsections/
05-part-a---kernel-architecture-cluster/
_index.md # TOC с описаниями всех подразделов
01-a-0---generative-search-onboarding-glossary.md
02-a-1---recognize-a-whole-with-parts.md
... # 30 подразделов
09-part-c---kernel-extension-specifications/
_index.md
... # 94 подразделов
... # 15 директорий
Агент сначала читает _index.md, затем выбирает нужный файл подраздела и загружает только его.
| # | Section | Sub-sections |
|---|---|---|
| 01 | Title page | 0 |
| 02 | Table of Contents | 0 |
| 03 | FPF Readme | 12 |
| 04 | Preface | 22 |
| 05 | Part A — Kernel Architecture | 30 |
| 06 | A.IV.A — Signature Stack & Boundary | 29 |
| 07 | A.V — Constitutional Principles | 49 |
| 08 | Part B — Trans-disciplinary Reasoning | 40 |
| 09 | Part C — Kernel Extensions | 96 |
| 10 | Part D — Ethics & Conflict | 5 |
| 11 | Part E — Constitution & Authoring | 69 |
| 12 | Part F — Unification Suite | 22 |
| 13 | Part G — SoTA Patterns Kit | 15 |
| 14 | Part H — Reserved | 0 |
| 15 | Part I — Annexes | 1 |
Числа соответствуют H2-заголовкам upstream. Preface содержит 21 содержательный раздел и маркер границы FPF.Preface:End без содержимого.
Когда upstream-спецификация FPF меняется, нужно обновить два слоя.
Склонируйте официальный upstream ailev/FPF во временный skill layout вне этого репозитория, запустите там splitter и замените отслеживаемое дерево sections/ сгенерированным:
tmpdir="$(mktemp -d)"
mkdir -p "$tmpdir/skill/scripts"
git clone https://github.com/ailev/FPF.git "$tmpdir/skill/FPF"
cp scripts/split_spec.py "$tmpdir/skill/scripts/split_spec.py"
python3 "$tmpdir/skill/scripts/split_spec.py"
rsync -a --delete "$tmpdir/skill/sections/" sections/
rm -rf "$tmpdir"Section files — это сырой контент. SKILL.md является навигационным слоем поверх него. После регенерации проверьте, нужно ли обновить thinking-verb router, use cases или Section INDEX, чтобы отразить новые, изменённые или удалённые паттерны.
См. FPF-SKILL-UPDATE-GUIDE.md: там описано, что проверять, как валидировать router entries и как проводить FPF self-audit для самого skill-файла.
- FPF specification: Анатолий Левенчук — github.com/ailev/FPF
- Skill packaging: CodeAlive-AI
Упаковка скилла и splitter: MIT. Адаптировано из First Principles Framework (FPF) Анатолия Левенчука, ailev/FPF, коммит источника b112256466bff620bbee2b72ab8cfe4ad976e60d. Текст спецификации FPF распространяется под CC BY 4.0; см. область действия лицензии источника. Изменения: спецификация разделена на файлы секций с генерируемыми навигационными индексами, а SKILL.md добавляет маршрутизацию и инструкции для агента. Автор FPF не подтверждал и не одобрял эту адаптацию.