memex/notes/org-skill-project-manager.org

SKILL: Project Manager Agent (Universal Literate Note)

• Overview
• Phase A: Demand (PRD)
  • 1. Purpose
  • 2. User Needs
  • 3. Success Criteria
    • Project Path Resolution
    • Git Status Retrieval
    • Executive Summary Generation
• Phase B: Blueprint (PROTOCOL)
  • 1. Architectural Intent
  • 2. Semantic Interfaces
• Phase D: Build (Implementation)
  • Diagnostic Retrieval
• Registration

Overview

The Project Manager Agent provides executive presence by monitoring project health and tracking git status. It leverages `:PROJECT_PATH:` metadata to gather "folder facts" and assist in the project lifecycle.

Phase A: Demand (PRD)

1. Purpose

Define automated behaviors for project monitoring and version control tracking.

2. User Needs

• Visibility: Resolve physical project locations and gather git/file facts.
• Contextual Awareness: Trigger on status queries or project-node edits.
• Lifecycle Support: Suggest commit messages and identify uncommitted work.

3. Success Criteria

TODO Project Path Resolution

TODO Git Status Retrieval

TODO Executive Summary Generation

Phase B: Blueprint (PROTOCOL)

1. Architectural Intent

Interfaces for filesystem and VCS introspection. Source of truth is the project's physical directory and Git state.

2. Semantic Interfaces

(defun trigger-skill-project-manager (context)
  "Triggers on status queries or :PROJECT_PATH: presence.")

(defun get-project-diagnostics (raw-path)
  "Gathers file list and git status.")

(defun get-git-diff (raw-path)
  "Retrieves uncommitted changes.")

Phase D: Build (Implementation)

Diagnostic Retrieval

(defun get-project-diagnostics (raw-path)
  (let ((resolved-path (uiop:native-namestring raw-path)))
    (if (uiop:directory-exists-p resolved-path)
        (format nil "FILES: ~a~%GIT: ~a" 
                (uiop:run-program (list "ls" "-F" resolved-path) :output :string)
                (uiop:run-program (list "git" "-C" resolved-path "status" "--short") :output :string))
        "ERROR: Path not found.")))

Registration

(defskill :skill-project-manager
  :priority 70
  :trigger #'trigger-skill-project-manager
  :neuro #'neuro-skill-project-manager
  :symbolic (lambda (action context) action))