#+TITLE: PRD: Skill - Project Foundry Agent
#+STATUS: FROZEN
#+AUTHOR: Agent
#+CREATED: [2026-03-31 Tue 14:15]

* 1. Purpose
Define the automated project instantiation behaviors for the PSF. The Project Foundry skill transforms a natural language project request (Demand) into a physically scaffolded, high-integrity project structure (Blueprint).

* 2. User Needs

** 2.1 Workspace Scaffolding
As a user (Amr), I need a consistent environment for every new project.
- The Foundry MUST create the standard PSF directory layout (`src/`, `tests/`, `docs/`).
- It MUST generate boilerplate literate files: `README.org`, `PRD.org`, and `PROTOCOL.org`.

** 2.2 Version Control Initialization
I need every project to be a Git repository from day one.
- The Foundry MUST run `git init` in the new project directory.

** 2.3 GTD Integration
I need new projects to be automatically tracked in my task management system.
- The Foundry MUST append the project and its initial tasks (`Draft PRD`, `Draft PROTOCOL`) to `gtd.org`.
- It MUST use `org-edna` or sibling-based triggers to maintain sequential integrity.

** 2.4 Idempotency and Safety
I need to prevent accidental data loss.
- The Foundry MUST NOT overwrite an existing project directory.
- It MUST log all physical actions to the kernel log.

* 3. Success Criteria
- [ ] **Structural Compliance:** Scaffolded project contains all required directories and files.
- [ ] **GTD Linkage:** New project appears in `gtd.org` with correct properties (`:PROJECT-PATH:`, `:PSF-STATE:`).
- [ ] **Literate Boilerplate:** Generated `PRD.org` and `PROTOCOL.org` contain the standard PSF templates.
- [ ] **Error Handling:** Foundry returns a clean error message if the project directory already exists.