# 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
```