memex/projects/org-skill-project-foundry/PRD.org

PRD: Skill - Project Foundry Agent

• 1. Purpose
• 2. User Needs
  • 2.1 Workspace Scaffolding
  • 2.2 Version Control Initialization
  • 2.3 GTD Integration
  • 2.4 Idempotency and Safety
• 3. Success Criteria

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.