Skip to content

Commit 3781751

Browse files
rodion-mclaude
andcommitted
Add thinking amplifier description, require README updates in guide
- README.md & README-RU.md: add "thinking amplifier" / "система усиления мышления" description — deeper planning, better decisions, systematic exploration of relevant alternatives - FPF-SKILL-UPDATE-GUIDE.md: add step 6 — README files must be updated after every skill update Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent dc19cc3 commit 3781751

3 files changed

Lines changed: 14 additions & 0 deletions

File tree

FPF-SKILL-UPDATE-GUIDE.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,6 +91,15 @@ After updating, run these checks against the FPF patterns that matter most for a
9191
| **Composition (B.1)** | If new sections are added, does Step 4 still give adequate synthesis guidance? Are there new cross-section patterns to document? |
9292
| **Cognitive Elegance (P-1)** | Is the file still compact? Growth should be justified by navigation value, not completeness for its own sake. |
9393

94+
### 6. README files
95+
96+
After updating SKILL.md, sync both README.md and README-RU.md:
97+
- Update the Sections table if sections were added, removed, or renamed
98+
- Update the "How it works" / "Как это работает" description if the navigation approach changed
99+
- Keep both language versions consistent with each other
100+
101+
README files are for humans on GitHub — they must reflect the current state of the skill.
102+
94103
## Process summary
95104

96105
```
@@ -99,4 +108,5 @@ After updating, run these checks against the FPF patterns that matter most for a
99108
3. Update the relevant SKILL.md component (description / use cases / router / INDEX)
100109
4. Run the FPF self-audit (table above)
101110
5. Test with simulated user queries
111+
6. Update README.md and README-RU.md to match
102112
```

README-RU.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44

55
FPF — трансдисциплинарная архитектура мышления для системной инженерии, координации знаний и смешанных команд человек/ИИ.
66

7+
FPF — это **система усиления мышления**: она позволяет планировать и принимать решения более глубоко и качественно, систематически рассматривая несколько релевантных опций вместо фиксации на первой идее.
8+
79
## Как это работает
810

911
Скилл работает как **агентный RAG** — retrieval-augmented generation, управляемый самим агентом, без внешней векторной базы данных или пайплайна эмбеддингов. Спецификация FPF на 56 000 строк разбита на двухуровневую иерархию (20 директорий, 224 файла). SKILL.md содержит роутер на основе «глаголов мышления», который сопоставляет намерение пользователя с нужным разделом. Агент навигирует по файлам `_index.md`, выбирает минимальный подраздел (~300 строк) и загружает в контекст только его. Агент одновременно является ретривером, роутером и генератором — всё в одном цикле.

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ AI coding agent skill for the [First Principles Framework (FPF)](https://github.
66

77
FPF is a transdisciplinary reasoning architecture for systems engineering, knowledge coordination, and mixed human/AI teams.
88

9+
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.
10+
911
## How it works
1012

1113
This skill functions as **agentic RAG** — retrieval-augmented generation driven by the agent itself, with no external vector database or embedding pipeline. The 56,000-line FPF specification is split into a two-level hierarchy (20 directories, 224 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 (~300 lines) and loads only that into context. The agent is the retriever, the router, and the reasoner — all in one loop.

0 commit comments

Comments
 (0)