How wirasm/prps-agentic-eng works
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)