# FPF Skill Stack
This repository implements an Agent Stack based on the **First Principles Framework (FPF)**. It is organized by **Bounded Contexts** to strictly separate semantic domains while maintaining a clear link between Design (Text) and Runtime (Code).
## 📄 Authoritative Specification
The "real origin content" and authoritative definition of the First Principles Framework (FPF) is located here:
👉 **[`governance/constitution/FPF_SPEC.md`](./governance/constitution/FPF_SPEC.md)**
All architectural decisions, role definitions, and interaction patterns in this repository are derived from this core specification.
## 📂 Repository Structure
The project follows the FPF **Holonic Architecture** (A.1) and **Bounded Contexts** (A.1.1):
* **`contexts/`**: Contains the core logic, partitioned by semantic boundaries.
* **`SkillRuntime/`**: The core runtime system (formerly `fpf-agent-stack`).
* **`Skills/`**: Skill definitions and implementations.
* **`SharedSchema/`**: Shared data contracts.
* **`governance/`**: Project-wide rules, the FPF Constitution, and Decision Records (DRR).
* **`constitution/`**: Contains the **FPF_SPEC.md**.
## 🛠 Usage
**Requirements:** [Bun](https://bun.com)
```bash
# Install dependencies
bun install
# Run the skills validator
bun run validate
```
