Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/codealive-ai/ai-driven-development/fpf-problem-solvingnpx skills add CodeAlive-AI/ai-driven-development --skill fpf-problem-solvinggit clone --depth 1 https://github.com/CodeAlive-AI/ai-driven-developmentWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00196 | $0.04342 |
| Opus 5 | $0.00098 | $0.02171 |
| Sonnet 5 | $0.00039 | $0.00868 |
| Haiku 4.5 | $0.00020 | $0.00434 |
Grade A, and why
fpf-problem-solving scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 141 lines — stays where its author put it; the contents beside it link to each section on GitHub.
First Principles Framework (FPF)
An "Operating System for Thought" — a 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.
Use cases
Use FPF whenever you need to think more rigorously than the situation's default.
- Decompose a messy, cross-domain problem into parts that can be reasoned about independently
- Make a high-stakes decision with incomplete evidence — and know what evidence is still missing
- Get a mixed team to reason together without vocabulary collisions or hidden assumptions
- Audit whether a conclusion is well-founded or just plausible
- Transform or transfer an insight without losing its subject, precision, or stated limitations
- Structure a proposal that must survive scrutiny from multiple expert perspectives
- Generate alternatives systematically instead of anchoring on the first idea
- Define what "better" means before comparing options
- Classify what kind of problem you're facing before searching for solutions
- Plan how an AI agent should select and sequence its tools under budget and trust constraints
- Make a decision under uncertainty — identify options, weigh evidence, and commit with an auditable rationale
- Establish whether X causes Y — or just correlates — and determine what intervention would work
- Publish a stable multi-view artifact without changing the source semantics
- Assemble or check a public framework publication form while preserving product-specific bodies and references
- Develop a holder system's capability for a named Work family and verify transfer in representative Work
- Synthesize source ontologies for one bounded authoring decision without flattening their local meanings
- Refresh a SoTA pack, benchmark, or evidence trail when evidence decays or telemetry changes
- Synthesize architecture candidates, compare structural options, or repair modularity/reuse claims
- Detect an ontic candidate, decide its first-use disposition, and govern whether a new concept or U-kind should be introduced instead of just renamed
- Identify the exact system that acts or is intended to change, then trace a lost path from outside use to architecture, production, and recursive builders
- Discover other systems that may bear relevant consequences before a decision closes
- Recover a reusable method cautiously from several performances, logs, or observations without treating the evidence as the method itself
- Choose the next action during ongoing work when current facts, authority, and stop conditions matter
- Recover the actual performer/support configuration for Work and test what survives interruption, handoff, delay, or reconfiguration
- Compare what a finite addition, replacement, or intervention contributes relative to the current configuration
- Clarify what a claim about human, machine, organizational, or cultural “learning” actually says changed
- Apply one selected FPF pattern to a current question and stop at the first useful result
What ships with it
60 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- FPF-SKILL-UPDATE-GUIDE.md 6.5 KB
- README-RU.md 6.6 KB
- README.md 4.6 KB
- scripts/split_spec.py 6.8 KB runs code
- sections/01-first-principles-framework---core-conceptual-specification/_index.md 1.5 KB
- sections/02-table-of-contents/_index.md 200 KB
- sections/03-first-principles-framework-readme/_index.md 3.9 KB
- sections/03-first-principles-framework-readme/01-practical-entries.md 24 KB
- sections/03-first-principles-framework-readme/02-decide-whether-fpf-fits.md 6.1 KB
- sections/03-first-principles-framework-readme/03-when-several-transformation-flows-form-one-network.md 3.7 KB
- sections/03-first-principles-framework-readme/04-recover-a-lost-path-from-outside-use-to-recursive-builders.md 1.0 KB
- sections/03-first-principles-framework-readme/05-one-minute-example.md 1.6 KB
- sections/03-first-principles-framework-readme/06-what-fpf-is.md 1.1 KB
- sections/03-first-principles-framework-readme/07-what-fpf-is-not.md 510 B
- sections/03-first-principles-framework-readme/08-how-to-use-this-repository.md 2.1 KB
- sections/03-first-principles-framework-readme/09-citation.md 158 B
- sections/04-preface/_index.md 5.7 KB
- sections/04-preface/01-what-this-specification-is-and-how-to-use-it.md 20 KB
- sections/04-preface/02-fpf-as-a-project-not-only-a-pattern-list.md 2.5 KB
- sections/04-preface/03-why-fpf-exists.md 1.7 KB
- sections/04-preface/04-creativity-and-assurance-mature-together.md 2.7 KB
- sections/04-preface/05-local-closure-inside-an-open-world.md 1.9 KB
- sections/04-preface/06-fpf-as-an-evolutionary-architecture-for-thought.md 1.5 KB
- sections/04-preface/07-architectural-characteristics-of-thought.md 4.6 KB
- sections/04-preface/08-beyond-bias-hunting.md 1.7 KB
- sections/04-preface/09-thinking-through-writing.md 2.1 KB
- sections/04-preface/10-thinking-oriented-architecture-not-a-descriptive-upper-ontol.md 1.6 KB
- sections/04-preface/11-the-bitter-lesson-stance.md 1.7 KB
- sections/04-preface/12-from-flat-documents-to-multi-view-truth.md 2.6 KB
- sections/04-preface/13-architecture-as-structure-of-holons.md 2.1 KB
- sections/04-preface/14-boundary-statements.md 1.5 KB
- sections/04-preface/15-raising-semantic-precision.md 2.2 KB
- sections/04-preface/16-big-fpf-storylines.md 2.1 KB
- sections/04-preface/17-transdisciplinarity-as-a-meta-theory-of-thinking.md 1.4 KB
- sections/04-preface/18-the-culinary-architecture-of-collective-thought.md 2.2 KB
- sections/04-preface/19-the-intellect-stack-as-a-pedagogical-map.md 1.8 KB
- sections/04-preface/20-purpose-scope-and-non-goals.md 1.3 KB
- sections/04-preface/21-how-to-continue-after-the-readme.md 1.4 KB
- sections/05-part-a---kernel-architecture-cluster/_index.md 5.0 KB
- sections/05-part-a---kernel-architecture-cluster/01-a-0---onboarding-glossary.md 32 KB
- sections/05-part-a---kernel-architecture-cluster/02-a-1---holon-ontic-foundation.md 50 KB
- sections/05-part-a---kernel-architecture-cluster/03-a-1-1---bounded-model-use-structure-and-ddd-bounded-context.md 89 KB
- sections/05-part-a---kernel-architecture-cluster/04-a-1-scr---finding-the-acting-or-changed-system.md 43 KB
- sections/05-part-a---kernel-architecture-cluster/05-a-1-csd---discovering-systems-that-may-bear-consequences.md 36 KB
- sections/05-part-a---kernel-architecture-cluster/06-a-1-stm---using-the-system-thinking-long-mantra.md 29 KB
- sections/05-part-a---kernel-architecture-cluster/07-a-2---system-role-kinds-and-assignments.md 45 KB
- sections/05-part-a---kernel-architecture-cluster/08-a-2-1---u-systemroleassignment---contextual-system-role-assi.md 33 KB
- sections/05-part-a---kernel-architecture-cluster/09-a-2-2---u-capability---system-ability-envelope-and-measures.md 38 KB
- sections/05-part-a---kernel-architecture-cluster/10-a-2-3---u-promisecontent.md 78 KB
- sections/05-part-a---kernel-architecture-cluster/11-a-2-4---episteme-evidence-use-and-status-use-relations.md 35 KB
- sections/05-part-a---kernel-architecture-cluster/12-a-2-5---systemroleassignmentstaterelation---assignment-state.md 37 KB
- sections/05-part-a---kernel-architecture-cluster/13-a-2-6---unified-scope-mechanism-context-slices-scopes.md 109 KB
- sections/05-part-a---kernel-architecture-cluster/14-a-2-7---systemrolekindrelationstructure---relations-among-sy.md 45 KB
- sections/05-part-a---kernel-architecture-cluster/15-a-2-8---u-commitment.md 29 KB
- sections/05-part-a---kernel-architecture-cluster/16-a-2-8-per---granted-permission-exercise-and-non-prohibition.md 32 KB
- sections/05-part-a---kernel-architecture-cluster/17-a-2-9-u-speechact.md 63 KB
- sections/05-part-a---kernel-architecture-cluster/18-a-3---transformer-constitution.md 31 KB
- sections/05-part-a---kernel-architecture-cluster/19-a-3-1---u-method-reusable-way-of-doing-with-explicit-applica.md 66 KB
- sections/05-part-a---kernel-architecture-cluster/20-a-3-1-mr---candidate-method-recovery-from-work-evidence.md 27 KB
- sections/05-part-a---kernel-architecture-cluster/21-a-3-2---u-methoddescription-description-episteme-for-a-way-o.md 49 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 141 lines · 196 tokens per session scan A f8503783864a
fpf-problem-solving is a skill published in the GitHub repository CodeAlive-AI/ai-driven-development (131 stars, last pushed 4d ago), licensed MIT. It adds 196 tokens to every session and 4,342 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
map-plan
ARCHITECT phase - decompose complex tasks into atomic subtasks with research, spec, and branch-scoped plan artifacts under .map.
map-learn
Capture reusable lessons after a completed MAP workflow. Use when a MAP run has finished and you want rules written to .claude/rules/learned/ from a workflow summary or handoff. Do NOT use during active implementation.
map-efficient
State-machine MAP execution workflow for Codex. Use when implementing an approved MAP plan end to end, resuming from branch MAP taskplan or stepstate.json artifacts, or running non-trivial multi-subtask work. Use map-fast for tiny one-shot edits.
map-task
Execute a single subtask from an existing MAP plan via Actor and Monitor. Use when map-plan has decomposed work and you want fine-grained control over one subtask. Do NOT use without an existing plan; run map-plan first.
ppt-generation
Use this skill when the user requests to generate, create, or make presentations (PPT/PPTX). Has TWO workflows: (1) Primary — AI-generated full-slide images composed via scripts/generate.py; (2) Fallback — python-pptx programmatic slides (all text editable, better for reports/project management). The fallback…
map-prd-review
Use when reviewing a PRD, product brief, feature brief, or requirements document before planning or engineering handoff. Produces an evidence-backed 0-10 readiness score, strengths, weaknesses/risks, and uncovered edge cases across 13 dimensions. Do NOT use as a substitute for $map-plan, for code review, or for tiny…