# wirasm/prps-agentic-eng architecture

> Architecture diagram of the GitHub repository wirasm/prps-agentic-eng, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wirasm/prps-agentic-eng
- Repository: https://github.com/wirasm/prps-agentic-eng

## Overview

##### Project type and purpose
- This is an open-source tooling repository (“PRPs-agentic-eng”) that provides:
- A CLI runner script (Python) to execute “Product Requirement Prompts” (PRPs)
- A library of prompt templates (Markdown)
- Pre-configured slash commands for Claude Code (.claude/commands)
- AI documentation (“ai_docs”) to feed into prompts
- Its goal is to streamline AI-powered code generation by packaging everything an LLM needs—context, templates, run-book—into a repeatable system.

##### File structure
- Top-level directories:
- .claude/commands → Claude Code slash-command definitions
- PRPs/templates → PRP authoring templates (prp_base.md, prp_spec.md, etc.)
- PRPs/ai_docs → Context docs for libraries and workflows
- PRPs/scripts → prp_runner.py, the core CLI agent
- claude_md_files → Reference guides for various tech stacks
- Config files: pyproject.toml, .python-version, .gitignore
- README.md describes usage patterns, CI/CD integration, best practices.

##### README for additional insights
- Describes command set (create-base-prp, execute-base-prp, review-general, etc.)
- Shows how to embed into user projects (copy .claude, PRPs folder)
- Illustrates CI/CD integration (GitHub Actions YAML snippet)
- Emphasizes the PRP methodology: Context + Implementation Blueprint + Validation Loop.

##### Elements
- User → Claude Code → Command Definition → Runner → Template + Docs → Output
- CI/CD trigger → Runner headless → Test Suite → GitHub Status
- Blue for code artifacts (Python script, templates)
- Green for AI-related components (Claude Code, ai_docs)
- Orange for external systems (GitHub, CI)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User
    User["Developer"]:::external

    %% UI Layer
    subgraph "UI Layer"
        ClaudeCode["Claude Code IDE/Agent"]:::ai
        Commands[".claude/commands (Slash Command Definitions)"]:::code
    end

    %% Orchestration Layer
    subgraph "Orchestration Layer"
        Runner["PRP Runner CLI"]:::code
        Config["Configuration & Metadata"]:::docs
    end

    %% Content Layer
    subgraph "Content Layer"
        Templates["PRP Templates"]:::docs
        AiDocs["AI Documentation"]:::ai
        RefGuides["Reference Guides"]:::docs
    end

    %% Artifacts
    Outputs["Generated PRP Output (.md files)"]:::docs

    %% External Systems
    subgraph "External Systems"
        CICD["CI/CD Pipeline (GitHub Actions)"]:::external
        GitHub["Git & GitHub (Repo, Issues, PRs)"]:::external
    end

    %% Connections
    User -->|"types slash command"| ClaudeCode
    ClaudeCode -->|"reads command definitions"| Commands
    Commands -->|"invokes runner"| Runner
    Runner -->|"uses config"| Config
    Runner -->|"loads templates"| Templates
    Runner -->|"loads context docs"| AiDocs
    Runner -->|"loads reference guides"| RefGuides
    Runner -->|"generates PRP files"| Outputs
    Runner -->|"invokes tests (pytest, ruff, mypy)"| CICD
    CICD -->|"headless run invokes runner"| Runner
    Outputs -->|"committed to repo"| GitHub
    GitHub -->|"webhook triggers CI"| CICD
    CICD -->|"updates statuses/PRs"| GitHub

    %% Click Events
    click Runner "https://github.com/wirasm/prps-agentic-eng/blob/development/PRPs/scripts/prp_runner.py"
    click Templates "https://github.com/wirasm/prps-agentic-eng/tree/development/PRPs/templates/"
    click AiDocs "https://github.com/wirasm/prps-agentic-eng/tree/development/PRPs/ai_docs/"
    click Commands "https://github.com/wirasm/prps-agentic-eng/tree/development/.claude/commands/"
    click RefGuides "https://github.com/wirasm/prps-agentic-eng/tree/development/claude_md_files/"
    click Config "https://github.com/wirasm/prps-agentic-eng/blob/development/pyproject.toml"

    %% Styles
    classDef code fill:#cce5ff,stroke:#4da3ff;
    classDef ai fill:#d4edda,stroke:#28a745;
    classDef external fill:#fff3cd,stroke:#ffa502;
    classDef docs fill:#f0f0f0,stroke:#a0a0a0;
```
