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

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

# Install dependencies
bun install

# Run the skills validator
bun run validate